.nh
.TH containers-config 5 "راهنمای پیکربندی کانتینرها" "Containers" "راهنمای لینوکس"

.SH "نام (NAME)"
containers-config \- قواعد بارگذاری فایل‌های پیکربندی موتور کانتینر


.SH "توضیحات (DESCRIPTION)"
این سند ترتیب بارگذاری فایل‌های \fBcontainers.conf(5)\fP،
\fBcontainers-storage.conf(5)\fP و
\fBcontainers-registries.conf(5)\fP را شرح می‌دهد.
برای جزئیات بیشتر در مورد ساختار این فایل‌ها به صفحات راهنمای اختصاصی آن‌ها مراجعه کنید.


.SH "مکان‌های جستجو (SEARCH LOCATIONS)"
در مسیرهای زیر، \fB<name>\fR بسته به فایل پیکربندی خاص، به عنوان جای‌بان برای یکی از مقادیر \fBcontainers\fR، \fBstorage\fR یا \fBregistries\fR به کار می‌رود.

.PP
مسیرها به ترتیب از کمترین تا بیشترین اولویت فهرست شده‌اند (یعنی مسیرهای بعدی بر مسیرهای قبلی اولویت داشته و تنظیمات آن‌ها را بازنویسی می‌کنند؛ برای جزئیات به بخش‌های پایین مراجعه فرمایید).

