.nh
.TH umoci-repack(1) # umoci repack - Repacks an OCI runtime bundle into an image tag
Aleksa Sarai
DECEMBER 2016

.SH "نام (NAME)"
umoci repack \- بسته‌بندی مجدد یک باندل زمان اجرای OCI در یک برچسب ایمیج


.SH "خلاصه دستور (SYNOPSIS)"
\fBumoci repack\fP
\fB--image\fP=\fIimage\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]
[\fB--refresh-bundle\fP]
\fIbundle\fP


.SH "توضیحات (DESCRIPTION)"
با دریافت یک باندل OCI تغییریافته که با \fBumoci-unpack\fP(1) (در مسیر داده‌شدهٔ \fIbundle\fP) استخراج شده است، دستور \fBumoci-repack\fP(1) تفاوت‌های سیستم‌فایل (delta) را برای \fIrootfs\fP باندل OCI محاسبه می‌کند. این تفاوت‌ها برای تولید یک لایهٔ دلتا استفاده می‌شوند، که سپس به مانیفست ایمیج اصلی (که به‌عنوان آرگومان برای \fBumoci-unpack\fP(1) استفاده شده بود) ضمیمه شده و با یک برچسب ایمیج جدید برچسب‌گذاری می‌شود. در فاصلهٔ بین فراخوانی \fBumoci-unpack\fP(1) و \fBumoci-repack\fP(1)، کاربران «نباید» به هیچ نحوی ایمیج OCI را تغییر دهند (به‌ویژه «نباید» از \fBumoci-gc\fP(1) استفاده کنید).

.PP
تمام تنظیمات \fB--uid-map\fP و \fB--gid-map\fP از مقادیر ذخیره‌شدهٔ مشخص‌شده در \fBumoci-unpack\fP(1) استنتاج می‌شوند، بنابراین در \fBumoci-repack\fP(1) در دسترس نیستند.

.PP
اگر \fB--no-history\fP مشخص نشده باشد، یک مدخل تاریخچه برای این تغییر به ایمیج OCI برچسب‌گذاری‌شده ضمیمه می‌شود (که پرچم‌های مختلف \fB--history.\fP مقادیر مورد استفاده را کنترل می‌کنند). برای مشاهدهٔ تاریخچه، \fBumoci-stat\fP(1) را ببینید.

.PP
توجه داشته باشید که برچسب ایمیج اصلی (استفاده‌شده با \fBumoci-unpack\fP(1)) تغییر \fBنخواهد کرد\fP مگر اینکه مقصد \fBumoci-repack\fP(1) همان برچسب ایمیج اصلی باشد.


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

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

.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-repack(1) توصیه نمی‌شود، زیرا باعث می‌شود تاریخچه شامل همهٔ لایه‌های ایمیج نباشد -- و در نتیجه موجب سردرگمی ابزارهایی خواهد شد که به تاریخچهٔ ایمیج نگاه می‌کنند.\fP

.PP
\fB--history.comment\fP=\fIcomment\fP
  توضیح برای مدخل تاریخچهٔ متناظر با این تغییر ایمیج. در صورت نامشخص بودن، \fBumoci\fP(1) یک مقدار وابسته به پیاده‌سازی تولید خواهد کرد.

.PP
\fB--history.created_by\fP=\fIcreated_by\fP
  مدخل CreatedBy برای مدخل تاریخچهٔ متناظر با این تغییر ایمیج. در صورت نامشخص بودن، \fBumoci\fP(1) یک مقدار وابسته به پیاده‌سازی تولید خواهد کرد.

.PP
\fB--history.author\fP=\fIauthor\fP
  مقدار نویسنده برای مدخل تاریخچهٔ متناظر با این تغییر ایمیج. در صورت نامشخص بودن، این مقدار برابر با مقدار نویسندهٔ ایمیج \fBپس از\fP اعمال هرگونه تغییر توسط این فراخوانی از \fBumoci-config\fP(1) خواهد بود.

.PP
\fB--history-created\fP=\fIdate\fP
  تاریخ ایجاد برای مدخل تاریخچهٔ متناظر با این تغییرات ایمیج. این مقدار باید یک مهرزمانی با قالب ISO8601 باشد (به \fBdate\fP(1) مراجعه کنید). در صورت نامشخص بودن، از زمان فعلی استفاده می‌شود.

.PP
\fB--refresh-bundle\fP
  مشخص می‌کند که آیا فراداده‌های باندل OCI (یعنی فراداده‌های mtree و umoci) پس از بسته‌بندی مجدد ایمیج به‌روزرسانی شوند یا خیر. در صورت تنظیم، وضعیت جدید باندل باید معادل استخراج برچسب ایمیج جدید باشد.


.SH "مثال‌ها (EXAMPLES)"
دستورات زیر یک ایمیج را با استفاده از \fBskopeo\fP(1) از یک رجیستری \fBdocker\fP(1) دریافت کرده، آن را با \fBumoci-unpack\fP(1) استخراج کرده، تغییر داده و سپس مجدداً بسته‌بندی می‌کنند.

.EX
% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
# umoci unpack --image image bundle
# touch bundle/rootfs/a_new_file
# umoci repack --image image:new-42.2 bundle
.EE


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