.nh
.TH umoci-raw-unpack(1) # umoci raw unpack - Unpacks an OCI image tag into a root filesystem
Aleksa Sarai
SEPTEMBER 2018

.SH "نام (NAME)"
umoci raw unpack \- استخراج یک برچسب تصویر OCI در یک سیستم‌فایل ریشه


.SH "خلاصه دستور (SYNOPSIS)"
\fBumoci raw unpack\fP
[\fIگزینه‌های umoci-unpack(1)\fP]
\fIrootfs\fP


.SH "توضیحات (DESCRIPTION)"
تمام لایه‌ها را (به‌صورت قطعی) در یک سیستم‌فایل ریشه در مسیر
\fIrootfs\fP\& استخراج می‌کند. این مسیر \fIنباید\fP از قبل وجود داشته باشد.


.SH "گزینه‌ها (OPTIONS)"
گزینه‌های عمومی در \fBumoci\fP(1) تعریف شده‌اند، در حالی که گزینه‌های این
زیرفرمان خاص همانند \fBumoci-unpack\fP(1) هستند؛ با این استثنا که به جای
مسیر \fIbundle\fP، مسیر \fIrootfs\fP ارائه می‌شود.


.SH "مثال‌ها (EXAMPLES)"
دستورهای زیر با استفاده از \fBskopeo\fP(1) تصویری را از یک رجیستری \fBdocker\fP(1)
دریافت کرده، تصویر مذکور را در یک سیستم‌فایل ریشه استخراج می‌کند، یک فایل
پیکربندی زمان اجرای OCI با \fBumoci-raw-runtime-config\fP(1) تولید کرده و سپس
یک کانتینر جدید با \fBrunc\fP(8) ایجاد می‌نماید.

.EX
% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
# umoci raw unpack --image image rootfs
# umoci raw runtime-config --image image --rootfs rootfs config.json
# runc run ctr
[ container session ]
.EE

.PP
با استفاده از \fB--rootless\fP همچنین می‌توان مثال بالا را بدون دسترسی‌های ریشه
انجام داد. \fBumoci\fP پیکربندی‌ای تولید خواهد کرد که با کانتینرهای بدون ریشه
(rootless) در \fBrunc\fP(8) کار می‌کند.

.EX
% skopeo copy docker://opensuse/amd64:42.2 oci:image:latest
% umoci raw unpack --image image --rootless rootfs
% umoci raw runtime-config --image image --rootfs rootfs --rootless config.json
% runc --root $HOME/runc run ctr
[ rootless container session ]
.EE


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