نام (NAME)

singularity-pull - دریافت تصویر از یک شناسه منبع (URI)

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

apptainer pull [pull options...] [output file] <URI>

توضیحات (DESCRIPTION)

دستور 'pull' به شما امکان می‌دهد یک کانتینر را از یک شناسه منبع (URI) داده‌شده دانلود یا بیلد کنید. شناسه‌های منبع (URI) پشتیبانی‌شده عبارتند از:

library: دریافت یک تصویر از کتابخانه پیکربندی‌شده فعلی
library://user/collection/container[:tag]

docker: دریافت یک تصویر Docker/OCI از Docker Hub یا یک رجیستری OCI دیگر.
docker://user/image:tag

shub: دریافت یک تصویر از Singularity Hub
shub://user/image:tag

oras: دریافت یک تصویر SIF از یک رجیستری OCI که از ORAS پشتیبانی می‌کند.
oras://registry/namespace/image:tag

ipfs: دریافت یک تصویر SIF از یک کلاستر IPFS با استفاده از یک درگاه HTTP.
ipfs://cid

http, https: دریافت یک تصویر با استفاده از پروتکل http(s?)
https://example.com/alpine.sif

گزینه‌ها (OPTIONS)

--arch="amd64" معماری مورد نظر برای دریافت از کتابخانه

--arch-variant="" گونه معماری (variant) برای دریافت از کتابخانه

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

--dir="" دانلود تصاویر در دایرکتوری مشخص‌شده

--disable-cache[=false] عدم استفاده یا ایجاد تصاویر/blobهای کش‌شده

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

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

-F, --force[=false] بازنویسی فایل تصویر در صورت وجود داشتن

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

--library="" دانلود تصاویر از کتابخانه ارائه‌شده

--no-cleanup[=false] عدم پاک‌سازی بسته (bundle) پس از بیلد ناموفق، می‌تواند برای اشکال‌زدایی مفید باشد

--no-https[=false] استفاده از http به جای https برای URIهای docker:// ، oras:// و library:///...

--reproducible[=false] ایجاد یک بیلد تکرارپذیر (reproducible build) با استفاده از تاریخ ایجاد تصویر منبع

--sandbox[=false] دریافت تصویر در قالب ساختار sandbox (ساختار دایرکتوری chroot)

مثال (EXAMPLE)

از یک کتابخانه
$ apptainer pull alpine.sif library://alpine:latest
از Docker
$ apptainer pull tensorflow.sif docker://tensorflow/tensorflow:latest
$ apptainer pull --arch arm --arch-variant 6 alpine.sif docker://alpine:latest
از Shub
$ apptainer pull apptainer-images.sif shub://vsoch/apptainer-images
از رجیستری OCI پشتیبانی‌کننده (مانند Azure Container Registry)
$ apptainer pull image.sif oras://<username>.azurecr.io/namespace/image:tag
از کلاستر IPFS در دسترس (با استفاده از درگاه محلی HTTP IPFS)
$ apptainer pull lolcow.sif ipfs://bafybeice667c6gxovimsb6gnk6vex7vhzluhkl5hjv4ac4lhilxn52c43m

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

apptainer(1)

تاریخچه (HISTORY)

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