نام (NAME)

syd-oci - رابط کانتینری سازگار با OCI برای جعبه‌شنی syd

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

syd-oci [OPTIONS] [COMMAND]

توضیحات (DESCRIPTION)

ابزار syd-oci یک پیاده‌سازی از زمان اجرای کانتینر OCI برای syd(1) است.

از تمامی زیردستورهای متداول پشتیبانی می‌شود: create، start، state، kill، delete، pause، resume، exec، run، list، ps، spec، events، features، update. پشتیبانی از نقطه بررسی/بازیابی (checkpoint/restore) در آینده نزدیک برنامه‌ریزی شده است. برای اطلاعات بیشتر، به موضوع مربوطه در youki در نشانی https://github.com/youki-dev/youki/issues/142 مراجعه کنید.

یکپارچه‌سازی (INTEGRATION)

ابزار syd-oci یک پوشش سبک پیرامون youki(1) است که جعبه‌شنی syd(1) را درون کانتینرها یکپارچه می‌سازد. این ابزار با docker(1) و podman(1) سازگار است. برای داشتن syd-oci، باید syd(1) را با قابلیت oci کامپایل کنید. برای استفاده از syd-oci با docker(1) دو گزینه دارید: یا dockerd(8) را به‌صورت دستی با گزینه --add-runtime=syd-oci=/bin/syd-oci راه‌اندازی کنید و هنگام شروع کانتینرها به عنوان مثال دستور docker run -it --runtime=syd-oci alpine را اجرا کنید، یا قطعه کد زیر را به فایل /etc/docker/daemon.json خود بیفزایید:

{
"runtimes": { "syd-oci": { "path": "/bin/syd-oci" } },
"default-runtime": "syd-oci"
}

ممکن است بسته به نحوه نصب خود نیاز داشته باشید مسیر syd-oci را تنظیم کنید. استفاده با podman(1) نیز مشابه است، کافی است --runtime=/bin/syd-oci را به عنوان یک گزینه به podman run ارسال کنید.

پیکربندی (CONFIGURATION)

دایرکتوری پیکربندی syd-oci یکی از موارد زیر است:

برای کانتینرهای سراسری سیستم: /etc/syd/oci
برای کانتینرهای بدون ریشه (rootless)، یکی از موارد زیر:
- ${XDG_CONFIG_HOME}/syd/oci که در آن XDG_CONFIG_HOME معمولاً ~/.config است.
- ${HOME}/.syd/oci اگر XDG_CONFIG_HOME تنظیم نشده باشد.

ابزار syd-oci تلاش می‌کند تا جعبه‌شنی syd(1) را به ترتیب زیر پیکربندی کند، و اولین فایل یا نمایه (profile) یافت‌شده را تجزیه کرده و پردازش را متوقف می‌کند؛ می‌توان متغیر محیطی SYD_OCI_NO_CONFIG را برای پرش به مرحله نهایی تنظیم کرد:

اگر hostname و domainname برای کانتینر تعریف شده باشند، تلاش برای بارگذاری ${SYD_CONFIG_DIR}/${hostname}.${domainname}.syd-3.
اگر domainname برای کانتینر تعریف شده باشد، تلاش برای بارگذاری ${SYD_CONFIG_DIR}/${domainname}.syd-3.
اگر hostname برای کانتینر تعریف شده باشد، تلاش برای بارگذاری ${SYD_CONFIG_DIR}/${hostname}.syd-3.
تلاش برای بارگذاری ${SYD_CONFIG_DIR}/default.syd-3
بارگذاری نمایه توکار oci. این نمایه برای ترکیب با pandora(1) و حالت یادگیری طراحی شده است. برای مشاهده فهرست قوانین به syd-cat -p oci مراجعه کنید.

عبارت SYD_CONFIG_DIR در موارد بالا به دایرکتوری پیکربندی اشاره دارد. برای آگاهی از نحو فایل‌های پیکربندی syd(1) به syd(5) و برای فهرستی از موارد پیکربندی که syd(1) درک می‌کند به syd(2) مراجعه کنید. یک فایل برجسته‌سازی نحو برای vim(1) نیز ارائه شده است تا ویرایش فایل‌های پیکربندی syd(1) آسان‌تر باشد. از syd-cat file.syd-3 برای بررسی خطاهای نحوی فایل پیکربندی syd(1) استفاده کنید.

پیکربندی پیدا شده عیناً در زمان create در یادداشت (annotation) کانتینر در org.exherbo.syd.config ثبت می‌شود، که پس از آن جعبه‌شنی از روی آن مقداردهی اولیه می‌گردد؛ بنابراین فرایندهای exec از قوانین جعبه‌شنی فرایند init اشتراک می‌گیرند.

در نهایت، توجه داشته باشید که دستورالعمل‌های include در فایل‌های پیکربندی syd-oci پشتیبانی نمی‌شوند. این امر برای اطمینان از این است که فرایند اصلی و فرایندهای exec قوانین جعبه‌شنی یکسانی داشته باشند.

همچنین ببینید (SEE ALSO)

syd(1), syd(2), syd(5), syd(7), pandora(1), docker(1), dockerd(8), podman(1), youki(1)

صفحه خانگی syd: https://sydbox.exherbo.org
صفحه خانگی youki: https://containers.github.io/youki

نویسندگان (AUTHORS)

نگه‌داری شده توسط Ali Polatel. سورس‌های به‌روز را می‌توان در https://gitlab.exherbo.org/sydbox/sydbox.git و روی Radicle در rad:z38HCnbmcDegA2BMxuPaPRPMdp6wF یافت. اشکالات/وصله‌ها را می‌توان به https://gitlab.exherbo.org/groups/sydbox/-/issues ارسال کرد. گفتگو در #sydbox در Libera Chat یا در #sydbox:mailstation.de در Matrix.