نام (NAME)

singularity-instance-start - شروع یک نمونه نام‌گذاری‌شده از تصویر ظرف داده‌شده

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

singularity instance start [start options...] <image path> <instance name> [startscript args...]

توضیحات (DESCRIPTION)

دستور instance start به شما امکان می‌دهد یک نمونه نام‌گذاری‌شده جدید از یک تصویر ظرف موجود ایجاد کنید که در پس‌زمینه شروع به اجرا می‌کند. اگر یک اسکریپت شروع (startscript) در فراداده ظرف تعریف شده باشد، دستورات آن اسکریپت نیز همراه با دستور instance start اجرا خواهند شد. شما می‌توانید به صورت اختیاری آرگومان‌هایی را به startscript ارسال کنید.

دستور singularity instance start قالب‌های ظرف زیر را می‌پذیرد:

*.sif قالب تصویر سینگولاریتی (SIF). بومی Singularity (نسخه ۳.۰ به بالا) و Apptainer (نسخه ۱.۰.۰ به بالا)

*.sqsh قالب SquashFS. بومی Singularity نسخه ۲.۴ به بالا

*.img قالب ext3. بومی نسخه‌های Singularity کمتر از ۲.۴.

directory/ قالب سندباکس (sandbox). دایرکتوری حاوی یک سیستم‌فایل ریشه معتبر و اختیاری فراداده‌های Apptainer.

instance://* یک نمونه در حال اجرای محلی از یک ظرف. (گروه دستورات instance را ببینید.)

library://* یک ظرف SIF میزبانی‌شده در Library (بدون پیش‌فرض)

docker://* یک ظرف Docker/OCI میزبانی‌شده در Docker Hub یا دیگر ثبتی‌های OCI.

shub://* یک ظرف میزبانی‌شده در Singularity Hub.

oras://* یک ظرف SIF میزبانی‌شده در ثبتی OCI که از مشخصات OCI Registry As Storage (ORAS) پشتیبانی می‌کند.

ipfs://* یک تصویر SIF از یک خوشه IPFS، با استفاده از درگاه HTTP.

گزینه‌ها (OPTIONS)

