.nh
.TH "apptainer" "1" "Jul 2026" "Auto generated by spf13/cobra" ""

.SH "نام (NAME)"
apptainer-pull \- دریافت و بارگیری تصویر از یک شناسه منبع (URI)


.SH "خلاصه دستور (SYNOPSIS)"
\fBapptainer pull [pull options...] [output file] \fP


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

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

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

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

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

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

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


.SH "گزینه‌ها (OPTIONS)"
\fB--arch\fP="amd64"
	معماری مورد نظر برای دریافت از کتابخانه

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

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

.PP
\fB--dir\fP=""
	دانلود تصاویر در دایرکتوری مشخص‌شده

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

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

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

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

.PP
\fB-h\fP, \fB--help\fP[=false]
	راهنما برای pull

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

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

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

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

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


.SH "مثال (EXAMPLE)"
.EX

  از یک کتابخانه
  $ 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
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBapptainer(1)\fP


.SH "تاریخچه (HISTORY)"
30-Jul-2026 تولید خودکار توسط spf13/cobra