umoci(1)(#) umoci umoci(1)(#) Aleksa Sarai SEPTEMBER 2018 نام (NAME) umoci - ویرایش و اصلاح تصاویر Open Container خلاصه دستور (SYNOPSIS) umoci [--help|-h] [--version|-v] [--log={debug|info|warn|error|fatal}] [--verbose] command [args] توضیحات (DESCRIPTION) umoci ابزاری است که امکان تغییر و ویرایش سطح‌بالای چیدمان تصویر OCI (layout) و تصاویر برچسب‌خوردهٔ آن را فراهم می‌کند. هرچند umoci تلاش می‌کند جزئیات مشخصات فنی تصویر OCI را انتزاعی کند، توصیه می‌شود کاربران این ابزار مشخصات فنی ⟨https://github.com/opencontainers/image-spec⟩ را مطالعه کنند تا ایده و مفهوم کلی آن را به‌خوبی درک نمایند. umoci از این جهت منحصربه‌فرد است که در زمان نگارش این مستند، نخستین ابزاری است که امکان اصلاح دلخواه یک تصویر OCI را به‌شکلی سطح‌بالا فراهم می‌آورد (به‌گونه‌ای که تمام blobهای مختلف در تصویر OCI، هنگام انجام عملیات سطح‌بالا مانند umoci-repack(1)، همگی توسط umoci مدیریت می‌شوند). گزینه‌های عمومی (GLOBAL OPTIONS) --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. دستورها (COMMANDS) 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) را ببینید. همچنین ببینید (SEE ALSO) 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 umoci(1)(#)