toolbox-init-container(1) General Commands Manual toolbox-init-container(1)

toolbox-init-container - راه‌اندازی یک کانتینر در حال اجرا

toolbox init-container --gid GID
--home HOME
--home-link
--media-link
--mnt-link
--shell SHELL
--uid UID
--user USER

یک کانتینر تازه ایجادشده که در حال اجرا است را مقداردهی اولیه (راه‌اندازی) می‌کند. هدف اصلی این دستور استفاده به عنوان نقطه ورود (entry point) برای تمام کانتینرهای Toolbx است و باید داخل کانتینری که قرار است راه‌اندازی شود اجرا گردد. انتظار نمی‌رود این دستور مستقیماً توسط کاربران فراخوانی شود و نمی‌توان آن را روی میزبان استفاده کرد.

یک ویژگی کلیدی کانتینرهای Toolbx، نقطه ورود آن‌ها یعنی دستور toolbox init-container است.

کانتینرهای OCI ذاتاً تغییرناپذیرند. گزینه‌های پیکربندی که از طریق podman create فرستاده می‌شوند، در تعریف کانتینر OCI تثبیت شده و بعداً قابل تغییر نیستند. این بدان معناست که تغییرات و بهبودهای اعمال‌شده در نسخه‌های جدیدتر Toolbx را نمی‌توان روی کانتینرهای از پیش‌موجود Toolbx که با نسخه‌های قدیمی‌تر ساخته شده‌اند اعمال کرد. برای جلوگیری از این مشکل، از نقطه ورود برای پیکربندی کانتینر در زمان اجرا (runtime) استفاده می‌شود.

نقطه ورود یک کانتینر Toolbx، کانتینر را سفارشی‌سازی می‌کند تا با کاربر فعلی سازگار شود؛ این کار از طریق اطمینان از وجود کاربری منطبق با کاربر میزبان و اعطای دسترسی‌های sudo و root به آن انجام می‌شود.

فایل‌های پیکربندی حیاتی درون کانتینر، مانند /etc/host.conf، /etc/hosts، /etc/localtime، /etc/resolv.conf و /etc/timezone همواره با سیستم میزبان همگام نگه داشته می‌شوند. همچنین نقطه ورود، بخش‌های مختلفی از سلسله‌مراتب سیستم فایل میزبان را به مکان‌های متناظرشان در داخل کانتینر متصل (bind mount) می‌کند تا یکپارچگی کاملی با میزبان فراهم شود. این بخش‌ها شامل /run/libvirt، /run/systemd/journal، /run/udev/data، /var/lib/libvirt، /var/lib/systemd/coredump، /var/log/journal و موارد دیگر می‌شود.

در برخی از سیستم‌عامل‌های میزبان، مسیرهای مهمی مانند /home، /media یا /mnt پیوندهای نمادین (symbolic links) به مکان‌های دیگر هستند. نقطه ورود تضمین می‌کند که مسیرهای درون کانتینر با مسیرهای روی میزبان مطابقت داشته باشند تا از سردرگمی‌های بیهوده جلوگیری شود.

گزینه‌های زیر پشتیبانی می‌شوند:

--gid GID

مقدار GID را به عنوان شناسه عددی گروه کاربر از سیستم میزبان به کانتینر Toolbx ارسال می‌کند.

--home HOME

کاربری در داخل کانتینر Toolbx ایجاد می‌کند که دایرکتوری ورود آن HOME است. این گزینه الزامی است.

--home-link

مسیر /home را به یک پیوند نمادین به /var/home تبدیل می‌کند.

--media-link

مسیر /media را به یک پیوند نمادین به /run/media تبدیل می‌کند.

--mnt-link

مسیر /mnt را به یک پیوند نمادین به /var/mnt تبدیل می‌کند.

--monitor-host

منسوخ شده و هیچ کاری انجام نمی‌دهد.

فایل‌های پیکربندی حیاتی داخل کانتینر Toolbx همواره با معادل‌های خود در سیستم میزبان همگام نگه داشته می‌شوند، و بخش‌های مختلفی از سلسله‌مراتب سیستم فایل میزبان همواره در مکان‌های متناظر خود درون کانتینر Toolbx متصل (bind mount) می‌گردند.

--shell SHELL

کاربری در داخل کانتینر Toolbx ایجاد می‌کند که شل ورود (login shell) آن SHELL است. این گزینه الزامی است.

--uid UID

کاربری در داخل کانتینر Toolbx ایجاد می‌کند که شناسه عددی کاربری آن UID است. این گزینه الزامی است.

--user USER

کاربری در داخل کانتینر Toolbx ایجاد می‌کند که نام ورود آن LOGIN است. این گزینه الزامی است.

toolbox(1), podman(1), podman-create(1), podman-start(1)