summaryrefslogtreecommitdiff
path: root/containers-certs.d.5.md
diff options
context:
space:
mode:
authorCoprDistGit <infra@openeuler.org>2024-08-01 13:50:14 +0000
committerCoprDistGit <infra@openeuler.org>2024-08-01 13:50:14 +0000
commita7b070da3f7c537bae5eeb3cf0d236dd8640fc1e (patch)
tree756e04672089b21afa9f7330becc8f75f3c4d37d /containers-certs.d.5.md
parent865d25d3f55c9264117653bc78695975fff558cd (diff)
automatic import of containers-commonopeneuler24.03_LTS
Diffstat (limited to 'containers-certs.d.5.md')
-rw-r--r--containers-certs.d.5.md28
1 files changed, 28 insertions, 0 deletions
diff --git a/containers-certs.d.5.md b/containers-certs.d.5.md
new file mode 100644
index 0000000..828ff76
--- /dev/null
+++ b/containers-certs.d.5.md
@@ -0,0 +1,28 @@
+% containers-certs.d 5 Directory for storing custom container-registry TLS configurations
+
+# NAME
+containers-certs.d - Directory for storing custom container-registry TLS configurations
+
+# DESCRIPTION
+A custom TLS configuration for a container registry can be configured by creating a directory under `$HOME/.config/containers/certs.d` or `/etc/containers/certs.d`.
+The name of the directory must correspond to the `host:port` of the registry (e.g., `my-registry.com:5000`).
+
+## Directory Structure
+A certs directory can contain one or more files with the following extensions:
+
+* `*.crt` files with this extensions will be interpreted as CA certificates
+* `*.cert` files with this extensions will be interpreted as client certificates
+* `*.key` files with this extensions will be interpreted as client keys
+
+Note that the client certificate-key pair will be selected by the file name (e.g., `client.{cert,key}`).
+An exemplary setup for a registry running at `my-registry.com:5000` may look as follows:
+```
+/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
+Feb 2019, Originally compiled by Valentin Rothberg <rothberg@redhat.com>