نام (NAME)

containers-storage - مدیریت فضای ذخیره‌سازی لایه‌ها، ایمیج‌ها و کانتینرها

خلاصه دستور (SYNOPSIS)

containers-storage [subcommand] [--help]

توضیحات (DESCRIPTION)

دستور containers-storage یک رابط کاربری برای کتابخانه containers/storage است. اگرچه می‌توان از آن برای مدیریت مستقیم فضای ذخیره‌سازی لایه‌های سیستم‌فایل، ایمیج‌ها و کانتینرها استفاده کرد، اما کاربردهای اصلی آن حول عیب‌یابی و پرس‌وجو از وضعیت فضای ذخیره‌سازی است که توسط سایر فرایندها مدیریت می‌شود.

از نظر مفهومی، یک لایه کامل سیستم‌فایل از یک سیستم‌فایل کانتینر و مقداری اطلاعات مدیریتی و دفتری تشکیل شده است. لایه‌های دیگر، یعنی فرزندان آن لایه، به‌طور پیش‌فرض محتوای آن را به اشتراک می‌گذارند، اما هرگونه تغییر اعمال‌شده در محتوای فرزندان در لایه والد منعکس نمی‌شود. این چیدمان برای صرفه‌جویی در فضای دیسک در نظر گرفته شده است: با ذخیره لایه فرزند تنها به‌صورت مجموعه‌ای از تغییرات نسبت به والد خود، نیازی به تکرار محتوای والد برای هر یک از فرزندانش نخواهد بود. البته هر فرزند می‌تواند فرزندان خود را داشته باشد. محتوای لایه‌های والد نباید تغییر یابد.

یک ایمیج ارجاعی به یک لایه خاص به همراه مقداری اطلاعات دفتری است. احتمالاً این ایمیج به لایه‌ای اشاره دارد که احتمالاً در چندین مرحله از یک لایه والد عمومی تغییر یافته است تا برای اجرای یک برنامه مورد نظر مناسب باشد. چندین ایمیج می‌توانند به یک لایه واحد ارجاع دهند، در حالی که فقط در اطلاعات دفتری اضافی که با خود حمل می‌کنند تفاوت دارند. محتوای ایمیج‌ها باید فقط‌خواندنی در نظر گرفته شود.

یک کانتینر در واقع یک لایه است که فرزند لایه‌ای محسوب می‌شود که یک ایمیج به آن ارجاع می‌دهد (به عبارت دیگر، یک کانتینر از یک ایمیج نمونه‌سازی می‌شود)، به همراه مقداری اطلاعات دفتری. آن‌ها فاقد فرزند هستند و لایه‌های آن‌ها نمی‌تواند مستقیماً مورد ارجاع ایمیج‌ها قرار گیرد. این امر تضمین می‌کند که تغییرات در محتوای لایه یک کانتینر بر سایر ایمیج‌ها یا لایه‌ها تأثیر نمی‌گذارد، بنابراین آن‌ها قابل نوشتن در نظر گرفته می‌شوند.

تمام لایه‌ها، ایمیج‌ها و کانتینرها می‌توانند دارای متاداده‌هایی باشند که containers-storage آن‌ها را مدیریت کرده و به آن‌ها ضمیمه می‌کند. عموماً انتظار نمی‌رود که این متاداده‌ها حجیم باشند، زیرا در حافظه رم کش می‌شوند.

ایمیج‌ها و کانتینرها همچنین می‌توانند دارای اقلام داده‌ای با نام‌های دلخواه باشند. به‌طور کلی این داده‌ها می‌توانند بزرگ‌تر از متاداده باشند و در حافظه نگهداری نمی‌شوند مگر در هنگام بازیابی یا نوشتن.