--add-caps="": فهرست قابلیت‌های جداشده با کاما برای افزودن
--allow-setuid[=false]: مجاز کردن فایل‌های باینری setuid درون ظرف (فقط ریشه)
--app="": تنظیم یک برنامه کاربردی برای اجرا درون ظرف
--apply-cgroups="": اعمال cgroups از فایل برای فرآیندهای ظرف (فقط ریشه)
--authfile="": فایل احراز هویت به سبک Docker برای استفاده در نوشتن/خواندن اعتبارنامه‌های ثبتی OCI
-B, --bind=[]: مشخصات مسیر bind کاربر. به قالب src[:dest[:opts]] است که src و dest مسیرهای خارج و داخل هستند. اگر dest داده نشود، برابر با src در نظر گرفته می‌شود. گزینه‌های اتصال ('opts') می‌توانند به صورت 'ro' (فقط خواندنی) یا 'rw' (خواندنی/نوشتنی، که پیش‌فرض است) تعیین شوند. چندین مسیر bind را می‌توان با کاما جدا کرد.
--blkio-weight=0: وزن نسبی Block IO در بازه 10-1000، برای غیرفعال کردن 0
--blkio-weight-device=[]: وزن نسبی Block IO مخصوص دستگاه
--boot[=false]: اجرای /sbin/init برای بوت کردن ظرف (فقط ریشه)
-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 برای ظرف
--cpus="": تعداد CPUهای در دسترس ظرف
--cpuset-cpus="": فهرست CPUهای میزبان در دسترس ظرف
--cpuset-mems="": فهرست گره‌های حافظه میزبان در دسترس ظرف
--disable-cache[=false]: عدم استفاده یا ایجاد حافظه موقت (cache)
--dmtcp-launch="": نقطه بازرسی برای dmtcp جهت ذخیره وضعیت فرآیند ظرف (آزمایشی)
--dmtcp-restart="": نقطه بازرسی برای dmtcp جهت راه‌اندازی مجدد فرآیند ظرف (آزمایشی)
--dns="": فهرستی از سرورهای DNS جداشده با کاما برای افزودن در resolv.conf
--docker-host="": مشخص کردن میزبان دیمن سفارشی Docker
--docker-login[=false]: ورود تعاملی به یک مخزن Docker
--drop-caps="": فهرست قابلیت‌های جداشده با کاما برای حذف
--env=[]: ارسال متغیر محیطی به فرآیند درون ظرف
--env-file=[]: ارسال متغیرهای محیطی از یک فایل به فرآیند درون ظرف
-f, --fakeroot[=false]: اجرای ظرف در قالب ظاهری ریشه (fakeroot)
--fusemount=[]: مشخصات اتصال سیستم‌فایل FUSE به شکل '<type>:<path> <mountpoint>' که در آن <type> برابر با 'container' یا 'host' است و محل اتصال را تعیین می‌کند ('container-daemon' یا 'host-daemon' فرآیند FUSE را جداگانه اجرا می‌کند). <path> مسیر فایل اجرایی FUSE به همراه گزینه‌های اتصال است. <mountpoint> محل درون ظرف است که اتصال FUSE به آن متصل می‌شود؛ مانند 'container:sshfs 10.0.0.1:/ /sshfs'. مستلزم --pid است.
-h, --help[=false]: راهنما برای start
-H, --home="/build": مشخصات دایرکتوری خانگی (home). می‌تواند یک مسیر src یا یک جفت src:dest باشد. src مسیر دایرکتوری خانگی خارج از ظرف است و dest جایگزین دایرکتوری خانگی درون ظرف می‌شود.
--hostname="": تنظیم نام میزبان (hostname) ظرف
--intel-hpu[=false]: فعال کردن پشتیبانی از شتاب‌دهنده Intel(R) Gaudi هم‌زمان با استفاده از /dev کمینه
-i, --ipc[=false]: اجرای ظرف در یک فضای نام جدید IPC
--keep-privs[=false]: اجازه حفظ امتیازات به کاربر ریشه در ظرف (فقط ریشه)
--memory="": محدودیت حافظه به بایت
--memory-reservation="": حد نرم حافظه به بایت
--memory-swap="": محدودیت حافظه تبدیل (swap)، استفاده از -1 برای نامحدود
--mount=[]: مشخصات اتصال مانند 'type=bind,source=/opt,destination=/hostopt'. پرچم 'nonested' از ارسال نقطه اتصال به ظروف تو در تو از طریق APPTAINER_BIND جلوگیری می‌کند.
-n, --net[=false]: اجرای ظرف در یک فضای نام شبکه جدید (به طور پیش‌فرض یک رابط شبکه پل bridge راه‌اندازی می‌کند)
--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، یا 'bind-paths' برای غیرفعال کردن همه مسیرهای bind.
--no-privs[=false]: حذف تمام امتیازات از کاربر ریشه در ظرف
--no-umask[=false]: عدم انتقال umask به ظرف، تنظیم umask پیش‌فرض 0022
--nv[=false]: فعال‌سازی پشتیبانی از Nvidia
--nvccli[=false]: استفاده از nvidia-container-cli برای راه‌اندازی GPU (آزمایشی)
--oom-kill-disable[=false]: غیرفعال کردن کشنده کمبود حافظه (OOM killer)
-o, --overlay=[]: استفاده از تصویر overlayFS برای ذخیره‌سازی داده‌های ماندگار یا به عنوان لایه فقط خواندنی ظرف
--passphrase[=false]: درخواست عبارت عبور رمزگذاری
--pem-path="": وارد کردن مسیر به کلید RSA با قالب PEM برای ظرف رمزگذاری‌شده
--pid-file="": نوشتن شناسه فرآیند (PID) نمونه در فایل با نام داده‌شده
--pids-limit=0: محدود کردن تعداد PIDهای ظرف، استفاده از -1 برای نامحدود
--rocm[=false]: فعال کردن پشتیبانی آزمایشی Rocm
-S, --scratch=[]: گنجاندن یک دایرکتوری موقت (scratch) در ظرف که به یک دایرکتوری موقت پیوند دارد (از -W برای تعیین مکان استفاده کنید)
--security=[]: فعال کردن قابلیت‌های امنیتی (SELinux, Apparmor, Seccomp)
--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)

مثال‌ها (EXAMPLE)

$ apptainer instance start /tmp/my-sql.sif mysql
$ apptainer shell instance://mysql
Apptainer my-sql.sif> pwd
/home/mibauer/mysql
Apptainer my-sql.sif> ps
PID TTY          TIME CMD
  1 pts/0    00:00:00 appinit
  2 pts/0    00:00:00 bash
  3 pts/0    00:00:00 ps
Apptainer my-sql.sif>
$ apptainer instance stop /tmp/my-sql.sif mysql
Stopping /tmp/my-sql.sif mysql

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

apptainer-instance(1)

تاریخچه (HISTORY)

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