.nh
.TH umoci-raw-config(1) # umoci raw config - Generate an OCI runtime configuration for an image
Aleksa Sarai
DECEMBER 2016

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


.SH "خلاصه دستور (SYNOPSIS)"
\fBumoci raw runtime-config\fP
\fB--image\fP=\fIimage\fP[:\fItag\fP]
[\fB--rootfs\fP=\fIrootfs\fP]
[\fB--rootless\fP]
\fIconfig\fP

.PP
\fBumoci raw config\fP
\fB--image\fP=\fIimage\fP[:\fItag\fP]
[\fB--rootfs\fP=\fIrootfs\fP]
[\fB--rootless\fP]
\fIconfig\fP


.SH "توضیحات (DESCRIPTION)"
یک پیکربندی زمان اجرای OCI جدید از یک تصویر بدون استخراج rootfs آن تصویر تولید می‌کند. این پیکربندی در مسیر ارائه‌شده توسط \fIconfig\fP نوشته می‌شود و در صورت وجود، بازنویسی خواهد شد. این یکی از عملیاتی است که توسط \fBumoci-unpack\fP(1) هنگام تولید بسته زمان اجرا (runtime bundle) انجام می‌شود، اما به دلیل بار پردازشی استخراج فایل‌سیستم ریشه، در صورتی که کاربر واقعاً قصد استفاده از فایل‌سیستم ریشه را نداشته باشد، استفاده مکرر از \fBumoci-unpack\fP(1) کاربردی نیست. برخی فیلدها به یک فایل‌سیستم ریشه به عنوان «مرجع حقیقت» نیاز دارند و یک فایل‌سیستم ریشه مبدأ را می‌توان با استفاده از \fB--rootfs\fP\& مشخص کرد. سایر گزینه‌ها تأثیری مشابه با \fBumoci-unpack\fP(1) دارند.

.PP
با این حال توجه داشته باشید که خروجی \fBumoci-raw-config\fP(1) لزوماً با خروجی \fBumoci-unpack\fP(1) یکسان نیست. این موضوع به‌ویژه زمانی صدق می‌کند که \fB--rootfs\fP مشخص نشده باشد، که باعث می‌شود \fBumoci\fP(1) در صورتی که محاسبه مقادیر فیلدها در مشخصات زمان اجرا نیازمند استفاده از فایل‌سیستم ریشه به عنوان مرجع حقیقت باشد، آن‌ها را روی مقادیر پیش‌فرضشان رها کند.


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

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

.PP
\fB--rootfs\fP=\fIrootfs\fP
  استفاده از \fIrootfs\fP به عنوان مرجع ثانویه حقیقت هنگام تولید پیکربندی زمان اجرا (این مورد به‌ویژه برای تبدیل \fIConfig.User\fP اهمیت دارد). در صورت تعیین نشدن، هر فیلد زمان اجرایی که برای پر شدن به مرجع ثانویه حقیقت نیاز داشته باشد، روی مقادیر پیش‌فرض خود باقی می‌ماند. این موضوع ممکن است منجر به مغایرت‌هایی بین خروجی \fBumoci-unpack\fP(1) و \fBumoci-raw-config\fP(1) شود.

.PP
\fB--rootless\fP
  تولید پیکربندی کانتینر بدون ریشه (rootless)، مشابه پیکربندی تولیدشده توسط \fBumoci-unpack\fP(1) هنگامی که گزینه \fB--rootless\fP به آن داده می‌شود.


.SH "مثال‌ها (EXAMPLES)"
دستور زیر یک تصویر را با استفاده از \fBskopeo\fP(1) از یک رجیستری \fBdocker\fP(1) دانلود کرده و سپس فایل \fIconfig.json\fP را برای آن تصویر تولید می‌کند.

.EX
% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
% umoci raw config --image image:latest config.json
.EE

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

.EX
% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
# umoci unpack --image image bundle
% umoci raw config --image image --rootfs bundle/rootfs config.json
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBumoci\fP(1), \fBumoci-raw-runtime-config\fP(1), \fBumoci-repack\fP(1), \fBrunc\fP(8)