نام (NAME)

containers-config - قواعد بارگذاری فایل‌های پیکربندی موتور کانتینر

توضیحات (DESCRIPTION)

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

مکان‌های جستجو (SEARCH LOCATIONS)

در مسیرهای زیر، <name> بسته به فایل پیکربندی خاص، به عنوان جای‌بان برای یکی از مقادیر containers، storage یا registries به کار می‌رود.

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

لینوکس و مک‌او‌اس (LINUX AND MACOS)

پیش‌فرض‌های سیستم:

• /usr/share/containers/<name>.conf
• /usr/share/containers/<name>.conf.d/
• /usr/share/containers/<name>.rootful.conf.d/ (تنها زمانی که UID == 0 باشد)
• /usr/share/containers/<name>.rootless.conf.d/ (تنها زمانی که UID > 0 باشد)
• /usr/share/containers/<name>.rootless.conf.d/<UID>/ (تنها زمانی که UID > 0 باشد)

تنظیمات جایگزین مدیر سیستم (Admin overrides):

• /etc/containers/<name>.conf
• /etc/containers/<name>.conf.d/
• /etc/containers/<name>.rootful.conf.d/ (تنها زمانی که UID == 0 باشد)
• /etc/containers/<name>.rootless.conf.d/ (تنها زمانی که UID > 0 باشد)
• /etc/containers/<name>.rootless.conf.d/<UID>/ (تنها زمانی که UID > 0 باشد)

تنظیمات جایگزین کاربر (User overrides):

• $XDG_CONFIG_HOME/containers/<name>.conf یا اگر $XDG_CONFIG_HOME مقداردهی نشده باشد $HOME/.config/containers/<name>.conf
• $XDG_CONFIG_HOME/containers/<name>.conf.d/ یا اگر $XDG_CONFIG_HOME مقداردهی نشده باشد $HOME/.config/containers/<name>.conf.d/

فری‌بی‌اس‌دی (FREEBSD)

پیش‌فرض‌های سیستم:

• /usr/local/share/containers/<name>.conf
• /usr/local/share/containers/<name>.conf.d/
• /usr/local/share/containers/<name>.rootful.conf.d/ (تنها زمانی که UID == 0 باشد)
• /usr/local/share/containers/<name>.rootless.conf.d/ (تنها زمانی که UID > 0 باشد)
• /usr/local/share/containers/<name>.rootless.conf.d/<UID>/ (تنها زمانی که UID > 0 باشد)

تنظیمات جایگزین مدیر سیستم:

• /usr/local/etc/containers/<name>.conf
• /usr/local/etc/containers/<name>.conf.d/
• /usr/local/etc/containers/<name>.rootful.conf.d/ (تنها زمانی که UID == 0 باشد)
• /usr/local/etc/containers/<name>.rootless.conf.d/ (تنها زمانی که UID > 0 باشد)
• /usr/local/etc/containers/<name>.rootless.conf.d/<UID>/ (تنها زمانی که UID > 0 باشد)

تنظیمات جایگزین کاربر:

• $XDG_CONFIG_HOME/containers/<name>.conf یا اگر $XDG_CONFIG_HOME مقداردهی نشده باشد $HOME/.config/containers/<name>.conf
• $XDG_CONFIG_HOME/containers/<name>.conf.d/ یا اگر $XDG_CONFIG_HOME مقداردهی نشده باشد $HOME/.config/containers/<name>.conf.d/

ویندوز (WINDOWS)

هیچ مکانی برای پیش‌فرض‌های سیستمی وجود ندارد.

تنظیمات جایگزین مدیر سیستم:

• %ProgramData%\containers\<name>.conf
• %ProgramData%\containers\<name>.conf.d\

تنظیمات جایگزین کاربر:

• %APPDATA%\containers\<name>.conf
• %APPDATA%\containers\<name>.conf.d\

ترتیب بارگذاری (LOAD ORDER)

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

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

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

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

مثال‌ها (EXAMPLES)

field_1 = a

field_2 = b

field_3 = c

field_4 = d

field_5 = e

# empty

field_4 = user
field_6 = f

field_2 = b
field_4 = d
field_5 = e
field_6 = f

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

containers.conf(5), containers-storage.conf(5), containers-registries.conf(5)