نام (NAME)

containers-certs.d - دایرکتوری ذخیره‌سازی پیکربندی‌های سفارشی TLS مخازن کانتینر

توضیحات (DESCRIPTION)

پیکربندی سفارشی TLS برای یک رجیستری کانتینر را می‌توان با ایجاد دایرکتوری به نام host رجیستری ⟨برای نمونه، `my-registry.com:5000`⟩ در یکی از مسیرهای زیر پیکربندی کرد. دایرکتوری‌ها به این ترتیب (از بیشترین اولویت به کمترین) بررسی می‌شوند:

•: هم برای حالت ریشه (rootful) و هم بدون ریشه (rootless):

•: $XDG_CONFIG_HOME/containers/certs.d/ (یا $HOME/.config/containers/certs.d/ در صورتی که XDG_CONFIG_HOME تنظیم نشده باشد)

•: برای حالت دارای دسترسی ریشه (UID == 0):

•: /etc/containers/certs.rootful.d/

•: برای حالت بدون ریشه (UID > 0):

/etc/containers/certs.rootless.d/<UID>/
/etc/containers/certs.rootless.d/

•: هم برای حالت ریشه و هم بدون ریشه:

•: /etc/containers/certs.d/

•: برای حالت دارای دسترسی ریشه (UID == 0):

•: /usr/share/containers/certs.rootful.d/

•: برای حالت بدون ریشه (UID > 0):

/usr/share/containers/certs.rootless.d/<UID>/
/usr/share/containers/certs.rootless.d/

•: هم برای حالت ریشه و هم بدون ریشه:

•: /usr/share/containers/certs.d/

•: مسیر جایگزین برای سازگاری:

•: /etc/docker/certs.d/

وجود یا عدم وجود بخش پورت باید دقیقاً با نحوه استفاده از پورت در ارجاعات تصویر مطابقت داشته باشد؛ برای نمونه، جهت تأثیر بر podman pull registry.example/foo، از دایرکتوری با نام registry.example استفاده کنید، نه registry.example:443. نام دایرکتوری registry.example:443 بر podman pull registry.example:443/foo تأثیر خواهد گذاشت.

ساختار دایرکتوری (DIRECTORY STRUCTURE)

یک دایرکتوری گواهی (certs) می‌تواند شامل یک یا چند فایل با پسوندهای زیر باشد:

*.crt فایل‌های دارای این پسوند به عنوان گواهی‌های CA تفسیر می‌شوند
*.cert فایل‌های دارای این پسوند به عنوان گواهی‌های کلاینت تفسیر می‌شوند
*.key فایل‌های دارای این پسوند به عنوان کلیدهای خصوصی کلاینت تفسیر می‌شوند

توجه داشته باشید که جفت گواهی و کلید کلاینت بر اساس نام فایل انتخاب می‌شوند (برای نمونه، client.{cert,key}). یک پیکربندی نمونه برای رجیستری در حال اجرا روی my-registry.com:5000 ممکن است به صورت زیر باشد:

/etc/containers/certs.d/    <- Certificate directory
└── my-registry.com:5000    <- Hostname[:port]
   ├── client.cert          <- Client certificate
   ├── client.key           <- Client key
   └── ca.crt               <- Certificate authority that signed the registry certificate

تاریخچه (HISTORY)

فوریه ۲۰۱۹، در ابتدا توسط Valentin Rothberg به نشانی rothberg@redhat.com گردآوری شد ⟨mailto:rothberg@redhat.com⟩