.nh
.TH buildah-config "1" "March 2017" "buildah"
.SH "نام (NAME)"
.PP
buildah-config \- به‌روزرسانی تنظیمات پیکربندی تصویر

.SH "خلاصه دستور (SYNOPSIS)"
.PP
\fBbuildah config\fP [\fIگزینه‌ها\fP] \fIکانتینر\fP

.SH "توضیحات (DESCRIPTION)"
.PP
یک یا چند مورد از تنظیمات ذخیره‌شده برای یک کانتینر را به‌روزرسانی می‌کند.

.SH "گزینه‌ها (OPTIONS)"
.PP
\fB--add-history\fP

.PP
افزودن یک مدخل به تاریخچه تصویر که تغییرات اعمال‌شده بر روی تنظیمات مربوط به
\fB--cmd\fP، \fB--entrypoint\fP، \fB--env\fP، \fB--healthcheck\fP، \fB--label\fP،
\fB--onbuild\fP، \fB--port\fP، \fB--shell\fP، \fB--stop-signal\fP، \fB--user\fP،
\fB--volume\fP و \fB--workingdir\fP را ثبت می‌کند.
مقدار پیش‌فرض false است.

.PP
نکته: همچنین می‌توانید مقدار پیش‌فرض --add-history را با مقداردهی متغیر محیطی BUILDAH_HISTORY بازنویسی کنید. \fBexport BUILDAH_HISTORY=true\fR

.PP
\fB--annotation\fP, \fB-a\fP \fIannotation\fP=\fIannotation\fP

.PP
افزودن یک یادداشت تصویر (\fIannotation\fP) (مانند annotation=\fIannotation\fP) به مانیفست تصویری هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد. این گزینه می‌تواند چندین بار استفاده شود.
اگر \fIannotation\fP با یک \fB-\fR پایانی همراه باشد، آن \fIannotation\fP از پیکربندی حذف می‌شود.
اگر \fIannotation\fP برابر "-" تنظیم شود، تمام یادداشت‌ها از پیکربندی حذف می‌شوند.

.PP
\fB--arch\fP \fIarchitecture\fP

.PP
تنظیم معماری هدف (\fIarchitecture\fP) برای هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد. به طور پیش‌فرض، اگر کانتینر بر پایه یک تصویر باشد، معماری هدف آن تصویر حفظ می‌شود، در غیر این صورت معماری میزبان ثبت می‌گردد.

.PP
\fB--author\fP \fIauthor\fP

.PP
تنظیم اطلاعات تماس پدیدآورنده (\fIauthor\fP) برای هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد.

.PP
\fB--cmd\fP \fIcommand\fP

.PP
تنظیم دستور پیش‌فرض (\fIcommand\fP) برای اجرا در کانتینرهایی که بر پایه هر تصویری ساخته‌شده با کانتینر مشخص‌شده ایجاد می‌شوند. هنگامی که همراه با یک \fIنقطه ورود (entry point)\fP استفاده شود، پارامترهای پیش‌فرض را برای آن \fIنقطه ورود\fP تعیین می‌کند.

.PP
\fB--comment\fP \fIcomment\fP

.PP
تنظیم توضیح سطح تصویر (\fIcomment\fP) برای هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد.

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--created-by\fP \fIcreated\fP

.PP
تنظیم توضیح چگونگی ایجاد بالاترین لایه (\fIcreated\fP) برای هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد.

.PP
\fB--domainname\fP \fIdomain\fP

.PP
تنظیم نام دامنه (\fIdomain\fP) برای کانتینرهایی که بر پایه هر تصویری ساخته‌شده با کانتینر مشخص‌شده اجرا می‌شوند.

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--entrypoint\fP \fI"command"\fP | \fI\&'["command", "arg1", ...]'\fP

.PP
تنظیم نقطه ورود (\fIentry point\fP) برای کانتینرهایی که بر پایه هر تصویری ساخته‌شده با کانتینر مشخص‌شده اجرا خواهند شد. ابزار buildah از دو قالب برای نقطه ورود پشتیبانی می‌کند. این مقدار می‌تواند به صورت یک رشته ساده یا به صورت آرایه‌ای از دستورات مشخص شود.

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

