.nh
.TH podman-push 1
.SH "نام (NAME)"
podman-push \- ارسال یک ایمیج، فهرست مانیفست یا نمایه ایمیج از حافظه محلی به مقصدی دیگر

.SH "خلاصه دستور (SYNOPSIS)"
\fBpodman push\fP [\fIگزینه‌ها\fP] \fIایمیج\fP [\fIمقصد\fP]

.PP
\fBpodman image push\fP [\fIگزینه‌ها\fP] \fIایمیج\fP [\fIمقصد\fP]

.SH "توضیحات (DESCRIPTION)"
یک ایمیج، فهرست مانیفست یا نمایه ایمیج (image index) را از حافظه ذخیره‌سازی محلی به یک مقصد مشخص ارسال (push) می‌کند.

.SH "حافظه ایمیج (Image storage)"
ایمیج‌ها از میان آن‌هایی که در حافظه ذخیره‌سازی محلی ایمیج قرار دارند ارسال می‌شوند.

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

.EX
# ارسال به یک رجیستری کانتینر
$ podman push quay.io/podman/stable

# ارسال به یک رجیستری کانتینر از طریق شیوه انتقال docker
$ podman push docker://quay.io/podman/stable

# ارسال به یک رجیستری کانتینر با تگی دیگر
$ podman push myimage quay.io/username/myimage

# ارسال به یک دایرکتوری محلی
$ podman push myimage dir:/tmp/myimage

# ارسال به یک فایل تاربال در قالب docker-archive
$ podman push myimage docker-archive:/tmp/myimage

# ارسال به دیمن محلی داکر
$ sudo podman push myimage docker-daemon:docker.io/library/myimage:33

# ارسال به یک فایل تاربال در قالب OCI
$ podman push myimage oci-archive:/tmp/myimage
.EE

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--authfile\fP=\fIمسیر\fP
مسیر فایل احراز هویت. مقدار پیش‌فرض در لینوکس \fB${XDG_RUNTIME_DIR}/containers/auth.json\fR و در ویندوز/macOS برابر با \fB$HOME/.config/containers/auth.json\fR است.
این فایل توسط \fBpodman login\fP ایجاد می‌شود. اگر وضعیت احراز هویت در آنجا یافت نشود، فایل \fB$HOME/.docker/config.json\fR بررسی می‌شود که با \fBdocker login\fP تنظیم می‌شود.

.PP
نکته: همچنین امکان بازنویسی مسیر پیش‌فرض فایل احراز هویت با تنظیم متغیر محیطی \fBREGISTRY_AUTH_FILE\fR وجود دارد. این کار را می‌توان با دستور \fBexport REGISTRY_AUTH_FILE=\fIمسیر\fP\fP انجام داد.

