.nh
.TH buildah-pull "1" "July 2018" "buildah"
.SH "نام (NAME)"
.PP
buildah-pull \- دریافت (pull) یک تصویر از رجیستری.

.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBbuildah pull\fP [\fIoptions\fP] \fIimage\fP

.SH "توضیحات (DESCRIPTION)"
.PP
تصویری را بر اساس ورودی مشخص‌شده دریافت می‌کند. این دستور از تمامی پروتکل‌های انتقال موجود در \fBcontainers-transports(5)\fR پشتیبانی می‌کند (مثال‌های زیر را ببینید). اگر نوع انتقال مشخص نشود، ورودی تحت فرآیند تفکیک نام کوتاه قرار می‌گیرد (به \fBcontainers-registries.conf(5)\fR مراجعه کنید) و از روش انتقال \fBdocker\fR (یعنی رجیستری کانتینر) استفاده می‌شود.

.SS "وابستگی‌ها (DEPENDENCIES)"
.PP
ابزار Buildah مسیر رجیستری را با استفاده از پرونده /etc/containers/registries.conf حل‌وفصل می‌کند؛ به containers-registries.conf(5) مراجعه کنید. اگر دستور \fBbuildah pull\fR با خطای "image not known" مواجه شد، ابتدا بررسی کنید که پرونده registries.conf نصب شده و به درستی پیکربندی شده باشد.

.SH "مقدار بازگشتی (RETURN VALUE)"
.PP
شناسه تصویر (image ID) تصویر دریافت شده برگردانده می‌شود. در صورت بروز خطا مقدار 1 برگردانده خواهد شد.

.SH "گزینه‌ها (OPTIONS)"
.PP
\fB--all-tags\fP, \fB-a\fP

.PP
تمامی تصاویر دارای برچسب در مخزن دریافت خواهند شد.

.PP
\fB--arch\fP="ARCH"

.PP
تنظیم معماری (ARCH) تصویری که قرار است دریافت شود به مقدار داده‌شده به جای استفاده از معماری میزبان. (نمونه‌ها: arm, arm64, 386, amd64, ppc64le, s390x)

.PP
\fB--authfile\fP \fIpath\fP

.PP
مسیر پرونده احراز هویت. پیش‌فرض ${XDG_RUNTIME_DIR}/containers/auth.json است. برای اطلاعات بیشتر containers-auth.json(5) را ببینید. این پرونده با استفاده از \fBbuildah login\fR ایجاد می‌شود.

.PP
اگر وضعیت احراز هویت در آنجا یافت نشود، پرونده $HOME/.docker/config.json که با \fBdocker login\fR تنظیم شده بررسی می‌گردد.

.PP
توجه: می‌توانید با تنظیم متغیر محیطی REGISTRY_AUTH_FILE مسیر پیش‌فرض را تغییر دهید: \fBexport REGISTRY_AUTH_FILE=path\fR

.PP
\fB--cert-dir\fP \fIpath\fP

.PP
استفاده از گواهی‌های موجود در \fIpath\fP (*\&.crt, *\&.cert, *\&.key) برای اتصال به رجیستری. دایرکتوری پیش‌فرض گواهی‌ها \fI/etc/containers/certs.d\fP است.

.PP
\fB--creds\fP \fIcreds\fP

.PP
نام کاربری و گذرواژه [username[:password]] برای احراز هویت در رجیستری (در صورت نیاز). اگر یک یا هر دو مقدار ارائه نشوند، اعلان خط فرمان ظاهر خواهد شد و می‌توان مقدار را وارد نمود. رمز عبور بدون بازتاب تایپ می‌شود.

.PP
\fB--decryption-key\fP \fIkey[:passphrase]\fP

.PP
کلید [key[:passphrase]] مورد استفاده برای رمزگشایی تصاویر. کلید می‌تواند به کلیدها و/یا گواهی‌ها اشاره کند. رمزگشایی با تمام کلیدها امتحان خواهد شد. اگر کلید با عبارت عبور محافظت شده باشد، ارسال آن به عنوان آرگومان الزامی است.

.PP
\fB--os\fP="OS"

.PP
تنظیم سیستم‌عامل (OS) تصویر دریافتی به جای استفاده از سیستم‌عامل فعلی میزبان.

.PP
\fB--platform\fP="OS/ARCH[/VARIANT]"

.PP
تنظیم هم‌زمان OS/ARCH تصویر دریافتی به مقدار ارائه‌شده به جای استفاده از سیستم‌عامل و معماری فعلی میزبان (برای نمونه \fBlinux/arm\fR).

.PP
جفت‌های OS/ARCH مواردی هستند که در زبان برنامه‌نویسی Go استفاده می‌شوند. در چندین مورد مقدار ARCH برای یک پلتفرم با ابزارهایی مانند دستور \fBarch\fR تفاوت دارد. ترکیب‌های معتبر نام سیستم‌عامل و معماری به عنوان مقادیر $GOOS و $GOARCH در https://golang.org/doc/install/source#environment فهرست شده‌اند و همچنین می‌توان با اجرای \fBgo tool dist list\fR آن‌ها را یافت.

.PP
\fBنکته:\fP گزینه \fB--platform\fR نباید همراه با گزینه‌های \fB--arch\fR، \fB--os\fR یا \fB--variant\fR استفاده شود.

.PP
\fB--policy\fP=\fBalways\fP|\fBmissing\fP|\fBnever\fP|\fBnewer\fP

.PP
سیاست دریافت تصویر. پیش‌فرض \fBmissing\fP است.