.PP
نکته: قالب رشته‌ای به عنوان نقطه ورود به دستور \fBsh -c\fR ضمیمه می‌شود. قالب آرایه‌ای نقطه ورود را به طور کامل جایگزین می‌کند.

.PP
قالب رشته‌ای:

.EX
$ buildah from scratch
$ buildah config --entrypoint "/usr/bin/notashell" working-container
$ buildah inspect --format '{{ .OCIv1.Config.Entrypoint }}' working-container
[/bin/sh -c /usr/bin/notshell]
$ buildah inspect --format '{{ .Docker.Config.Entrypoint }}' working-container
[/bin/sh -c /usr/bin/notshell]
.EE

.PP
قالب آرایه‌ای:

.EX
$ buildah config --entrypoint '["/usr/bin/notashell"]' working-container
$ buildah inspect --format '{{ .OCIv1.Config.Entrypoint }}' working-container
[/usr/bin/notashell]
$ buildah inspect --format '{{ .Docker.Config.Entrypoint }}' working-container
[/usr/bin/notashell]
.EE

.PP
\fB--env\fP, \fB-e\fP \fIenv[=value]\fP

.PP
افزودن یک متغیر محیطی (مانند env=\fIvalue\fP) برای کانتینرهایی که بر پایه هر تصویری ساخته‌شده با کانتینر مشخص‌شده اجرا می‌شوند. این گزینه می‌تواند چندین بار استفاده شود.
اگر \fIenv\fP نام‌گذاری شود ولی نه علامت \fB=\fR و نه مقداری (\fBvalue\fR) مشخص گردد، مقدار از متغیرهای محیطی فرآیند جاری خوانده خواهد شد.
اگر \fIenv\fP با یک \fB-\fR پایانی همراه باشد، آن متغیر محیطی از پیکربندی حذف می‌شود.
اگر \fIenv\fP برابر "-" تنظیم شود، تمام متغیرهای محیطی از پیکربندی حذف می‌شوند.

.PP
\fB--healthcheck\fP \fIcommand\fP

.PP
مشخص کردن دستوری که باید برای بررسی صحت اجرای کانتینر اجرا شود.

.PP
مقادیر می‌توانند \fINONE\fP، "\fICMD\fP ..." (اجرای مستقیم دستور مشخص‌شده)، یا "\fICMD-SHELL\fP ..." (اجرای دستور مشخص‌شده با پوسته سیستم)، یا مقدار خالی (حذف مقدار تنظیم‌شده قبلی و تنظیمات مرتبط) باشند.

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--healthcheck-interval\fP \fIinterval\fP

.PP
مشخص کردن فاصله زمانی میان اجرای دستوری که با گزینه \fI--healthcheck\fP تعیین شده است.

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--healthcheck-retries\fP \fIcount\fP

.PP
مشخص کردن تعداد دفعاتی که دستور گزینه \fI--healthcheck\fP می‌تواند با شکست مواجه شود پیش از آنکه کانتینر ناسالم در نظر گرفته شود.

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--healthcheck-start-interval\fP \fIinterval\fP

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

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--healthcheck-start-period\fP \fIinterval\fP

.PP
مشخص کردن میزان زمانی که می‌تواند پس از شروع کانتینر سپری شود، پیش از آنکه شکست در اجرای دستور گزینه \fI--healthcheck\fP به عنوان نشانه‌ای از خرابی کانتینر تلقی شود. در این دوره زمانی، شکست‌ها ناشی از راه‌اندازی کامل نشدن کانتینر در نظر گرفته شده و به عنوان خطا شمرده نمی‌شوند. پس از موفقیت دستور یا پایان این دوره زمانی، شکست‌ها به عنوان خطا محسوب خواهند شد.

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--healthcheck-timeout\fP \fIinterval\fP

.PP
مشخص کردن مدت زمانی که پس از شروع دستور گزینه \fI--healthcheck\fP باید منتظر بازگشت وضعیت خروج آن ماند. اگر دستور در این بازه زمانی پایان نیابد، ناموفق تلقی می‌شود.

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--history-comment\fP \fIcomment\fP

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

.PP
\fB--hostname\fP \fIhost\fP

