.nh
.TH toolbox-create 1
.SH "نام (NAME)"
toolbox-create \- ساخت یک کانتینر جدید Toolbx

.SH "خلاصه دستور (SYNOPSIS)"
\fBtoolbox create\fP [\fI--authfile FILE\fP]
               [\fI--distro DISTRO\fP | \fI-d DISTRO\fP]
               [\fI--image NAME\fP | \fI-i NAME\fP]
               [\fI--release RELEASE\fP | \fI-r RELEASE\fP]
               [\fICONTAINER\fP]

.SH "توضیحات (DESCRIPTION)"
یک کانتینر جدید Toolbx ایجاد می‌کند. سپس می‌توانید در هر زمان از دستور \fBtoolbox enter\fR برای تعامل با کانتینر استفاده کنید.

.PP
یک کانتینر Toolbx یک کانتینر OCI است که از یک ایمیج OCI ساخته می‌شود. در Fedora، ایمیج پیش‌فرض با نام \fBfedora-toolbox:N\fR شناخته می‌شود، که در آن N نسخه انتشار سیستم میزبان است. اگر ایمیج به صورت محلی موجود نباشد، از یک رجیستری شناخته‌شده مانند \fBregistry.fedoraproject.org\fR\& دریافت (pull) می‌شود. در سایر سیستم‌عامل‌های میزبان ممکن است ایمیج‌های دیگری استفاده شوند. اگر سیستم میزبان شناسایی نشود، ایمیج Fedora استفاده خواهد شد.

.PP
این کانتینر با \fBpodman create\fR ایجاد می‌شود و نقطه ورود (entry point) آن روی \fBtoolbox init-container\fR\& تنظیم می‌گردد.

.PP
به‌طور پیش‌فرض، نام کانتینر Toolbx بر اساس ایمیج مربوط به آن تعیین می‌شود. اگر ایمیج دارای یک تگ باشد، تگ در نام کانتینر گنجانده می‌شود اما به جای دونقطه با یک خط فاصله (hyphen) جدا می‌شود. با استفاده از آرگومان CONTAINER می‌توان نام متفاوتی را اختصاص داد.

.SS "پیکربندی کانتینر"
یک کانتینر Toolbx با فراهم آوردن دسترسی به دایرکتوری خانگی کاربر، سوکت‌های Wayland و X11، شبکه (شامل Avahi)، دستگاه‌های جداشدنی (مانند حافظه‌های USB)، ژورنال systemd، کارگزار SSH، سامانه D-Bus، محدودیت‌های ulimits، دایرکتوری /dev و پایگاه داده udev و غیره، به شکلی یکپارچه با بقیه سیستم‌عامل هماهنگ می‌شود.

.PP
شناسه کاربری (user ID) و جزئیات حساب کاربری از میزبان به درون کانتینر Toolbx منتقل می‌شود، جداسازی برچسب‌های SELinux غیرفعال می‌گردد و سیستم فایل میزبان در مسیر /run/host برای کانتینر قابل دسترسی است. کانتینر در صورتی که برای استفاده از کش‌های KCM پیکربندی شده باشد، به کش اعتبارنامه‌های Kerberos میزبان نیز دسترسی دارد.

.PP
یک کانتینر Toolbx را می‌توان با برچسب \fBcom.github.containers.toolbox\fR یا فایل \fB/run/.toolboxenv\fR شناسایی کرد.

.PP
نقطه ورود کانتینر Toolbx دستور \fBtoolbox init-container\fR است که به همراه گزینه‌های ارائه‌شده به \fBpodman create\fR\&، در راه‌اندازی کانتینر نقش ایفا می‌کند.

.SS "نقطه ورود"
یکی از ویژگی‌های کلیدی کانتینرهای Toolbx نقطه ورود آن‌ها، یعنی دستور \fBtoolbox init-container\fR است.

