umoci-raw-add-layer(1)(#) add-layer umoci-raw-add-layer(1)(#)
Aleksa Sarai SEPTEMBER 2018

umoci raw add-layer - افزودن یک بایگانی لایه به‌صورت عین‌به‌عین به یک تصویر

umoci raw add-layer --image=image [--tag=tag] [--compress=compression-type] [--no-history] [--history.comment=comment] [--history.created_by=created_by] [--history.author=author] [--history-created=date] new-layer.tar

بایگانی لایه فشرده‌نشده ارجاع داده شده با new-layer.tar را به‌صورت عین‌به‌عین (verbatim) به تصویر اضافه می‌کند. توجه داشته باشید از آنجا که این کار به‌صورت مستقیم انجام می‌شود، هیچ تغییری روی لایه صورت نمی‌گیرد و در نتیجه هرگونه افزونه اختصاصی OCI برای tar (مانند فایل‌های whiteout با پیشوند .wh.) بدون تغییر گنجانده خواهند شد. بنابراین استفاده از این دستور تنها به کاربران خبره توصیه می‌شود و کاربران تازه‌کارتر بهتر است برای ایجاد لایه‌های خود از umoci-repack(1) استفاده نمایند.

در حال حاضر، umoci raw add-layer تنها از افزودن لایه‌ها به انتهای فهرست لایه‌های تصویر پشتیبانی می‌کند.

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

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

--tag=tag
تگ مقصد برای استفاده در تصویر تازه ایجاد شده. tag باید تگی معتبر
در تصویر باشد. اگر tag ارائه نشود، به‌طور پیش‌فرض از همان tag مشخص‌شده
در --image استفاده می‌شود (و روی آن بازنویسی خواهد شد).

--compress=compression-type
نوع فشرده‌سازی مورد استفاده هنگام ایجاد لایه جدید را تعیین می‌کند. انواع فشرده‌سازی
پشتیبانی‌شده عبارتند از none، gzip و zstd. دستور umoci-unpack(1)
به‌طور شفاف از تمام روش‌های فشرده‌سازی تعیین‌شده توسط --compress پشتیبانی
می‌کند.


مقدار ویژه auto باعث می‌شود umoci(1) مناسب‌ترین الگوریتم فشرده‌سازی را
بر اساس الگوریتم فشرده‌سازی لایه‌های قبلی به‌طور خودکار انتخاب کند (تلاش می‌کند از الگوریتم
فشرده‌سازی جدیدترین لایه‌ای که از آن پشتیبانی می‌کند استفاده کند). توجه داشته باشید که auto
هرگز فشرده‌سازی none را به‌طور خودکار انتخاب نخواهد کرد، زیرا فشرده نکردن بایگانی‌های
tar(1) به‌هیچ‌وجه توصیه نمی‌شود.


اگر هیچ compression-type مشخص نشود، مقدار پیش‌فرض auto خواهد بود.

--no-history
باعث می‌شود هیچ مدخلی در تاریخچه برای این عملیات ثبت نشود. استفاده از این گزینه با
umoci-raw-add-layer(1) توصیه نمی‌شود، زیرا باعث می‌شود تاریخچه شامل تمامی
لایه‌های تصویر نباشد -- و در نتیجه ابزارهایی که به تاریخچه تصویر نگاه می‌کنند دچار سردرگمی خواهند شد.

--history.comment=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) مراجعه کنید).
در صورت مشخص نشدن، از زمان فعلی استفاده می‌شود.

دستور زیر یک دایرکتوری diff موجود را گرفته، از آن یک بایگانی جدید می‌سازد و سپس آن را در یک تصویر موجود درج می‌کند. توجه داشته باشید که بایگانی جدید فشرده نشده است (umoci بایگانی را برای شما فشرده خواهد کرد).

% tar cfC diff-layer.tar diff/ .
% umoci raw add-layer --image oci:foo diff-layer.tar

umoci(1), umoci-repack(1)

umoci raw