.nh
.TH umoci-config(1) # umoci config - Modifies the configuration of an OCI image
Aleksa Sarai
DECEMBER 2016

.SH "نام (NAME)"
umoci config \- ویرایش پیکربندی یک تصویر OCI


.SH "خلاصه دستور (SYNOPSIS)"
\fBumoci config\fP
\fB--image\fP=\fIimage\fP[:\fItag\fP]
[\fB--tag\fP=\fInew-tag\fP]
[\fB--no-history\fP]
[\fB--history.comment\fP=\fIcomment\fP]
[\fB--history.created_by\fP=\fIcreated_by\fP]
[\fB--history.author\fP=\fIauthor\fP]
[\fB--history-created\fP=\fIdate\fP]
[\fB--clear\fP=\fIvalue\fP]
[\fB--config.user\fP=\fIvalue\fP]
[\fB--config.exposedports\fP=\fIvalue\fP]
[\fB--config.env\fP=\fIvalue\fP]
[\fB--config.entrypoint\fP=\fIvalue\fP]
[\fB--config.cmd\fP=\fIvalue\fP]
[\fB--config.volume\fP=\fIvalue\fP]
[\fB--config.label\fP=\fIvalue\fP]
[\fB--config.workingdir\fP=\fIvalue\fP]
[\fB--created\fP=\fIvalue\fP]
[\fB--author\fP=\fIvalue\fP]
[\fB--platform.os\fP=\fIvalue\fP]
[\fB--platform.arch\fP=\fIvalue\fP]
[\fB--manifest.annotation\fP=\fIvalue\fP]


.SH "توضیحات (DESCRIPTION)"
داده‌های پیکربندی و مانیفست یک تصویر OCI برچسب‌خوردهٔ مشخص را تغییر می‌دهد \(em
\fBروی آن رونویسی می‌شود مگر اینکه \-\-tag را مشخص کنید\fP\&. اگر \fB\-\-no\-history\fP
مشخص نشده باشد، یک مدخل تاریخچه برای این تغییر به تصویر OCI برچسب‌خورده افزوده می‌شود
(به طوری که گزینه‌های گوناگون \fB\-\-history.\fP مقادیر استفاده‌شده را کنترل می‌کنند). برای مشاهدهٔ
تاریخچه، \fBumoci\-stat\fP(1) را ببینید.

.PP
توجه داشته باشید که برچسب تصویر اصلی (آرگومان داده‌شده به \fB\-\-image\fP) تغییر \fBنخواهد کرد\fP
مگر اینکه هدف \fBumoci\-config\fP(1) همان برچسب تصویر اصلی باشد.


.SH "گزینه‌ها (OPTIONS)"
گزینه‌های عمومی در \fBumoci\fP(1) تعریف شده‌اند.

.PP
\fB\-\-image\fP=\fIimage\fP[:\fItag\fP]
  تصویر OCI برچسب‌خوردهٔ مبدأ که پیکربندی آن تغییر خواهد کرد. \fIimage\fP باید
  مسیری به یک تصویر معتبر OCI و \fItag\fP باید یک برچسب معتبر درون تصویر باشد. اگر
  \fItag\fP مشخص نشود، مقدار پیش‌فرض آن "latest" خواهد بود.

.PP
\fB\-\-tag\fP=\fInew-tag\fP
  نام برچسب برای تصویر تغییریافته؛ در صورت عدم تعیین، برچسب اصلی ارائه‌شده
  به \fB\-\-image\fP رونویسی و جایگزین خواهد شد.

.PP
\fB\-\-no\-history\fP
  باعث می‌شود هیچ مدخل تاریخچه‌ای برای این عملیات افزوده نشود.

.PP
\fB\-\-history.comment\fP=\fIcomment\fP
  توضیح برای مدخل تاریخچهٔ مربوط به این تغییر در پیکربندی تصویر.
  در صورت عدم تعیین، \fBumoci\fP(1) یک مقدار وابسته به پیاده‌سازی تولید خواهد کرد.

.PP
\fB\-\-history.created_by\fP=\fIcreated_by\fP
  مدخل CreatedBy برای مدخل تاریخچهٔ مربوط به این تغییر در پیکربندی
  تصویر. در صورت عدم تعیین، \fBumoci\fP(1) یک مقدار وابسته به پیاده‌سازی تولید خواهد کرد.

.PP
\fB\-\-history.author\fP=\fIauthor\fP
  مقدار پدیدآورنده (Author) برای مدخل تاریخچهٔ مربوط به این تغییر در پیکربندی تصویر.
  در صورت عدم تعیین، این مقدار برابر با مقدار نویسندهٔ تصویر \fBپس از\fP اعمال هرگونه
  تغییر توسط این فراخوانی از \fBumoci\-config\fP(1) خواهد بود.

.PP
\fB\-\-history\-created\fP=\fIdate\fP
  تاریخ ایجاد برای مدخل تاریخچهٔ مربوط به این تغییرات در پیکربندی تصویر.
  این مقدار باید یک برچسب زمانی با قالب ISO8601 باشد (\fBdate\fP(1) را ببینید).
  در صورت عدم تعیین، زمان فعلی استفاده می‌شود.

.PP
\fB\-\-clear\fP=\fIvalue\fP
  تمام ورودی‌های از پیش موجود برای یک گزینهٔ پیکربندی از نوع مجموعه (set) یا فهرست (list) را پاک می‌کند
  (تغییرات اعمال‌شده توسط این فراخوانی از \fBumoci\-config\fP(1) را لغو نخواهد کرد).
  مقادیر معتبر برای \fIvalue\fP عبارتند از:

.EX
* config.labels
* manifest.annotations
* config.exposedports
* config.env
* config.entrypoint
* config.cmd
* config.volume
.EE

.PP
گزینه‌های زیر همگی مقادیر مربوط به خود را در پیکربندی یا مانیفست تصویر تنظیم می‌کنند.
برای اطلاعات بیشتر به مشخصات تصویر OCI رجوع کنید:
\[la]https://github.com/opencontainers/image\-spec\[ra]\&.
.IP \(bu 2
\fB\-\-config.user\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-config.exposedports\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-config.env\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-config.entrypoint\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-config.cmd\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-config.volume\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-config.label\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-config.workingdir\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-created\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-author\fP=\fIvalue\fP
.IP \(bu 2
\fB\-\-platform.os\fP=\fIvalue\fP (همچنین با \fB\-\-os\fP قابل تنظیم است)
.IP \(bu 2
\fB\-\-platform.arch\fP=\fIvalue\fP (همچنین با \fB\-\-architecture\fP قابل تنظیم است)
.IP \(bu 2
\fB\-\-manifest.annotation\fP=\fIvalue\fP


.SH "مثال‌ها (EXAMPLES)"
دستور زیر پیکربندی یک تصویر OCI را از جهات گوناگون تغییر می‌دهد و برچسب اصلی را با تصویر جدید رونویسی می‌کند.

.EX
% umoci config --image image:tag --clear=config.env --config.env="VARIABLE=true" \\
	--config.user="user:group" --config.entrypoint=cat --config.cmd=/proc/self/stat \\
	--config.label="com.cyphar.umoci=true" --author="Aleksa Sarai <cyphar@cyphar.com>" \\
	--platform.os="linux" --platform.arch="amd64" --created="$(date --iso-8601=seconds)"
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBumoci\fP(1)