نام (NAME)

umoci-raw-config - تولید پیکربندی زمان اجرای OCI برای یک تصویر

خلاصه دستور (SYNOPSIS)

umoci raw runtime-config --image=image[:tag] [--rootfs=rootfs] [--rootless] config

umoci raw config --image=image[:tag] [--rootfs=rootfs] [--rootless] config

توضیحات (DESCRIPTION)

یک پیکربندی زمان اجرای OCI جدید از یک تصویر بدون استخراج rootfs آن تصویر تولید می‌کند. این پیکربندی در مسیر ارائه‌شده توسط config نوشته می‌شود و در صورت وجود، بازنویسی خواهد شد. این یکی از عملیاتی است که توسط umoci-unpack(1) هنگام تولید بسته زمان اجرا (runtime bundle) انجام می‌شود، اما به دلیل بار پردازشی استخراج فایل‌سیستم ریشه، در صورتی که کاربر واقعاً قصد استفاده از فایل‌سیستم ریشه را نداشته باشد، استفاده مکرر از umoci-unpack(1) کاربردی نیست. برخی فیلدها به یک فایل‌سیستم ریشه به عنوان «مرجع حقیقت» نیاز دارند و یک فایل‌سیستم ریشه مبدأ را می‌توان با استفاده از --rootfs مشخص کرد. سایر گزینه‌ها تأثیری مشابه با umoci-unpack(1) دارند.

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

گزینه‌ها (OPTIONS)

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

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

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

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

مثال‌ها (EXAMPLES)

دستور زیر یک تصویر را با استفاده از skopeo(1) از یک رجیستری docker(1) دانلود کرده و سپس فایل config.json را برای آن تصویر تولید می‌کند.

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

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

% 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

همچنین ببینید (SEE ALSO)

umoci(1), umoci-raw-runtime-config(1), umoci-repack(1), runc(8)