.nh
.TH "DOCKER" "1" "Aug 2026" "Docker Community" "Docker User Manuals"

.SH "نام (NAME)"
docker-image-push \- بارگذاری یک ایمیج در یک رجیستری


.SH "خلاصه دستور (SYNOPSIS)"
\fBdocker image push [OPTIONS] NAME[:TAG]\fP


.SH "شرح (DESCRIPTION)"
از \fBdocker image push\fR برای به اشتراک‌گذاری ایمیج‌های خود در رجیستری Docker Hub
\[la]https://hub.docker.com\[ra]
یا یک رجیستری میزبانی‌شده توسط خودتان استفاده کنید.

.PP
برای اطلاعات بیشتر درباره نام‌های معتبر ایمیج و تگ، به \fBdocker-image-tag(1)\fP مراجعه کنید.

.PP
متوقف کردن فرایند \fBdocker image push\fP، برای مثال با فشردن \fBCTRL-c\fP هنگام اجرا در ترمینال، عملیات ارسال را خاتمه می‌دهد.

.PP
اطلاعات احراز هویت رجیستری توسط \fBdocker-login(1)\fP\& مدیریت می‌شود.


.SH "مثال‌ها (EXAMPLES)"
.SH "ارسال یک ایمیج جدید به یک رجیستری (Pushing a new image to a registry)"
ابتدا با پیدا کردن شناسه کانتینر (با استفاده از \fBdocker container ls\fP) و سپس کامیت کردن آن به یک نام ایمیج جدید، ایمیج تازه را ذخیره کنید. توجه داشته باشید که هنگام نام‌گذاری ایمیج‌ها فقط کاراکترهای a-z0-9-_. مجاز هستند:

.EX
# docker container commit c16378f943fe rhel-httpd
.EE

.PP
اکنون با استفاده از شناسه ایمیج، آن را به رجیستری ارسال کنید. در این مثال رجیستری روی هاستی به نام \fBregistry-host\fR قرار دارد و به پورت \fB5000\fR\& گوش می‌دهد. برای انجام این کار، ایمیج را با نام هاست یا آدرس IP و پورت رجیستری تگ‌گذاری کنید:

.EX
# docker image tag rhel-httpd registry-host:5000/myadmin/rhel-httpd:latest
# docker image push registry-host:5000/myadmin/rhel-httpd:latest
.EE

.PP
با اجرای دستور زیر بررسی کنید که این عملیات کار کرده است:

.EX
# docker image ls
.EE

.PP
باید هر دو مورد \fBrhel-httpd\fR و \fBregistry-host:5000/myadmin/rhel-httpd\fR را در فهرست مشاهده کنید.

.SS "ارسال همه تگ‌های یک ایمیج (Push all tags of an image)"
از گزینه \fB-a\fR (یا \fB--all-tags\fR) برای ارسال همه تگ‌های یک ایمیج محلی استفاده کنید.

.PP
مثال زیر چندین تگ برای یک ایمیج ایجاد می‌کند و همه آن تگ‌ها را به Docker Hub ارسال می‌نماید.

.EX
$ docker image tag myimage registry-host:5000/myname/myimage:latest
$ docker image tag myimage registry-host:5000/myname/myimage:v1.0.1
$ docker image tag myimage registry-host:5000/myname/myimage:v1.0
$ docker image tag myimage registry-host:5000/myname/myimage:v1
.EE

.PP
ایمیج اکنون تحت چندین نام تگ‌گذاری شده است:

.EX
$ docker image ls

REPOSITORY                          TAG        IMAGE ID       CREATED      SIZE
myimage                             latest     6d5fcfe5ff17   2 hours ago  1.22MB
registry-host:5000/myname/myimage   latest     6d5fcfe5ff17   2 hours ago  1.22MB
registry-host:5000/myname/myimage   v1         6d5fcfe5ff17   2 hours ago  1.22MB
registry-host:5000/myname/myimage   v1.0       6d5fcfe5ff17   2 hours ago  1.22MB
registry-host:5000/myname/myimage   v1.0.1     6d5fcfe5ff17   2 hours ago  1.22MB
.EE

.PP
هنگام ارسال با گزینه \fB--all-tags\fR، تمام تگ‌های ایمیج \fBregistry-host:5000/myname/myimage\fR ارسال می‌شوند:

.EX
$ docker image push --all-tags registry-host:5000/myname/myimage

The push refers to repository [registry-host:5000/myname/myimage]
195be5f8be1d: Pushed
latest: digest: sha256:edafc0a0fb057813850d1ba44014914ca02d671ae247107ca70c94db686e7de6 size: 4527
195be5f8be1d: Layer already exists
v1: digest: sha256:edafc0a0fb057813850d1ba44014914ca02d671ae247107ca70c94db686e7de6 size: 4527
195be5f8be1d: Layer already exists
v1.0: digest: sha256:edafc0a0fb057813850d1ba44014914ca02d671ae247107ca70c94db686e7de6 size: 4527
195be5f8be1d: Layer already exists
v1.0.1: digest: sha256:edafc0a0fb057813850d1ba44014914ca02d671ae247107ca70c94db686e7de6 size: 4527
.EE


.SH "گزینه‌ها (OPTIONS)"
\fB-a\fP, \fB--all-tags\fP[=false]
	ارسال همه تگ‌های یک ایمیج به مخزن

.PP
\fB--platform\fP=""
	ارسال مانیفست مخصوص یک پلتفرم به عنوان یک ایمیج تک‌پلتفرمی به رجیستری.
ایندکس ایمیج ارسال نخواهد شد، به این معنی که سایر مانیفست‌ها، از جمله گواهی‌ها (attestations)، حفظ نخواهند شد.
\&'os[/arch[/variant]]': پلتفرم صریح (مانند linux/amd64)

.PP
\fB-q\fP, \fB--quiet\fP[=false]
	جلوگیری از خروجی پرحجم

.SH "ببینید (SEE ALSO)"
\fBdocker-image(1)\fP