.PP
کانتینرهای OCI ذاتاً تغییرناپذیرند. گزینه‌های پیکربندی که از طریق \fBpodman create\fR ارسال می‌شوند، در تعریف کانتینر OCI تثبیت شده و پس از آن قابل تغییر نیستند. این بدان معناست که تغییرات و بهبودهای انجام‌شده در نسخه‌های جدیدتر Toolbx نمی‌توانند بر روی کانتینرهای از پیش‌موجودِ Toolbx که با نسخه‌های قدیمی‌تر ایجاد شده‌اند اعمال شوند. با استفاده از نقطه ورود برای پیکربندی کانتینر در زمان اجرا، از این مشکل جلوگیری می‌شود.

.PP
نقطه ورود کانتینر Toolbx با اطمینان از وجود کاربری مطابق با کاربر سیستم میزبان و اعطای دسترسی \fBsudo\fR و \fBroot\fR به آن، کانتینر را متناسب با کاربر فعلی سفارشی‌سازی می‌کند.

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

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

.SH "گزینه‌ها (OPTIONS)"
\fB--authfile\fP FILE

.PP
مسیر به یک FILE حاوی اطلاعات اعتبارسنجی جهت احراز هویت در رجیستری برای ایمیج‌های خصوصی. این FILE معمولاً با استفاده از \fBpodman login\fR تنظیم می‌شود و توسط \fBpodman pull\fR برای دریافت ایمیج مورد استفاده قرار می‌گیرد.

.PP
مکان پیش‌فرض برای FILE برابر با \fB$XDG_RUNTIME_DIR/containers/auth.json\fR است و قالب آن در \fBcontainers-auth.json(5)\fR\& مشخص شده است.

.PP
\fB--distro\fP DISTRO, \fB-d\fP DISTRO

.PP
یک کانتینر Toolbx برای یک توزیع (DISTRO) سیستم‌عاملی متفاوت از میزبان ایجاد می‌کند. همراه با \fB--image\fR\& قابل استفاده نیست. باید همراه با \fB--release\fR استفاده شود، مگر اینکه DISTRO انتخاب‌شده با میزبان یکسان باشد.

.PP
\fB--image\fP NAME, \fB-i\fP NAME

.PP
تغییر NAME ایمیج استفاده‌شده برای ساخت کانتینر Toolbx. این گزینه برای ساخت کانتینرها از روی ایمیج‌های سفارشی‌سازی‌شده کاربرد دارد. همراه با \fB--distro\fR و \fB--release\fR\& قابل استفاده نیست.

.PP
اگر NAME شامل یک رجیستری نباشد، فضای ذخیره‌سازی محلی ایمیج‌ها بررسی می‌شود و اگر در آنجا موجود نباشد، از یک رجیستری راه دورِ مناسب دریافت خواهد شد.

.PP
\fB--release\fP RELEASE, \fB-r\fP RELEASE

.PP
یک کانتینر Toolbx برای یک نسخه انتشار (RELEASE) سیستم‌عاملی متفاوت از میزبان ایجاد می‌کند. همراه با \fB--image\fR\& قابل استفاده نیست.

.SH "مثال‌ها (EXAMPLES)"
.SS "ایجاد کانتینر پیش‌فرض Toolbx مطابق با سیستم‌عامل میزبان"
.EX
$ toolbox create
.EE

.SS "ایجاد کانتینر پیش‌فرض Toolbx برای Fedora 36"
.EX
$ toolbox create --distro fedora --release f36
.EE

.SS "ایجاد یک کانتینر سفارشی Toolbx از یک ایمیج سفارشی"
.EX
$ toolbox create --image bar foo
.EE

.SS "ایجاد یک کانتینر سفارشی Toolbx از یک ایمیج سفارشی خصوصی"
.EX
$ toolbox create --authfile ~/auth.json --image registry.example.com/bar
.EE

.SH "همچنین ببینید (SEE ALSO)"
\fBtoolbox(1)\fR, \fBtoolbox-init-container(1)\fR, \fBpodman(1)\fR, \fBpodman-create(1)\fR, \fBpodman-login(1)\fR, \fBpodman-pull(1)\fR, \fBcontainers-auth.json(5)\fR