.RS
.IP \(bu 2
\fBalways\fP: همواره تصویر را دریافت کن و در صورت شکست خطا صادر کن.
.IP \(bu 2
\fBmissing\fP: تصویر را تنها زمانی دریافت کن که در فضای ذخیره‌سازی محلی کانتینرها موجود نباشد. اگر تصویری یافت نشود و دریافت با شکست مواجه شود، خطا صادر کن.
.IP \(bu 2
\fBnever\fP: هرگز تصویر را دریافت نکن بلکه از نسخه موجود در فضای ذخیره‌سازی محلی کانتینرها استفاده کن. در صورت عدم وجود تصویر خطا صادر کن.
.IP \(bu 2
\fBnewer\fP: اگر تصویر موجود در رجیستری جدیدتر از نسخه موجود در ذخیره‌سازی محلی کانتینرها باشد، آن را دریافت کن. یک تصویر زمانی جدیدتر در نظر گرفته می‌شود که شناسه‌های هش (digests) متفاوت باشند. مقایسه برچسب‌های زمانی مستعد خطاست. در صورتی که تصویر محلی پیدا شود، خطاهای دریافت نادیده گرفته می‌شوند.

.RE

.PP
\fB--quiet\fP, \fB-q\fP

.PP
در صورتی که نیاز به دریافت تصویر از رجیستری باشد، خروجی پیشرفت را نمایش نده.

.PP
\fB--remove-signatures\fP

.PP
هنگام دریافت تصاویر، امضاها را کپی نکن.

.PP
\fB--retry\fP \fIattempts\fP

.PP
تعداد تلاش‌های مجدد در صورت بروز شکست هنگام دریافت تصاویر از رجیستری.

.PP
پیش‌فرض \fB3\fR است.

.PP
\fB--retry-delay\fP \fIduration\fP

.PP
مدت زمان تاخیر بین تلاش‌های مجدد در صورت شکست هنگام دریافت تصاویر از رجیستری.

.PP
پیش‌فرض \fB2s\fR است.

.PP
\fB--tls-verify\fP \fIbool-value\fP

.PP
الزام استفاده از HTTPS و اعتبارسنجی گواهی‌ها هنگام ارتباط با رجیستری‌های کانتینر (پیش‌فرض true است). اعتبارسنجی TLS هنگام ارتباط با یک رجیستری ناامن (insecure) قابل استفاده نیست.

.PP
\fB--variant\fP=""

.PP
تنظیم گونه معماری (architecture variant) تصویر دریافتی.

.SH "مثال‌ها (EXAMPLE)"
.PP
buildah pull imagename

.PP
buildah pull docker://myregistry.example.com/imagename

.PP
buildah pull docker-daemon:imagename:imagetag

.PP
buildah pull docker-archive:filename

.PP
buildah pull oci-archive:filename

.PP
buildah pull dir:directoryname

.PP
buildah pull --tls-verify=false myregistry/myrepository/imagename:imagetag

.PP
buildah pull --creds=myusername:mypassword --cert-dir ~/auth myregistry/myrepository/imagename:imagetag

.PP
buildah pull --authfile=/tmp/auths/myauths.json myregistry/myrepository/imagename:imagetag

.PP
buildah pull --arch=aarch64 myregistry/myrepository/imagename:imagetag

.PP
buildah pull --arch=arm --variant=v7 myregistry/myrepository/imagename:imagetag

.SH "محیط (ENVIRONMENT)"
.PP
\fBBUILD_REGISTRY_SOURCES\fP

.PP
متغیر BUILD_REGISTRY_SOURCES در صورت تنظیم، به عنوان یک شیء JSON در نظر گرفته می‌شود که شامل فهرست‌هایی از نام‌های رجیستری تحت کلیدهای \fBinsecureRegistries\fR، \fBblockedRegistries\fR و \fBallowedRegistries\fR است.

.PP
هنگام دریافت تصویر از یک رجیستری، اگر نام رجیستری با هر یک از موارد موجود در فهرست \fBblockedRegistries\fR مطابقت داشته باشد، درخواست دریافت تصویر رد می‌شود. اگر رجیستری‌هایی در فهرست \fBallowedRegistries\fR وجود داشته باشند و نام رجیستری در آن فهرست نباشد، درخواست دریافت رد می‌شود.

.PP
\fBTMPDIR\fP
متغیر محیطی TMPDIR به کاربر اجازه می‌دهد مشخص کند که پرونده‌های موقت هنگام دریافت و ارسال تصاویر در کجا ذخیره شوند. پیش‌فرض '/var/tmp' است.

.SH "پرونده‌ها (FILES)"
.PP
\fBregistries.conf\fP (\fB/etc/containers/registries.conf\fR)

.PP
پرونده registries.conf پرونده پیکربندی است که مشخص می‌کند هنگام کامل کردن نام تصاویری که فاقد بخش رجیستری یا دامنه هستند، به کدام رجیستری‌های کانتینر مراجعه شود.

.PP
\fBpolicy.json\fP (\fB/etc/containers/policy.json\fR)

.PP
پرونده سیاست امضا. این پرونده سیاست اعتماد را برای تصاویر کانتینر تعریف می‌کند و کنترل می‌نماید که کدام رجیستری‌ها می‌توانند برای تصویر استفاده شوند و آیا ابزار باید به تصاویر اعتماد کند یا خیر.

.SH "همچنین ببینید (SEE ALSO)"
.PP
buildah(1), buildah-from(1), buildah-login(1), docker-login(1), containers-policy.json(5), containers-registries.conf(5), containers-transports(5), containers-auth.json(5)