umoci-config(1)(#) - umoci-config(1)(#)
Aleksa Sarai DECEMBER 2016

umoci config - ویرایش پیکربندی یک تصویر OCI

umoci config --image=image[:tag] [--tag=new-tag] [--no-history] [--history.comment=comment] [--history.created_by=created_by] [--history.author=author] [--history-created=date] [--clear=value] [--config.user=value] [--config.exposedports=value] [--config.env=value] [--config.entrypoint=value] [--config.cmd=value] [--config.volume=value] [--config.label=value] [--config.workingdir=value] [--created=value] [--author=value] [--platform.os=value] [--platform.arch=value] [--manifest.annotation=value]

داده‌های پیکربندی و مانیفست یک تصویر OCI برچسب‌خوردهٔ مشخص را تغییر می‌دهد — روی آن رونویسی می‌شود مگر اینکه --tag را مشخص کنید. اگر --no-history مشخص نشده باشد، یک مدخل تاریخچه برای این تغییر به تصویر OCI برچسب‌خورده افزوده می‌شود (به طوری که گزینه‌های گوناگون --history. مقادیر استفاده‌شده را کنترل می‌کنند). برای مشاهدهٔ تاریخچه، umoci-stat(1) را ببینید.

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

گزینه‌های عمومی در umoci(1) تعریف شده‌اند.

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

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

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

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

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

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

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

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

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

گزینه‌های زیر همگی مقادیر مربوط به خود را در پیکربندی یا مانیفست تصویر تنظیم می‌کنند. برای اطلاعات بیشتر به مشخصات تصویر OCI رجوع کنید: ⟨https://github.com/opencontainers/image-spec⟩.

  • --config.user=value
  • --config.exposedports=value
  • --config.env=value
  • --config.entrypoint=value
  • --config.cmd=value
  • --config.volume=value
  • --config.label=value
  • --config.workingdir=value
  • --created=value
  • --author=value
  • --platform.os=value (همچنین با --os قابل تنظیم است)
  • --platform.arch=value (همچنین با --architecture قابل تنظیم است)
  • --manifest.annotation=value

دستور زیر پیکربندی یک تصویر OCI را از جهات گوناگون تغییر می‌دهد و برچسب اصلی را با تصویر جدید رونویسی می‌کند.

% 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)"

umoci(1)

umoci config