apptainer(1) apptainer(1)

apptainer-test - اجرای آزمون‌های تعریف‌شده توسط کاربر درون یک ظرف (کانتینر)

apptainer test [گزینه‌های اجرا...]

دستور 'test' به شما امکان می‌دهد یک اسکریپت آزمون (در صورت وجود) را درون یک
ظرف داده‌شده اجرا کنید.

نکته:
برای نمونه‌ها (instances)، اگر یک فرآیند دیمِن (پس‌زمینه) درون ظرف در حال اجرا باشد،
دستورات بعدی ظرف همگی درون همان فضاهای نام (namespaces) اجرا خواهند شد. این بدان
معناست که گزینه‌های writable-- و contain-- اعمال نخواهند شد زیرا فضاهای نام
پیش‌تر توسط دستور 'apptainer start' پیکربندی شده‌اند.

--add-caps="" فهرستی از قابلیت‌ها (capabilities) جداشده با کاما جهت اضافه کردن

--allow-setuid[=false] اجازه اجرای برنامه‌های با بیت setuid درون ظرف (فقط ریشه/root)

--app="" تنظیم یک برنامه کاربردی برای اجرا درون ظرف

--apply-cgroups="" اعمال cgroups از پرونده برای فرآیندهای ظرف (فقط ریشه/root)

--authfile="" پرونده احراز هویت به سبک داکر جهت استفاده برای نوشتن/خواندن اعتبارنامه‌های سامانه ثبت OCI

-B, --bind=[] مشخصات مسیر پیوند کاربر. این مشخصه قالب src[:dest[:opts]] دارد که در آن src و dest مسیرهای خارج و داخل هستند. در صورت عدم تعیین dest، برابر با src قرار می‌گیرد. گزینه‌های اتصال ('opts') می‌توانند به صورت 'ro' (فقط‌خواندنی) یا 'rw' (خواندنی/نوشتنی، که پیش‌فرض است) مشخص شوند. چند مسیر پیوند را می‌توان با فهرست جداشده با کاما تعیین کرد.

--blkio-weight=0 وزن نسبی Block IO در محدوده ۱۰ تا ۱۰۰۰، ۰ برای غیرفعال‌سازی

--blkio-weight-device=[] وزن نسبی Block IO مختص دستگاه

--cdi-dirs=[] فهرست جداشده با کاما از پوشه‌هایی که CDI باید در آن‌ها به دنبال پرونده‌های JSON تعریف دستگاه بگردد. در صورت حذف، پیش‌فرض خواهد بود: etc/cdi,/var/run/cdi/

-e, --cleanenv[=false] پاکسازی متغیرهای محیطی پیش از اجرای ظرف

--compat[=false] اعمال تنظیمات برای افزایش سازگاری با OCI/Docker. گزینه‌های containall، --no-init، --no-umask، --no-eval، --writable-tmpfs-- را در بر می‌گیرد.

-c, --contain[=false] استفاده از dev/ مینیمال و پوشه‌های خالی دیگر (مانند tmp/ و HOME$) به جای اشتراک‌گذاری سامانه‌های پرونده از میزبان شما

-C, --containall[=false] مهار نه تنها سامانه‌های پرونده، بلکه PID، IPC و محیط

--cpu-shares=-1 سهم‌های پردازنده (CPU shares) برای ظرف

--cpus="" تعداد پردازنده‌های در دسترس برای ظرف

--cpuset-cpus="" فهرست پردازنده‌های میزبان در دسترس برای ظرف

--cpuset-mems="" فهرست گره‌های حافظه میزبان در دسترس برای ظرف

--cwd="" پوشه کاری اولیه برای فرآیند بار کاری درون ظرف (هم‌معنی با pwd--)

--device=[] نام(های) کامل دستگاه CDI. یک نام کامل دستگاه CDI شامل VENDOR، CLASS و NAME است که به صورت /= ترکیب می‌شوند (مانند vendor.com/device=mydevice). چندین نام کامل دستگاه CDI را می‌توان با فهرستی جداشده با کاما ارائه کرد.

--disable-cache[=false] عدم استفاده یا ایجاد حافظه نهان (کَش)

--dns="" فهرستی از کارسازهای DNS جداشده با کاما برای اضافه شدن به resolv.conf

--docker-host="" مشخص کردن میزبان سفارشی دیمن داکر

--docker-login[=false] ورود به یک مخزن داکر به صورت تعاملی

--drop-caps="" فهرستی از قابلیت‌ها (capabilities) جداشده با کاما جهت حذف

--env=[] ارسال متغیر محیطی به فرآیند مهارشده

--env-file=[] ارسال متغیرهای محیطی از پرونده به فرآیند مهارشده

-f, --fakeroot[=false] اجرای ظرف با ظاهر اجرای کاربر ریشه (root)

--fusemount=[] مشخصات اتصال سامانه پرونده FUSE به شکل 'container:sshfs 10.0.0.1:/ /sshfs' یا موارد مشابه. گزینه pid-- را در بر دارد.

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

-H, --home="/build" مشخصات پوشه خانگی. می‌تواند یک مسیر مبدا یا جفت src:dest باشد. مبدا مسیر پوشه خانگی خارج از ظرف است و dest پوشه خانگی درون ظرف را بازنویسی می‌کند.

--hostname="" تنظیم نام میزبان ظرف

--intel-hpu[=false] فعال‌سازی پشتیبانی از شتاب‌دهنده Intel(R) Gaudi هم‌زمان با استفاده از dev/ مینیمال

