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

.SH "نام (NAME)"
docker-container-commit \- ایجاد یک ایمیج جدید از تغییرات یک کانتینر


.SH "خلاصه (SYNOPSIS)"
\fBdocker container commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]\fP


.SH "شرح (DESCRIPTION)"
ایجاد یک ایمیج جدید از یک کانتینر موجود که با نام یا شناسه کانتینر مشخص شده است. ایمیج جدید شامل محتویات فایل‌سیستم کانتینر خواهد بود، \fIبه‌جز\fP هرگونه حجم داده (data volume). برای اطلاعات بیشتر در مورد نام‌های معتبر ایمیج و برچسب به \fBdocker-tag(1)\fP مراجعه کنید.

.PP
اگرچه دستور \fBdocker commit\fR روشی آسان برای گسترش یک ایمیج موجود است، برای تولید ایمیج‌هایی که قصد اشتراک‌گذاری آن‌ها با دیگران را دارید، باید استفاده از Dockerfile و \fBdocker build\fR را ترجیح دهید.


.SH "مثال‌ها (EXAMPLES)"
.SH "ایجاد یک ایمیج جدید از یک کانتینر موجود (Creating a new image from an existing container)"
روی یک کانتینر موجود بر پایه Fedora، در حالی که در حالت تعاملی با پوسته bash اجرا می‌شده، Apache نصب شده است. Apache نیز در حال اجرا است. برای ایجاد یک ایمیج جدید، دستور \fBdocker ps\fR را اجرا کنید تا شناسه کانتینر را بیابید و سپس اجرا کنید:

.EX
$ docker commit -m="Added Apache to Fedora base image" \\
  -a="A D Ministrator" 98bd7fc99854 fedora/fedora_httpd:20
.EE

.PP
توجه داشته باشید که هنگام نام‌گذاری ایمیج‌ها از یک کانتینر موجود، تنها کاراکترهای a-z0-9-_. مجاز هستند.

.SH "اعمال دستورالعمل‌های مشخص‌شده Dockerfile هنگام کامیت ایمیج (Apply specified Dockerfile instructions while committing the image)"
اگر یک کانتینر موجود بدون تنظیم متغیر محیطی DEBUG روی "true" ایجاد شده باشد، می‌توانید با دریافت ابتدا شناسه کانتینر با استفاده از \fBdocker ps\fR و سپس اجرای دستور زیر، یک ایمیج جدید بر اساس آن کانتینر ایجاد کنید:

.EX
$ docker container commit -c="ENV DEBUG=true" 98bd7fc99854 debug-image
.EE


.SH "گزینه‌ها (OPTIONS)"
\fB-a\fP, \fB--author\fP=""
	نویسنده (برای نمونه، "John Hannibal Smith hannibal@a-team.com
\[la]mailto:hannibal@a\-team.com\[ra]")

.PP
\fB-c\fP, \fB--change\fP=
	اعمال دستورالعمل Dockerfile روی ایمیج ایجادشده

.PP
\fB-m\fP, \fB--message\fP=""
	پیام کامیت

.PP
\fB--no-pause\fP[=false]
	غیرفعال کردن متوقف‌سازی (pause) کانتینر در حین کامیت


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