.SS \fB--cert-dir\fP=\fIمسیر\fP
استفاده از گواهی‌های موجود در \fIمسیر\fP (*\&.crt، *\&.cert، *\&.key) برای اتصال به رجیستری. (پیش‌فرض: /etc/containers/certs.d)
برای جزئیات بیشتر به \fBcontainers-certs.d(5)\fP مراجعه کنید.
(این گزینه در کلاینت راه دور پادمن، از جمله ماشین‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

.SS \fB--compress\fP
فشرده‌سازی لایه‌های ایمیج تاربال هنگام ارسال به یک دایرکتوری با استفاده از شیوه انتقال 'dir'. (پیش‌فرض همان نوع فشرده‌سازی مبدأ است؛ فشرده‌شده یا فشرده‌نشده).

.PP
نکته: این گزینه تنها در هنگام استفاده از شیوه انتقال \fBdir\fP قابل تنظیم است.

.SS \fB--compression-format\fP=\fBgzip\fP | \fIzstd\fP | \fIzstd:chunked\fP
قالب فشرده‌سازی مورد استفاده را مشخص می‌کند. مقادیر پشتیبانی‌شده عبارتند از: \fBgzip\fR، \fBzstd\fR و \fBzstd:chunked\fR\&. مقدار پیش‌فرض \fBgzip\fR است مگر اینکه در فایل containers.conf بازنویسی شود.
قالب \fBzstd:chunked\fR با رمزگذاری ایمیج‌ها ناسازگار است و در این حالت همراه با یک هشدار به عنوان \fBzstd\fR در نظر گرفته خواهد شد.

.SS \fB--compression-level\fP=\fIسطح\fP
سطح فشرده‌سازی مورد استفاده را مشخص می‌کند. این مقدار به الگوریتم فشرده‌سازی مورد استفاده بستگی دارد؛ به عنوان مثال برای zstd مقادیر پذیرفته‌شده در محدوده ۱ تا ۲۰ (شامل هر دو) با مقدار پیش‌فرض ۳ است، در حالی که برای gzip در محدوده ۱ تا ۹ (شامل هر دو) و با مقدار پیش‌فرض ۵ است.

.SS \fB--creds\fP=\fI[نام‌کاربری[:گذرواژه]]\fP
مقدار [نام‌کاربری[:گذرواژه]] برای احراز هویت در رجیستری در صورت نیاز.
اگر یک یا هر دو مقدار ارائه نشوند، اعلانی در خط فرمان ظاهر شده و می‌توان مقدار را وارد کرد. گذرواژه بدون بازتاب (echo) وارد می‌شود.

.PP
توجه داشته باشید که اعتبارنامه‌های مشخص‌شده فقط برای احراز هویت در رجیستری‌های هدف استفاده می‌شوند. آن‌ها برای آینه‌ها یا زمانی که رجیستری بازنویسی می‌شود استفاده نخواهند شد (به \fBcontainers-registries.conf(5)\fR مراجعه کنید)؛ برای احراز هویت در این موارد استفاده از فایل \fBcontainers-auth.json(5)\fR را مد نظر قرار دهید.

.SS \fB--digestfile\fP=\fIفایل‌دایجست\fP
پس از کپی کردن ایمیج، دایجست ایمیج حاصل را در فایل می‌نویسد.

.SS \fB--disable-content-trust\fP
این یک گزینه مخصوص داکر برای غیرفعال کردن اعتبارسنجی ایمیج در رجیستری کانتینر است و توسط پادمن پشتیبانی نمی‌شود. این گزینه بدون عملیات (NOOP) بوده و صرفاً جهت سازگاری اسکریپت‌ها ارائه شده است.

.SS \fB--encrypt-layer\fP=\fIلایه‌(ها)\fP
لایه‌(هایی) که باید رمزگذاری شوند: نمایه‌های لایه بر پایه صفر (0-indexed) با پشتیبانی از نمایه‌سازی منفی (مثلاً 0 لایه اول است و -1 لایه آخر). در صورت عدم تعریف، اگر گزینه \fB--encryption-key\fR مشخص شده باشد، تمامی لایه‌ها رمزگذاری می‌شوند.

.SS \fB--encryption-key\fP=\fIکلید\fP
فرمت [protocol:keyfile] پروتکل رمزگذاری را مشخص می‌کند که می‌تواند JWE (RFC7516)، PGP (RFC4880) و PKCS7 (RFC2315) باشد و همچنین مواد کلید مورد نیاز برای رمزگذاری ایمیج را تعیین می‌کند؛ به عنوان مثال jwe:/path/to/key.pem یا pgp:admin@example.com یا pkcs7:/path/to/x509-file.

.SS \fB--force-compression\fP
در صورت تنظیم، عملیات ارسال از الگوریتم فشرده‌سازی مشخص‌شده استفاده می‌کند حتی اگر مقصد در حال حاضر حاوی نسخه‌ای با فشرده‌سازی متفاوت باشد.
اگر \fB--compression-format\fR صریحاً در خط فرمان مشخص شده باشد، مقدار پیش‌فرض \fBtrue\fR است، در غیر این صورت \fBfalse\fR خواهد بود.

.SS \fB--format\fP, \fB-f\fP=\fIقالب\fP
نوع مانیفست (oci، v2s2 یا v2s1) که هنگام ارسال ایمیج استفاده می‌شود.

.SS \fB--quiet\fP, \fB-q\fP
نادیده گرفتن پیام‌های خروجی اطلاعاتی (که نشان می‌دهند چه دستوری در حال پردازش است و پیشرفت آن چقدر است). فقط پیام خطای نهایی یا اطلاعات تکمیل موفقیت‌آمیز مانند شناسه ایمیج یا کانتینر چاپ می‌شود.

.SS \fB--remove-signatures\fP
دور ریختن تمام امضاهای قبلی موجود در ایمیج.

.SS \fB--retry\fP=\fIتعداد-تلاش\fP
تعداد دفعات تلاش مجدد برای دریافت یا ارسال ایمیج‌ها بین رجیستری و حافظه محلی در صورت بروز شکست. پیش‌فرض \fB3\fP است.

.SS \fB--retry-delay\fP=\fIمدت-زمان\fP
مدت زمان تاخیر بین تلاش‌های مجدد در هنگام دریافت یا ارسال ایمیج‌ها بین رجیستری و حافظه محلی در صورت بروز خطا. حالت پیش‌فرض شروع با دو ثانیه و سپس افزایش نمایی است. در صورت تعیین این مقدار، تاخیر مشخص‌شده اعمال می‌شود و عقب‌نشینی نمایی رخ نمی‌دهد.

.SS \fB--sign-by\fP=\fIکلید\fP
افزودن امضای «امضای ساده» (simple signing) در مقصد با استفاده از کلید مشخص‌شده. (این گزینه در کلاینت راه دور پادمن، از جمله ماشین‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

.SS \fB--sign-by-sigstore\fP=\fIفایل-پارامتر\fP
افزودن امضای sigstore بر اساس گزینه‌های بیشتر مشخص‌شده در فایل پارامتر امضای sigstore کانتینر \fIفایل-پارامتر\fP\&.
برای جزئیات بیشتر در مورد قالب فایل به \fBcontainers-sigstore-signing-params.yaml(5)\fP مراجعه کنید.

.SS \fB--sign-by-sigstore-private-key\fP=\fIمسیر\fP
افزودن امضای sigstore در مقصد با استفاده از یک کلید خصوصی در مسیر مشخص‌شده. (این گزینه در کلاینت راه دور پادمن، از جمله ماشین‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

.SS \fB--sign-by-sq-fingerprint\fP=\fIاثرانگشت\fP
افزودن امضای «امضای ساده» با استفاده از کلید Sequoia-PGP با اثر انگشت مشخص‌شده.
(این گزینه در کلاینت راه دور پادمن، از جمله ماشین‌های مک و ویندوز (به استثنای WSL2) در دسترس نیست).

.SS \fB--sign-passphrase-file\fP=\fIمسیر\fP
در صورت امضای ایمیج (با استفاده از \fB--sign-by\fP، \fB--sign-by-sq-fingerprint\fP یا \fB--sign-by-sigstore-private-key\fP)، عبارت عبور مورد استفاده را از مسیر مشخص‌شده بخوانید.

.SS \fB--tls-verify\fP
الزام به استفاده از HTTPS و اعتبارسنجی گواهی‌ها هنگام ارتباط با رجیستری‌ها (پیش‌فرض: \fBtrue\fP).
اگر صریحاً روی \fBtrue\fP تنظیم شود، اعتبارسنجی TLS انجام می‌شود.
اگر روی \fBfalse\fP تنظیم شود، اعتبارسنجی TLS انجام نمی‌شود.
اگر مشخص نشود، اعتبارسنجی TLS انجام می‌شود مگر اینکه رجیستری هدف در \fBcontainers-registries.conf(5)\fP به عنوان یک رجیستری ناامن ذکر شده باشد.

.SH "مثال‌ها (EXAMPLES)"
ارسال ایمیج مشخص‌شده به یک دایرکتوری محلی:

.EX
# podman push imageID dir:/path/to/image
.EE

.PP
ارسال ایمیج مشخص‌شده به یک دایرکتوری محلی در قالب OCI:

.EX
# podman push imageID oci-archive:/path/to/layout:image:tag
.EE

.PP
ارسال ایمیج مشخص‌شده به یک رجیستری کانتینر:

.EX
# podman push imageID docker://registry.example.com/repository:tag
.EE

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

.EX
# podman push --digestfile=/tmp/mydigest imageID docker://registry.example.com/repository:tag
.EE

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

.EX
# podman push imageID docker-daemon:image:tag
.EE

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

.EX
# podman push --authfile temp-auths/myauths.json alpine docker://docker.io/umohnani/alpine
Getting image source signatures
Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
 4.03 MB / 4.03 MB [========================================================] 1s
Copying config sha256:ad4686094d8f0186ec8249fc4917b71faa2c1030d7b5a025c29f26e19d95c156
 1.41 KB / 1.41 KB [========================================================] 1s
Writing manifest to image destination
Storing signatures
.EE

.PP
ارسال ایمیج مشخص‌شده به یک دایرکتوری محلی به عنوان یک ایمیج OCI:

.EX
# podman push --format oci registry.access.redhat.com/rhel7 dir:rhel7-dir
Getting image source signatures
Copying blob sha256:9cadd93b16ff2a0c51ac967ea2abfadfac50cfa3af8b5bf983d89b8f8647f3e4
 71.41 MB / 71.41 MB [======================================================] 9s
Copying blob sha256:4aa565ad8b7a87248163ce7dba1dd3894821aac97e846b932ff6b8ef9a8a508a
 1.21 KB / 1.21 KB [========================================================] 0s
Copying config sha256:f1b09a81455c351eaa484b61aacd048ab613c08e4c5d1da80c4c46301b03cf3b
 3.01 KB / 3.01 KB [========================================================] 0s
Writing manifest to image destination
Storing signatures
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-pull(1)\fP, \fBpodman-login(1)\fP, \fBcontainers-certs.d(5)\fP, \fBcontainers-registries.conf(5)\fP, \fBcontainers-transports(5)\fP

.SS "عیب‌یابی (Troubleshooting)"
برای راه‌حل‌های مربوط به مشکلات رایج، \fBpodman-troubleshooting(7)\fP را ببینید.