-i, --ipc[=false] اجرای ظرف در یک فضای نام جدید IPC

--keep-privs[=false] حفظ اختیارات کاربر ریشه در ظرف (فقط ریشه/root)

--memory="" محدودیت حافظه بر حسب بایت

--memory-reservation="" محدودیت نرم (soft limit) حافظه بر حسب بایت

--memory-swap="" محدودیت حافظه تبدیل (Swap)، از ۱- برای حافظه تبدیل نامحدود استفاده کنید

--mount=[] مشخصات اتصال مانند 'type=bind,source=/opt,destination=/hostopt'. پرچم 'nonested' از ارسال این اتصال به ظرف‌های تودرتو از طریق APPTAINER_BIND جلوگیری می‌کند.

-n, --net[=false] اجرای ظرف در یک فضای نام شبکه جدید (به طور پیش‌فرض یک واسط شبکه پلی راه‌اندازی می‌کند)

--netns-path="" پیوستن به فضای نام شبکه در مسیر مشخص‌شده (به عنوان ریشه یا در صورت مجاز بودن در apptainer.conf)

--network="" مشخص کردن نوع شبکه مورد نظر جداشده با کاما، هر شبکه یک واسط اختصاصی درون ظرف ایجاد می‌کند

--network-args=[] مشخص کردن آرگومان‌های شبکه برای ارسال به افزونه‌های CNI

--no-env=[] فهرستی از متغیرهای محیطی برای مسدود کردن واردات آن‌ها از محیط میزبان به ظرف

--no-eval[=false] عدم ارزیابی پوسته روی متغیرهای محیطی یا CMD/ENTRYPOINT/ARGS ظرف‌های OCI

--no-home[=false] عدم اتصال پوشه خانگی کاربران در صورتی که home/ پوشه کاری جاری نباشد

--no-https[=false] استفاده از http به جای https برای شناسه‌های یکتای منابع ://docker:// ،oras و :///...library

--no-init[=false] عدم راه‌اندازی فرآیند shim همراه با pid--

--no-mount=[] غیرفعال‌سازی یک یا چند گزینه 'mount xxx' تنظیم‌شده در apptainer.conf و/یا مشخص کردن مسیر مقصد مطلق برای غیرفعال کردن یک ورودی مسیر پیوند، یا 'bind-paths' برای غیرفعال کردن تمام ورودی‌های مسیر پیوند.

--no-pid[=false] عدم اجرای ظرف در یک فضای نام جدید PID

--no-privs[=false] سلب تمام اختیارات از کاربر ریشه در ظرف

--no-umask[=false] عدم انتقال umask میزبان به ظرف، تنظیم پیش‌فرض 0022 برای umask

--nv[=false] فعال‌سازی پشتیبانی از Nvidia

--nvccli[=false] استفاده از nvidia-container-cli برای راه‌اندازی کارت گرافیک (آزمایشی)

--oom-kill-disable[=false] غیرفعال‌سازی قاتل حافظه ناکافی (OOM killer)

-o, --overlay=[] استفاده از یک تصویر overlayFS برای ذخیره‌سازی داده‌های پایدار یا به عنوان لایه فقط‌خواندنی ظرف

--passphrase[=false] درخواست ورود عبارت عبور رمزگذاری

--pem-path="" وارد کردن یک مسیر به کلید RSA با قالب PEM برای یک ظرف رمزگذاری‌شده

-p, --pid[=false] اجرای ظرف در یک فضای نام جدید PID

--pids-limit=0 محدود کردن تعداد شناسه‌های فرآیند (PID) ظرف، از ۱- برای نامحدود استفاده کنید

--rocm[=false] فعال‌سازی پشتیبانی آزمایشی از Rocm

-S, --scratch=[] گنجاندن یک پوشه چرکنویس (scratch) درون ظرف که به یک پوشه موقت پیوند داده شده است (برای تحمیل مکان از W- استفاده کنید)

--security=[] فعال‌سازی ویژگی‌های امنیتی (SELinux، Apparmor، Seccomp)

--sharens[=false] اشتراک‌گذاری فضای نام و تصویر با ظرف‌های دیگری که از همان فرآیند والد راه‌اندازی شده‌اند

--unsquash[=false] تبدیل پرونده SIF به یک سندباکس موقت پیش از اجرا

-u, --userns[=false] اجرای ظرف در یک فضای نام کاربری جدید

--uts[=false] اجرای ظرف در یک فضای نام جدید UTS

-W, --workdir="" پوشه کاری مورد استفاده برای tmp/، /var/tmp و HOME$ (در صورتی که c/--contain- نیز استفاده شده باشد)

-w, --writable[=false] به طور پیش‌فرض تمامی ظرف‌های Apptainer به صورت فقط‌خواندنی در دسترس هستند. این گزینه سامانه پرونده را به صورت خواندنی/نوشتنی در دسترس قرار می‌دهد.

--writable-tmpfs[=false] سامانه پرونده را به صورت خواندنی/نوشتنی با داده‌های ناپایدار در دسترس قرار می‌دهد (تنها با پشتیبانی از overlay)

بخش '%test' را با یک پرونده تعریف مانند زیر تنظیم کنید:
%test
    echo "hello from test" "$@"
$ apptainer test /tmp/debian.sif command
    hello from test command
برای راهنمایی بیشتر، لطفاً از صفحات مستندات عمومی ما به نشانی زیر دیدن فرمایید:
    https://apptainer.org/docs/

apptainer(1)

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

Jul 2026 Auto generated by spf13/cobra