انتظار می‌رود امضاهایی که می‌توانند برای تأیید صحت محتوای یک ایمیج استفاده شوند، به‌عنوان اقلام داده برای آن ایمیج ذخیره گردند، به همراه هرگونه داده پیکربندی قالبی که برای استفاده در کانتینرهای مشتق‌شده از آن ایمیج توصیه می‌شود. همچنین انتظار می‌رود که پیکربندی زمان اجرای یک کانتینر به‌صورت اقلام داده ذخیره شود.

زیردستورات (SUB-COMMANDS)

ویژگی‌های دستور containers-storage به چندین زیردستور تقسیم می‌شود:
containers-storage add-names(1) افزودن نام یا نام‌ها به لایه، ایمیج یا کانتینر

containers-storage applydiff(1) اعمال یک diff روی یک لایه

containers-storage applydiff-using-staging-dir(1) اعمال diff روی لایه با قرار دادن محتوای جدید در مرحله میانی ابتدا

containers-storage changes(1) مقایسه دو لایه

containers-storage check(1) بررسی و احتمالاً حذف لایه‌ها/ایمیج‌ها/کانتینرهای آسیب‌دیده

containers-storage container(1) بررسی یک کانتینر

containers-storage containers(1) فهرست کردن کانتینرها

containers-storage create-container(1) ایجاد کانتینر جدید از یک ایمیج

containers-storage create-image(1) ایجاد یک ایمیج جدید با استفاده از لایه‌ها

containers-storage create-layer(1) ایجاد یک لایه جدید

containers-storage create-storage-layer(1) ایجاد لایه جدید در درایور ذخیره‌سازی سطح پایین‌تر

containers-storage delete(1) حذف یک لایه، ایمیج یا کانتینر بدون بررسی‌های ایمنی

containers-storage delete-container(1) حذف یک کانتینر همراه با بررسی‌های ایمنی

containers-storage delete-image(1) حذف یک ایمیج همراه با بررسی‌های ایمنی

containers-storage delete-layer(1) حذف یک لایه همراه با بررسی‌های ایمنی

containers-storage diff(1) مقایسه دو لایه

containers-storage diffsize(1) مقایسه دو لایه از نظر اندازه

containers-storage exists(1) بررسی وجود داشتن لایه، ایمیج یا کانتینر

containers-storage get-container-data(1) دریافت داده‌های پیوست‌شده به یک کانتینر

containers-storage get-image-data(1) دریافت داده‌های پیوست‌شده به یک ایمیج

containers-storage image(1) بررسی یک ایمیج

containers-storage images(1) فهرست کردن ایمیج‌ها

containers-storage layers(1) فهرست کردن لایه‌ها

containers-storage list-container-data(1) فهرست کردن اقلام داده پیوست‌شده به یک کانتینر

containers-storage list-image-data(1) فهرست کردن اقلام داده پیوست‌شده به یک ایمیج

containers-storage metadata(1) بازیابی متاداده لایه، ایمیج یا کانتینر

containers-storage mount(1) سوار کردن (مانت) یک لایه یا کانتینر

containers-storage mounted(1) بررسی مانت بودن یک سیستم‌فایل

containers-storage set-container-data(1) تنظیم داده‌های پیوست‌شده به یک کانتینر

containers-storage set-image-data(1) تنظیم داده‌های پیوست‌شده به یک ایمیج

containers-storage set-metadata(1) تنظیم متاداده لایه، ایمیج یا کانتینر

containers-storage set-names(1) تنظیم نام یا نام‌های لایه، ایمیج یا کانتینر

containers-storage shutdown(1) خاموش کردن درایور گراف

containers-storage status(1) بررسی وضعیت درایور گراف

containers-storage unmount(1) پیاده کردن (آن‌مانت) یک لایه یا کانتینر

containers-storage unshare(1) اجرای یک دستور در یک فضای نام کاربر (user namespace)

containers-storage version(1) بازگرداندن اطلاعات نسخه containers-storage

containers-storage wipe(1) پاک‌سازی کامل تمام لایه‌ها، ایمیج‌ها و کانتینرها