.PP
تنظیم نام میزبان (\fIhost\fP) هنگام اجرای کانتینرهایی که بر پایه تصاویر ساخته‌شده با کانتینر مشخص‌شده اجرا می‌شوند.

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--label\fP, \fB-l\fP \fIlabel\fP=\fIvalue\fP

.PP
افزودن یک برچسب تصویر (\fIlabel\fP) (مانند label=\fIvalue\fP) به پیکربندی تصویر هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد. این گزینه می‌تواند چندین بار استفاده شود.
اگر \fIlabel\fP با یک \fB-\fR پایانی همراه باشد، آن برچسب از پیکربندی حذف می‌شود.
اگر \fIlabel\fP برابر "-" تنظیم شود، تمام برچسب‌ها از پیکربندی حذف می‌شوند.

.PP
\fB--onbuild\fP \fIonbuild command\fP

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

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--os\fP \fIoperating system\fP

.PP
تنظیم سیستم‌عامل هدف (\fIoperating system\fP) برای هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد. به طور پیش‌فرض، اگر کانتینر بر پایه یک تصویر باشد، سیستم‌عامل آن حفظ می‌شود، در غیر این صورت نام سیستم‌عامل میزبان ثبت خواهد شد.

.PP
\fB--os-feature\fP \fIfeature\fP

.PP
تنظیم نام یک ویژگی مورد نیاز سیستم‌عامل (\fIfeature\fP) برای هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد. به طور پیش‌فرض، اگر کانتینر بر پایه یک تصویر باشد، فهرست ویژگی‌های سیستم‌عامل مورد نیاز تصویر پایه در صورت وجود حفظ می‌شود. این گزینه معمولاً فقط زمانی معنادار است که سیستم‌عامل تصویر ویندوز باشد.

.PP
اگر \fIfeature\fP با یک \fB-\fR پایانی همراه باشد، آن ویژگی از فهرست ویژگی‌های مورد نیاز تصویر حذف می‌شود. اگر \fIfeature\fP برابر "-" تنظیم شود، کل فهرست ویژگی‌ها از پیکربندی حذف می‌گردد.

.PP
\fB--os-version\fP \fIversion\fP

.PP
تنظیم نسخه دقیق سیستم‌عامل مورد نیاز (\fIversion\fP) برای هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد. به طور پیش‌فرض، اگر کانتینر بر پایه یک تصویر باشد، نسخه سیستم‌عامل مورد نیاز تصویر پایه در صورت وجود حفظ می‌شود. این گزینه معمولاً فقط زمانی معنادار است که سیستم‌عامل تصویر ویندوز باشد و به طور معمول در تصاویر پایه ویندوز تنظیم شده است، بنابراین استفاده از این گزینه معمولاً غیرضروری است.

.PP
\fB--port\fP, \fB-p\fP \fIport/protocol\fP

.PP
افزودن یک پورت (\fIport\fP) برای باز کردن هنگام اجرای کانتینرهایی که بر پایه تصاویر ساخته‌شده با کانتینر مشخص‌شده اجرا می‌شوند. این گزینه می‌تواند چندین بار استفاده شود.
برای تعیین اینکه پورت روی TCP یا UDP گوش دهد، از "port/protocol" استفاده کنید.
اگر پروتکل مشخص نشود، پیش‌فرض TCP است. برای باز کردن پورت روی هر دو پروتکل TCP و UDP، گزینه port را چندین بار مشخص کنید. اگر \fIport\fP با یک \fB-\fR پایانی همراه باشد و قبلاً تنظیم شده باشد، آن پورت از پیکربندی حذف می‌شود. اگر مقدار پورت برابر \fB-\fR تنظیم شود، تمام تنظیمات پورت‌های بازشده از پیکربندی حذف می‌گردند.

.PP
\fB--shell\fP \fIshell\fP

.PP
تنظیم پوسته پیش‌فرض (\fIshell\fP) برای اجرا در داخل تصویر کانتینر.
دستورالعمل shell امکان تغییر پوسته پیش‌فرض استفاده‌شده برای قالب پوسته‌ای دستورات را فراهم می‌کند. پوسته پیش‌فرض برای کانتینرهای لینوکس "/bin/sh -c" است.

