umoci(1)(#) umoci umoci(1)(#)
Aleksa Sarai SEPTEMBER 2018

umoci - ویرایش و اصلاح تصاویر Open Container

umoci [--help|-h] [--version|-v] [--log={debug|info|warn|error|fatal}] [--verbose] command [args]

umoci ابزاری است که امکان تغییر و ویرایش سطح‌بالای چیدمان تصویر OCI (layout) و تصاویر برچسب‌خوردهٔ آن را فراهم می‌کند. هرچند umoci تلاش می‌کند جزئیات مشخصات فنی تصویر OCI را انتزاعی کند، توصیه می‌شود کاربران این ابزار مشخصات فنی ⟨https://github.com/opencontainers/image-spec⟩ را مطالعه کنند تا ایده و مفهوم کلی آن را به‌خوبی درک نمایند.

umoci از این جهت منحصربه‌فرد است که در زمان نگارش این مستند، نخستین ابزاری است که امکان اصلاح دلخواه یک تصویر OCI را به‌شکلی سطح‌بالا فراهم می‌آورد (به‌گونه‌ای که تمام blobهای مختلف در تصویر OCI، هنگام انجام عملیات سطح‌بالا مانند umoci-repack(1)، همگی توسط umoci مدیریت می‌شوند).

--help, -h
نمایش پیام راهنمای نحوه استفاده.

--version, -v
نمایش نسخه.

--cpu-profile=filename
تولید یک پروفایل پردازنده (CPU profile) در حین اجرای umoci و ذخیرهٔ آن در filename.
این فایل در قالب pprof زبان Go ⟨https://golang.org/pkg/runtime/pprof⟩ ذخیره می‌شود و می‌توان با استفاده از go
tool pprof یا ابزارهای مشابه آن را تحلیل کرد.

--log={debug|info|warn|error|fatal}
تنظیم سطح گزارش‌گیری (logging). مقدار پیش‌فرض "warn" است.

--verbose
نام مستعار برای --log=info.

init
ایجاد یک ساختار چیدمان (layout) جدید OCI. برای اطلاعات دقیق‌تر درباره نحوه
استفاده، umoci-init(1) را ببینید.

new
یک تصویر OCI خالی و برچسب‌خورده ایجاد می‌کند. برای اطلاعات دقیق‌تر درباره نحوه
استفاده، umoci-new(1) را ببینید.

unpack
استخراج یک تصویر برچسب‌خورده درون یک بسته زمان اجرای (runtime bundle) OCI. برای اطلاعات
دقیق‌تر درباره نحوه استفاده، umoci-unpack(1) را ببینید.

repack
بسته‌بندی مجدد یک بسته زمان اجرای OCI درون یک تصویر برچسب‌خورده. برای اطلاعات
دقیق‌تر درباره نحوه استفاده، umoci-repack(1) را ببینید.

config
پیکربندی یک تصویر OCI را تغییر می‌دهد. برای اطلاعات دقیق‌تر درباره نحوه
استفاده، umoci-config(1) را ببینید.

stat
اطلاعات وضعیت یک مانیفست تصویر را نمایش می‌دهد. برای اطلاعات دقیق‌تر درباره نحوه
استفاده، umoci-stat(1) را ببینید.

tag
یک برچسب جدید در تصویر OCI ایجاد می‌کند. برای اطلاعات دقیق‌تر درباره نحوه
استفاده، umoci-tag(1) را ببینید.

remove, rm
یک برچسب را از تصویر OCI حذف می‌کند. برای اطلاعات دقیق‌تر درباره نحوه
استفاده، umoci-remove(1) را ببینید.

list, ls
مجموعه برچسب‌های موجود در تصویر OCI را فهرست می‌کند. برای اطلاعات دقیق‌تر
درباره نحوه استفاده، umoci-list(1) را ببینید.

gc
تمام blobهای بدون ارجاع تصویر OCI را زباله‌روبی (Garbage collect) می‌کند. برای
اطلاعات دقیق‌تر درباره نحوه استفاده، umoci-gc(1) را ببینید.

umoci-init(1), umoci-new(1), umoci-unpack(1), umoci-repack(1), umoci-config(1), umoci-stat(1), umoci-tag(1), umoci-remove(1), umoci-list(1), umoci-gc(1), skopeo(1)

umoci -