.SH "لینوکس و مک‌او‌اس (LINUX AND MACOS)"
پیش‌فرض‌های سیستم:
.IP \(bu 2
\fB/usr/share/containers/<name>.conf\fR
.IP \(bu 2
\fB/usr/share/containers/<name>.conf.d/\fR
.IP \(bu 2
\fB/usr/share/containers/<name>.rootful.conf.d/\fR (تنها زمانی که UID == 0 باشد)
.IP \(bu 2
\fB/usr/share/containers/<name>.rootless.conf.d/\fR (تنها زمانی که UID > 0 باشد)
.IP \(bu 2
\fB/usr/share/containers/<name>.rootless.conf.d/<UID>/\fR (تنها زمانی که UID > 0 باشد)

.PP
تنظیمات جایگزین مدیر سیستم (Admin overrides):
.IP \(bu 2
\fB/etc/containers/<name>.conf\fR
.IP \(bu 2
\fB/etc/containers/<name>.conf.d/\fR
.IP \(bu 2
\fB/etc/containers/<name>.rootful.conf.d/\fR (تنها زمانی که UID == 0 باشد)
.IP \(bu 2
\fB/etc/containers/<name>.rootless.conf.d/\fR (تنها زمانی که UID > 0 باشد)
.IP \(bu 2
\fB/etc/containers/<name>.rootless.conf.d/<UID>/\fR (تنها زمانی که UID > 0 باشد)

.PP
تنظیمات جایگزین کاربر (User overrides):
.IP \(bu 2
\fB$XDG_CONFIG_HOME/containers/<name>.conf\fR یا اگر \fB$XDG_CONFIG_HOME\fR مقداردهی نشده باشد \fB$HOME/.config/containers/<name>.conf\fR
.IP \(bu 2
\fB$XDG_CONFIG_HOME/containers/<name>.conf.d/\fR یا اگر \fB$XDG_CONFIG_HOME\fR مقداردهی نشده باشد \fB$HOME/.config/containers/<name>.conf.d/\fR

.SH "فری‌بی‌اس‌دی (FREEBSD)"
پیش‌فرض‌های سیستم:
.IP \(bu 2
\fB/usr/local/share/containers/<name>.conf\fR
.IP \(bu 2
\fB/usr/local/share/containers/<name>.conf.d/\fR
.IP \(bu 2
\fB/usr/local/share/containers/<name>.rootful.conf.d/\fR (تنها زمانی که UID == 0 باشد)
.IP \(bu 2
\fB/usr/local/share/containers/<name>.rootless.conf.d/\fR (تنها زمانی که UID > 0 باشد)
.IP \(bu 2
\fB/usr/local/share/containers/<name>.rootless.conf.d/<UID>/\fR (تنها زمانی که UID > 0 باشد)

.PP
تنظیمات جایگزین مدیر سیستم:
.IP \(bu 2
\fB/usr/local/etc/containers/<name>.conf\fR
.IP \(bu 2
\fB/usr/local/etc/containers/<name>.conf.d/\fR
.IP \(bu 2
\fB/usr/local/etc/containers/<name>.rootful.conf.d/\fR (تنها زمانی که UID == 0 باشد)
.IP \(bu 2
\fB/usr/local/etc/containers/<name>.rootless.conf.d/\fR (تنها زمانی که UID > 0 باشد)
.IP \(bu 2
\fB/usr/local/etc/containers/<name>.rootless.conf.d/<UID>/\fR (تنها زمانی که UID > 0 باشد)

.PP
تنظیمات جایگزین کاربر:
.IP \(bu 2
\fB$XDG_CONFIG_HOME/containers/<name>.conf\fR یا اگر \fB$XDG_CONFIG_HOME\fR مقداردهی نشده باشد \fB$HOME/.config/containers/<name>.conf\fR
.IP \(bu 2
\fB$XDG_CONFIG_HOME/containers/<name>.conf.d/\fR یا اگر \fB$XDG_CONFIG_HOME\fR مقداردهی نشده باشد \fB$HOME/.config/containers/<name>.conf.d/\fR

.SH "ویندوز (WINDOWS)"
هیچ مکانی برای پیش‌فرض‌های سیستمی وجود ندارد.

.PP
تنظیمات جایگزین مدیر سیستم:
.IP \(bu 2
\fB%ProgramData%\\containers\\<name>.conf\fR
.IP \(bu 2
\fB%ProgramData%\\containers\\<name>.conf.d\\\fR

.PP
تنظیمات جایگزین کاربر:
.IP \(bu 2
\fB%APPDATA%\\containers\\<name>.conf\fR
.IP \(bu 2
\fB%APPDATA%\\containers\\<name>.conf.d\\\fR


.SH "ترتیب بارگذاری (LOAD ORDER)"
مکان‌های جستجو به دو دسته فایل تقسیم می‌شوند: فایل‌های اصلی و دایرکتوری‌های افزونه (drop-in).

.PP
تنها یک فایل اصلی، یعنی \fB<name>.conf\fR، بارگذاری خواهد شد: فایلی که بالاترین اولویت را داشته و وجود خارجی داشته باشد.
اگر هیچ فایل \fB<name>.conf\fR وجود نداشته باشد، هیچ فایل اصلی بارگذاری نمی‌شود که این مورد نیز معتبر است.

.PP
پس از فایل اصلی، دایرکتوری‌های افزونه بارگذاری می‌شوند. هر فایل می‌تواند تنظیمات مشخص‌شده در فایل‌های قبلی را بازنویسی کند. فایل‌های درون این دایرکتوری‌ها باید حتماً دارای پسوند \fB\&.conf\fR باشند، در غیر این صورت نادیده گرفته می‌شوند.

.PP
تمامی فایل‌های درون دایرکتوری‌های افزونه به ترتیب لغت‌نگاری (الفبایی) نام فایل مرتب می‌شوند. اگر دو یا چند فایل با نام یکسان وجود داشته باشند، تنها فایلی که دارای بالاترین اولویت است استفاده شده و بنابراین جایگزین فایل پیشین می‌شود.


.SH "مثال‌ها (EXAMPLES)"
.SS "مثال ۱ (Example 1)"
.IP \(bu 2
~~\fB/usr/share/containers/containers.conf\fR~~ (توسط \fB$XDG_CONFIG_HOME/containers/containers.conf\fR جایگزین شده و در نتیجه خوانده نمی‌شود)
.IP \(bu 2
\fB$XDG_CONFIG_HOME/containers/containers.conf\fR
.IP \(bu 2
\fB/usr/share/containers/containers.conf.d/00-vendor.conf\fR
.IP \(bu 2
~~\fB/etc/containers/containers.conf.d/50-myconf.conf\fR~~ (توسط \fB$XDG_CONFIG_HOME/containers/containers.conf.d/50-myconf.conf\fR جایگزین شده و در نتیجه خوانده نمی‌شود)
.IP \(bu 2
\fB$XDG_CONFIG_HOME/containers/containers.conf.d/50-myconf.conf\fR
.IP \(bu 2
\fB/usr/share/containers/containers.conf.d/99-conf.conf\fR

.SS "مثال ۲ (Example 2)"
فایل‌های زیر را به همراه محتویات آن‌ها در نظر بگیرید:

.PP
~~\fB/usr/share/containers/containers.conf\fR~~ (توسط \fB/etc/containers/containers.conf\fR بازنویسی شده است):

.EX
field_1 = a
.EE

.PP
\fB/etc/containers/containers.conf\fR:

.EX
field_2 = b
.EE

.PP
~~\fB/usr/share/containers/containers.conf.d/10-vendor.conf\fR~~ (توسط \fB$XDG_CONFIG_HOME/containers/containers.conf.d/10-vendor.conf\fR بازنویسی شده است):

.EX
field_3 = c
.EE

.PP
\fB/usr/share/containers/containers.conf.d/99-important.conf\fR:

.EX
field_4 = d
.EE

.PP
\fB/usr/share/containers/containers.rootless.conf.d/50-my.conf\fR:

.EX
field_5 = e
.EE

.PP
\fB$XDG_CONFIG_HOME/containers/containers.conf.d/10-vendor.conf\fR:

.EX
# empty
.EE

.PP
\fB$XDG_CONFIG_HOME/containers/containers.conf.d/33-opt.conf\fR (این فایل خوانده می‌شود اما مقدار field_4 توسط \fB/usr/share/containers/containers.conf.d/99-important.conf\fR بازنویسی می‌شود زیرا \fB99-important.conf\fR به دلیل نام فایل، دیرتر مرتب می‌شود):

.EX
field_4 = user
field_6 = f
.EE

.PP
اکنون تجزیه این موارد به عنوان کاربری با شناسه UID 1000 منجر به این پیکربندی نهایی می‌شود:

.EX
field_2 = b
field_4 = d
field_5 = e
field_6 = f
.EE


.SH "همچنین ببینید (SEE ALSO)"
\fBcontainers.conf(5)\fP,
\fBcontainers-storage.conf(5)\fP,
\fBcontainers-registries.conf(5)\fP