.nh
.TH containers-certs.d 5 "فوریه ۲۰۱۹" "Containers" "راهنمای لینوکس"

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


.SH "توضیحات (DESCRIPTION)"
پیکربندی سفارشی TLS برای یک رجیستری کانتینر را می‌توان با ایجاد دایرکتوری به نام \fBhost\fR رجیستری
\[la]برای نمونه، `my\-registry.com:5000`\[ra] در یکی از مسیرهای زیر پیکربندی کرد.
دایرکتوری‌ها به این ترتیب (از بیشترین اولویت به کمترین) بررسی می‌شوند:
.IP \(bu 2
هم برای حالت ریشه (rootful) و هم بدون ریشه (rootless):
.RS
.IP \(bu 2
\fB$XDG_CONFIG_HOME/containers/certs.d/\fR (یا \fB$HOME/.config/containers/certs.d/\fR در صورتی که \fBXDG_CONFIG_HOME\fR تنظیم نشده باشد)
.RE
.IP \(bu 2
برای حالت دارای دسترسی ریشه (UID == 0):
.RS
.IP \(bu 2
\fB/etc/containers/certs.rootful.d/\fR
.RE
.IP \(bu 2
برای حالت بدون ریشه (UID > 0):
.RS
.IP \(bu 2
\fB/etc/containers/certs.rootless.d/<UID>/\fR
.IP \(bu 2
\fB/etc/containers/certs.rootless.d/\fR
.RE
.IP \(bu 2
هم برای حالت ریشه و هم بدون ریشه:
.RS
.IP \(bu 2
\fB/etc/containers/certs.d/\fR
.RE
.IP \(bu 2
برای حالت دارای دسترسی ریشه (UID == 0):
.RS
.IP \(bu 2
\fB/usr/share/containers/certs.rootful.d/\fR
.RE
.IP \(bu 2
برای حالت بدون ریشه (UID > 0):
.RS
.IP \(bu 2
\fB/usr/share/containers/certs.rootless.d/<UID>/\fR
.IP \(bu 2
\fB/usr/share/containers/certs.rootless.d/\fR
.RE
.IP \(bu 2
هم برای حالت ریشه و هم بدون ریشه:
.RS
.IP \(bu 2
\fB/usr/share/containers/certs.d/\fR
.RE
.IP \(bu 2
مسیر جایگزین برای سازگاری:
.RS
.IP \(bu 2
\fB/etc/docker/certs.d/\fR
.RE

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

.SH "ساختار دایرکتوری (DIRECTORY STRUCTURE)"
یک دایرکتوری گواهی (certs) می‌تواند شامل یک یا چند فایل با پسوندهای زیر باشد:
.IP \(bu 2
\fB*.crt\fR  فایل‌های دارای این پسوند به عنوان گواهی‌های CA تفسیر می‌شوند
.IP \(bu 2
\fB*.cert\fR فایل‌های دارای این پسوند به عنوان گواهی‌های کلاینت تفسیر می‌شوند
.IP \(bu 2
\fB*.key\fR  فایل‌های دارای این پسوند به عنوان کلیدهای خصوصی کلاینت تفسیر می‌شوند

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

.EX
/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
.EE


.SH "تاریخچه (HISTORY)"
فوریه ۲۰۱۹، در ابتدا توسط Valentin Rothberg به نشانی rothberg@redhat.com گردآوری شد
\[la]mailto:rothberg@redhat.com\[ra]