نام (NAME)

apptainer-inspect - نمایش متادیتای یک تصویر

خلاصه دستور (SYNOPSIS)

apptainer inspect [inspect options...]

توضیحات (DESCRIPTION)

دستور inspect برچسب‌ها (labels)، متغیرهای محیطی، برنامه‌ها (apps) و اسکریپت‌های مرتبط با تصویر کانتینر را بر اساس گزینه‌های ورودی نمایش می‌دهد. به‌طور پیش‌فرض، این موارد در قالب متن ساده نمایش داده می‌شوند. اگر مایلید آن‌ها را در قالب JSON فهرست کنید، باید از گزینه --json استفاده نمایید.

گزینه‌ها (OPTIONS)

--all[=false] نمایش تمام داده‌های موجود (شامل گزینه --json)

--app="" بررسی یک برنامه (app) خاص

-d, --deffile[=false] نمایش پرونده تعریف (definition file) Apptainer که برای ایجاد تصویر استفاده شده است

-e, --environment[=false] نمایش تنظیمات محیطی برای تصویر کانتینر

-h, --help[=false] راهنما برای inspect

-H, --helpfile[=false] بررسی پرونده راهنمای runscript (در صورت وجود)

-j, --json[=false] چاپ JSON ساختاریافته به جای بخش‌ها

-l, --labels[=false] نمایش برچسب‌های تصویر کانتینر (پیش‌فرض)

--list-apps[=false] فهرست کردن تمام برنامه‌های موجود در یک کانتینر

-r, --runscript[=false] نمایش اسکریپت اجرای تصویر (runscript)

-s, --startscript[=false] نمایش اسکریپت راه‌اندازی تصویر (startscript)

-t, --test[=false] نمایش اسکریپت آزمایش تصویر (test script)

مثال (EXAMPLE)

$ apptainer inspect ubuntu.sif
اگر می‌خواهید برنامه‌های (apps) نصب‌شده در کانتینر (واقع در
/scif/apps) را فهرست کنید، باید دستور inspect را با گزینه --list-apps <container-image> اجرا کنید.
(برای اطلاعات بیشتر در مورد برنامه‌های SCIF به https://sci-f.github.io مراجعه کنید)
متغیرهای محیطی زیر هنگام فراخوانی از پوسته درون کانتینر در دسترس شما
هستند. متغیرهای بالایی مربوط به برنامه فعال (--app <app>) و متغیرهای پایینی
برای همه برنامه‌ها صرف‌نظر از برنامه فعال در دسترس هستند. هر دو مجموعه متغیر
در زمان توسعه (زمان ساخت) نیز در دسترس می‌باشند.
محیط برنامه فعال (ACTIVE APP ENVIRONMENT):
    SCIF_APPNAME       نام برنامه فعال
    SCIF_APPROOT       پوشه نصب برنامه ایجادشده در /scif/apps/<app>
    SCIF_APPMETA       پوشه متادیتای برنامه
    SCIF_APPDATA       پوشه داده ایجادشده برای برنامه در /scif/data/<app>
      SCIF_APPINPUT    پوشه ورودی مورد انتظار در پوشه داده
      SCIF_APPOUTPUT   پوشه خروجی داده در پوشه داده
    SCIF_APPENV        اشاره به پرونده سفارشی environment.sh در پوشه متادیتای آن
    SCIF_APPLABELS     پرونده labels.json برنامه در پوشه متادیتا
    SCIF_APPBIN        پوشه bin برنامه، که هنگام فعال بودن برنامه به صورت خودکار به $PATH اضافه می‌شود
    SCIF_APPLIB        پوشه کتابخانه برنامه که به LD_LIBRARY_PATH اضافه می‌شود
    SCIF_APPRUN        اسکریپت اجرای runscript
    SCIF_APPSTART      اسکریپت راه‌اندازی startscript
    SCIF_APPHELP       پرونده راهنما برای runscript
    SCIF_APPTEST       اسکریپت آزمایش (test.sh) مرتبط با برنامه
    SCIF_APPNAME       نام برنامه فعال
    SCIF_APPFILES      بخش پرونده‌های مرتبط با برنامه که اضافه شده‌اند
محیط برنامه سراسری (GLOBAL APP ENVIRONMENT):
    SCIF_DATA             پایگاه داده تعریف‌شده SCIF برای همه برنامه‌ها (/scif/data)
    SCIF_APPS             پایگاه‌های نصب تعریف‌شده SCIF برای همه برنامه‌ها (/scif/apps)
    SCIF_APPROOT_<app>    ریشه برنامه <app>
    SCIF_APPDATA_<app>    ریشه داده برنامه <app>
برای فهرست کردن تمام برنامه‌ها:
$ apptainer inspect --list-apps ubuntu.sif
برای فهرست کردن تنها برچسب‌ها با قالب JSON از یک تصویر:
$ apptainer inspect --json --labels ubuntu.sif
برای بررسی اینکه یک برنامه مشخص در تصویر کانتینر خود دارید، از گزینه --app <appname> استفاده کنید:
$ apptainer inspect --app <appname> ubuntu.sif

همچنین ببینید (SEE ALSO)

apptainer(1)

تاریخچه (HISTORY)

30-Jul-2026 تولید خودکار توسط spf13/cobra