گزینه‌ها (OPTIONS)

--help

چاپ فهرست زیردستورات موجود. در صورت مشخص شدن یک زیردستور، اطلاعات مربوط به آن دستور ارائه می‌شود.

--debug, -D

افزایش میزان اطلاعات اشکال‌زدایی چاپ‌شده.

--graph, -g=/var/lib/containers/storage

بازنویسی ریشه درخت ذخیره‌سازی، مورداستفاده برای ذخیره محتویات لایه و اطلاعات مربوط به لایه‌ها، ایمیج‌ها و کانتینرها.

--run, -R=/run/containers/storage

بازنویسی ریشه درخت وضعیت زمان اجرا، که در حال حاضر عمدتاً برای ثبت مکانی که یک لایه خاص در آن مانت شده است استفاده می‌شود (ببینید containers-storage mount) تا بتوان آن را به‌جای شناسه یا نام، از طریق مسیر پیاده (آن‌مانت) کرد.

--storage-driver, -s

مشخص می‌کند کدام درایور ذخیره‌سازی استفاده شود. اگر تنظیم نشده باشد ولی $STORAGE_DRIVER در محیط تعریف شده باشد، مقدار آن استفاده می‌شود. اگر درخت ذخیره‌سازی قبلاً مقداردهی اولیه شده باشد، نیازی به ارائه هیچ‌یک نیست. اگر درخت قبلاً مقداردهی نشده و هیچ‌کدام تنظیم نشده باشد، مقدار پیش‌فرض سخت‌کدشده انتخاب می‌شود.

--storage-opt=[]

تنظیم گزینه‌هایی که به درایور ذخیره‌سازی ارسال می‌شوند. اگر تنظیم نشده باشد اما $STORAGE_OPTS در محیط تعریف شده باشد، مقدار آن به‌عنوان یک فهرست جداشده با کاما در نظر گرفته شده و استفاده می‌شود. اگر درخت ذخیره‌سازی قبلاً مقداردهی شده باشد، نیازی به ارائه این موارد نیست.

--unshare, -U

هنگامی که توسط کاربر غیرریشه اجرا شود، در داخل یک فضای نام کاربر جدید پیکربندی‌شده با استفاده از نگاشت شناسه‌های پیش‌فرض سیستم برای کاربر غیرریشه اجرا می‌شود.

بازنویسی‌های متغیرهای محیطی (ENVIRONMENT OVERRIDES)

CONTAINERS_STORAGE_CONF

در صورت تنظیم، از مسیر فایل پیکربندی ارائه‌شده در $CONTAINERS_STORAGE_CONF به‌جای مسیر پیش‌فرض /etc/containers/storage.conf استفاده می‌کند.

مثال‌ها (EXAMPLES)

containers-storage layers -t

باگ‌ها (BUGS)

این پروژه هنوز در حال توسعه است، بنابراین ممکن است برخی قابلیت‌ها هنوز پیاده‌سازی نشده باشند و در صورت عدم نیاز، برخی حذف شوند. با این حال، اگر چیزی به‌درستی کار نمی‌کند، لطفاً آن را در بخش پیگیری اشکالات پروژه گزارش دهید ⟨https://github.com/containers/storage/issues⟩.

پاورقی‌ها (FOOTNOTES)

پروژه Containers Storage به فراگیر بودن، که یکی از ارزش‌های اصلی متن‌باز است، متعهد است. در این مخزن از اصطلاحات انتشار مانت master و slave استفاده شده است. این زبان مشکل‌ساز و تفرقه‌افکن است و باید تغییر یابد. با این حال، این اصطلاحات در حال حاضر در هسته لینوکس استفاده می‌شوند و در حال حاضر باید به همین شکل استفاده گردند. زمانی که نگه‌دارندگان هسته این کاربرد را اصلاح کنند، Containers Storage بلافاصله از آن پیروی خواهد کرد.