.PP
نکته: این تنظیم در قالب تصویر OCIv1 وجود ندارد، بنابراین هنگام ذخیره تصاویر با قالب‌های OCIv1 نادیده گرفته می‌شود.

.PP
\fB--stop-signal\fP \fIsignal\fP

.PP
تنظیم سیگنال توقف پیش‌فرض (\fIsignal\fP) برای کانتینر. این سیگنال زمانی ارسال می‌شود که کانتینر متوقف گردد؛ مقدار پیش‌فرض SIGINT است.

.PP
\fB--unsetannotation\fP \fIannotation\fP

.PP
حذف یادداشت تصویر، به گونه‌ای که آن یادداشت از تصویر پایه به ارث برده نشود.

.PP
\fB--unsetlabel\fP \fIlabel\fP

.PP
حذف برچسب تصویر، به گونه‌ای که آن برچسب از تصویر پایه به ارث برده نشود.

.PP
\fB--user\fP, \fB-u\fP \fIuser\fP[:\fIgroup\fP]

.PP
تنظیم کاربر پیش‌فرض (\fIuser\fP) برای اجرای کانتینرهای بر پایه این تصویر.
کاربر می‌تواند به صورت نام کاربری یا UID مشخص شود و به صورت اختیاری یک نام گروه یا GID با علامت دو نقطه (':') به دنبال آن بیاید.
اگر از نام‌ها استفاده شود، کانتینر باید دارای مدخل‌های مربوط به آن نام‌ها در فایل‌های
\fI/etc/passwd\fP و \fI/etc/group\fP خود باشد.

.PP
\fB--variant\fP \fIvariant\fP

.PP
تنظیم گونه معماری هدف (\fIvariant\fP) برای هر تصویری که با استفاده از کانتینر مشخص‌شده ساخته خواهد شد. به طور پیش‌فرض، اگر کانتینر بر پایه یک تصویر باشد، معماری هدف و اطلاعات گونه آن تصویر حفظ می‌شود، در غیر این صورت معماری و گونه میزبان ثبت می‌گردد.

.PP
\fB--volume\fP, \fB-v\fP \fIvolume\fP

.PP
افزودن یک مسیر در درخت دایرکتوری که باید به عنوان یک حجم (\fIvolume\fP) در هر تصویری ساخته‌شده با کانتینر مشخص‌شده علامت‌گذاری شود. این گزینه می‌تواند چندین بار استفاده شود. اگر \fIvolume\fP با یک \fB-\fR پایانی همراه باشد و قبلاً تنظیم شده باشد، آن حجم از پیکربندی حذف می‌شود.
اگر مقدار \fIvolume\fP برابر "-" تنظیم شود، تمام حجم‌ها از پیکربندی حذف می‌گردند.

.PP
\fB--workingdir\fP \fIdirectory\fP

.PP
تنظیم دایرکتوری کاری اولیه (\fIdirectory\fP) برای کانتینرهایی که بر پایه تصاویر ساخته‌شده با کانتینر مشخص‌شده ایجاد می‌شوند.

.SH "مثال (EXAMPLE)"
.PP
buildah config --author='Jane Austen' --workingdir='/etc/mycontainers' containerID

.PP
buildah config --entrypoint /entrypoint.sh containerID

.PP
buildah config --entrypoint '[ "/entrypoint.sh", "dev" ]' containerID

.PP
buildah config --env foo=bar --env PATH=$PATH containerID

.PP
buildah config --env foo- containerID

.PP
buildah config --label Name=Mycontainer --label  Version=1.0 containerID

.PP
buildah config --label Name- containerID

.PP
buildah config --annotation note=myNote containerID

.PP
buildah config --annotation note-

.PP
buildah config --volume /usr/myvol containerID

.PP
buildah config --volume /usr/myvol- containerID

.PP
buildah config --port 1234 --port 8080 containerID

.PP
buildah config --port 514/tcp --port 514/udp containerID

.PP
buildah config --env 1234=5678 containerID

.PP
buildah config --env 1234- containerID

.PP
buildah config --os-version 10.0.19042.1645 containerID

.PP
buildah config --os-feature win32k containerID

.PP
buildah config --os-feature win32k- containerID

.SH "همچنین ببینید (SEE ALSO)"
.PP
buildah(1)