.nh
.TH umoci-raw-add-layer(1) # umoci raw add-layer - add a layer archive verbatim to an image
Aleksa Sarai
SEPTEMBER 2018

.SH "نام (NAME)"
umoci raw add-layer \- افزودن یک بایگانی لایه به‌صورت عین‌به‌عین به یک تصویر


.SH "خلاصه دستور (SYNOPSIS)"
\fBumoci raw add-layer\fP
\fB--image\fP=\fIimage\fP
[\fB--tag\fP=\fItag\fP]
[\fB--compress\fP=\fIcompression-type\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]
\fInew-layer.tar\fP


.SH "توضیحات (DESCRIPTION)"
بایگانی لایه فشرده‌نشده ارجاع داده شده با \fInew-layer.tar\fP را به‌صورت عین‌به‌عین (verbatim) به
تصویر اضافه می‌کند. توجه داشته باشید از آنجا که این کار به‌صورت مستقیم انجام می‌شود، هیچ تغییری روی
لایه صورت نمی‌گیرد و در نتیجه هرگونه افزونه اختصاصی OCI برای \fBtar\fR (مانند فایل‌های
whiteout با پیشوند \fB\&.wh.\fR) بدون تغییر گنجانده خواهند شد. بنابراین استفاده از این دستور تنها
به کاربران خبره توصیه می‌شود و کاربران تازه‌کارتر بهتر است برای ایجاد لایه‌های خود از
\fBumoci-repack\fP(1) استفاده نمایند.

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


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

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

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

.PP
\fB--compress\fP=\fIcompression-type\fP
  نوع فشرده‌سازی مورد استفاده هنگام ایجاد لایه جدید را تعیین می‌کند. انواع فشرده‌سازی
  پشتیبانی‌شده عبارتند از \fInone\fP، \fIgzip\fP و \fIzstd\fP\&. دستور \fBumoci-unpack\fP(1)
  به‌طور شفاف از تمام روش‌های فشرده‌سازی تعیین‌شده توسط \fB--compress\fP پشتیبانی
  می‌کند.
  
  مقدار ویژه \fIauto\fP باعث می‌شود \fBumoci\fP(1) مناسب‌ترین الگوریتم فشرده‌سازی را
  بر اساس الگوریتم فشرده‌سازی لایه‌های قبلی به‌طور خودکار انتخاب کند (تلاش می‌کند از الگوریتم
  فشرده‌سازی جدیدترین لایه‌ای که از آن پشتیبانی می‌کند استفاده کند). توجه داشته باشید که \fIauto\fP
  هرگز فشرده‌سازی \fInone\fP را به‌طور خودکار انتخاب نخواهد کرد، زیرا فشرده نکردن بایگانی‌های
  \fBtar\fP(1) به‌هیچ‌وجه توصیه نمی‌شود.
  
  اگر هیچ \fIcompression-type\fP مشخص نشود، مقدار پیش‌فرض \fIauto\fP خواهد بود.

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

.PP
\fB--history.comment\fP=\fIcomment\fP
  توضیح (comment) برای مدخل تاریخچه مربوط به این تغییر در تصویر.
  در صورت مشخص نشدن، \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) مراجعه کنید).
  در صورت مشخص نشدن، از زمان فعلی استفاده می‌شود.


.SH "مثال‌ها (EXAMPLES)"
دستور زیر یک دایرکتوری diff موجود را گرفته، از آن یک بایگانی جدید می‌سازد
و سپس آن را در یک تصویر موجود درج می‌کند. توجه داشته باشید که بایگانی جدید فشرده
\fIنشده\fP است (\fBumoci\fP بایگانی را برای شما فشرده خواهد کرد).

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


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