.nh
.TH podman-commit 1
.SH "نام (NAME)"
podman-commit \- ایجاد یک ایمیج جدید بر اساس کانتینر تغییریافته

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

.PP
\fBpodman container commit\fP [\fIگزینه‌ها\fP] \fIکانتینر\fP [\fIایمیج\fP]

.SH "توضیحات (DESCRIPTION)"
دستور \fBpodman commit\fP یک ایمیج بر اساس \fIکانتینر\fP تغییریافته ایجاد می‌کند. پدیدآورنده ایمیج را می‌توان با گزینه \fB--author\fP مشخص کرد. دستورالعمل‌های گوناگون ایمیج با گزینه \fB--change\fP قابل پیکربندی هستند و پیام تثبیت (commit) را می‌توان با گزینه \fB--message\fP تعیین کرد. \fIکانتینر\fP و فرایندهای آن در زمان تثبیت ایمیج موقتاً متوقف (pause) می‌شوند. اگر این رفتار مورد نظر نباشد، گزینه \fB--pause\fP را می‌توان روی \fIfalse\fP تنظیم کرد. پس از تکمیل عملیات commit، پادمن شناسه ایمیج جدید را چاپ می‌کند.

.PP
اگر نام \fIایمیج\fR با بخش نام رجیستری آغاز نشود، عبارت \fBlocalhost\fR به نام افزوده می‌شود.
اگر \fIایمیج\fR مشخص نشود، مقادیر \fBREPOSITORY\fR و \fBTAG\fR برای ایمیج ایجادشده برابر با \fB<none>\fR قرار داده می‌شود.

.SH "گزینه‌ها (OPTIONS)"
.SS \fB--author\fP, \fB-a\fP=\fIپدیدآورنده\fP
تنظیم پدیدآورنده برای ایمیج تثبیت‌شده.

.SS \fB--change\fP, \fB-c\fP=\fIدستورالعمل\fP
اعمال دستورالعمل‌های ممکن زیر بر روی ایمیج ایجادشده:
.IP \(bu 2
\fICMD\fP
.IP \(bu 2
\fIENTRYPOINT\fP
.IP \(bu 2
\fIENV\fP
.IP \(bu 2
\fIEXPOSE\fP
.IP \(bu 2
\fILABEL\fP
.IP \(bu 2
\fIONBUILD\fP
.IP \(bu 2
\fISTOPSIGNAL\fP
.IP \(bu 2
\fIUSER\fP
.IP \(bu 2
\fIVOLUME\fP
.IP \(bu 2
\fIWORKDIR\fP

.PP
می‌تواند چندین بار مشخص شود.

.SS \fB--config\fP=\fIفایل‌پیکربندی\fP
ادغام پیکربندی کانتینر از فایل مشخص‌شده در پیکربندی ایمیج در هنگام تثبیت آن. محتوای فایل باید یک نسخه کدگذاری‌شده با JSON از ساختار Schema2Config باشد که در آدرس زیر تعریف شده است:
.br
<https://github.com/containers/image/blob/v5.29.0/manifest/docker_schema2.go#L67>

.SS \fB--format\fP, \fB-f\fP=\fBoci\fP | \fIdocker\fP
تنظیم قالب مانیفست و متاداده ایمیج. قالب‌های پشتیبانی‌شده فعلی \fBoci\fP و \fIdocker\fP هستند.
.br
پیش‌فرض \fBoci\fP است.

.SS \fB--iidfile\fP=\fIفایل‌شناسه‌ایمیج\fP
نوشتن شناسه ایمیج در فایل مشخص‌شده.

.SS \fB--include-volumes\fP
شامل کردن تمام حجم‌هایی (volumes) در ایمیج تثبیت‌شده که با گزینه‌های \fB--volume\fP یا \fB--mount\fP به دستورات \fBpodman create\fP و \fBpodman run\fP به کانتینر اضافه شده‌اند.
.br
پیش‌فرض \fBfalse\fP است.

.SS \fB--message\fP, \fB-m\fP=\fIپیام\fP
تنظیم پیام تثبیت برای ایمیج ایجادشده.
.br
\fIمهم: فیلد پیام در قالب \fBoci\fR پشتیبانی نمی‌شود.\fP

.SS \fB--pause\fP, \fB-p\fP
توقف موقت (pause) کانتینر در هنگام ایجاد ایمیج.
توقف موقت یک کانتینر در حال اجرا هنگام کامیت، از شرایط رقابتی (race conditions) و مشکلات امنیتی بالقوه ناشی از دسترسی سایر فرایندها به rootfs کانتینر در هنگام ایجاد ایمیج جلوگیری می‌کند.
.br
پیش‌فرض \fBtrue\fP است.

.SS \fB--quiet\fP, \fB-q\fP
جلوگیری از نمایش خروجی.
.br
پیش‌فرض \fBfalse\fP است.

.SS \fB--squash\fP, \fB-s\fP
ادغام (squash) لایه‌های تازه ساخته‌شده در یک لایه منفرد جدید.
.br
پیش‌فرض \fBfalse\fP است.

.SH "مثال‌ها (EXAMPLES)"
ایجاد ایمیج از کانتینر همراه با نقطه ورود (entrypoint) و برچسب (label):

.EX
$ podman commit --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change "LABEL blue=image" reverent_golick image-committed
Getting image source signatures
Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
 25.80 MB / 25.80 MB [======================================================] 0s
Copying config sha256:c16a6d30f3782288ec4e7521c754acc29d37155629cb39149756f486dae2d4cd
 448 B / 448 B [============================================================] 0s
Writing manifest to image destination
Storing signatures
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
.EE

.PP
ایجاد ایمیج از کانتینر همراه با پیام تثبیت:

.EX
$ podman commit -q --message "committing container to image"
reverent_golick image-committed
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
.EE

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

.EX
$ podman commit -q --author "firstName lastName" reverent_golick image-committed
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
.EE

.PP
تثبیت کانتینر در حال اجرا بدون متوقف کردن موقت آن:

.EX
$ podman commit -q --pause=false containerID image-committed
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
.EE

.PP
ایجاد ایمیج از کانتینر با برچسب پیش‌فرض ایمیج:

.EX
$ podman commit containerID
e3ce4d93051ceea088d1c242624d659be32cf1667ef62f1d16d6b60193e2c7a8
.EE

.PP
ایجاد ایمیج از کانتینر با قابلیت‌های الزامی پیش‌فرض:

.EX
$ podman commit -q --change LABEL=io.containers.capabilities=setuid,setgid epic_nobel privimage
400d31a3f36dca751435e80a0e16da4859beb51ff84670ce6bdc5edb30b94066
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBpodman(1)\fP, \fBpodman-run(1)\fP, \fBpodman-create(1)\fP

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

.SH "تاریخچه (HISTORY)"
دسامبر ۲۰۱۷، در ابتدا توسط Urvashi Mohnani umohnani@redhat.com
\[la]mailto:umohnani@redhat.com\[ra]
گردآوری شد.