Skip to content

Commit c659f6c

Browse files
authored
chore: Fix omporting certificate article (#2899)
Signed-off-by: Anatolii Bazko <abazko@redhat.com>
1 parent 822d059 commit c659f6c

File tree

1 file changed

+20
-9
lines changed

1 file changed

+20
-9
lines changed

modules/administration-guide/pages/importing-untrusted-tls-certificates.adoc

Lines changed: 20 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -20,10 +20,21 @@ The ConfigMaps can have an arbitrary amount of keys with a random amount of cert
2020
All certificates are mounted into:
2121

2222
* `/public-certs` location of {prod-short} server and dashboard pods
23-
* `/public-certs` and `/etc/pki/ca-trust/extracted/pem` locations of workspaces pods
23+
* `/etc/pki/ca-trust/extracted/pem` locations of workspaces pods
2424

25-
The `/etc/pki/ca-trust/extracted/pem` directory is where the system stores extracted CA certificates for trusted certificate authorities on Red Hat (e.g., CentOS, Fedora). CLI tools automatically use certificates from the system-trusted locations, when the user's workspace is up and running.
25+
Configure the `CheCluster` custom resource to disable CA bundle mounting at `/etc/pki/ca-trust/extracted/pem`. The certificates will instead be mounted at `/public-certs` to keep the behaviour from the previous version.
2626

27+
[NOTE]
28+
====
29+
Configure the `CheCluster` Custom Resource in order to disable the mounting of the CA bundle under the path `/etc/pki/ca-trust/extracted/pem`. Certificates will be mounted under the path `/public-certs` in this case.
30+
[source,yaml]
31+
----
32+
spec:
33+
devEnvironments:
34+
trustedCerts:
35+
disableWorkspaceCaBundleMount: true
36+
----
37+
====
2738
[IMPORTANT]
2839
====
2940
On OpenShift cluster, {prod-short} operator automatically adds Red Hat Enterprise Linux CoreOS (RHCOS) trust bundle into mounted certificates.
@@ -76,7 +87,7 @@ This command returns CA bundle certificates in PEM format:
7687
+
7788
[subs="+attributes,+quotes",options="nowrap",role=white-space-pre]
7889
----
79-
$ {orch-cli} get configmap \
90+
{orch-cli} get configmap \
8091
--namespace={prod-namespace} \
8192
--output='jsonpath={.items[0:].data.custom-ca-certificates\.pem}' \
8293
--selector=app.kubernetes.io/component=ca-bundle,app.kubernetes.io/part-of=che.eclipse.org
@@ -86,7 +97,7 @@ $ {orch-cli} get configmap \
8697
+
8798
[subs="+attributes,+quotes",options="nowrap",role=white-space-pre]
8899
----
89-
$ {orch-cli} logs deploy/{prod-id-short} --namespace={prod-namespace} \
100+
{orch-cli} logs deploy/{prod-id-short} --namespace={prod-namespace} \
90101
| grep tls-ca-bundle.pem
91102
----
92103

@@ -97,7 +108,7 @@ This command returns {prod-short} CA bundle certificates in PEM format:
97108
+
98109
[subs="+attributes,+quotes",options="nowrap",role=white-space-pre]
99110
----
100-
$ {orch-cli} get configmap che-trusted-ca-certs \
111+
{orch-cli} get configmap che-trusted-ca-certs \
101112
--namespace=__<workspace_namespace>__ \
102113
--output='jsonpath={.data.tls-ca-bundle\.pem}'
103114
----
@@ -106,7 +117,7 @@ $ {orch-cli} get configmap che-trusted-ca-certs \
106117
+
107118
[subs="+attributes,+quotes",options="nowrap",role=white-space-pre]
108119
----
109-
$ {orch-cli} get pod \
120+
{orch-cli} get pod \
110121
--namespace=__<workspace_namespace>__ \
111122
--selector='controller.devfile.io/devworkspace_name=__<workspace_name>__' \
112123
--output='jsonpath={.items[0:].spec.volumes[0:].configMap.name}' \
@@ -117,7 +128,7 @@ $ {orch-cli} get pod \
117128
+
118129
[subs="+attributes,+quotes",options="nowrap",role=white-space-pre]
119130
----
120-
$ {orch-cli} get pod \
131+
{orch-cli} get pod \
121132
--namespace=__<workspace_namespace>__ \
122133
--selector='controller.devfile.io/devworkspace_name=__<workspace_name>__' \
123134
--output='jsonpath={.items[0:].metadata.name}' \
@@ -128,9 +139,9 @@ This command returns {prod-short} CA bundle certificates in PEM format:
128139
+
129140
[subs="+attributes,+quotes",options="nowrap",role=white-space-pre]
130141
----
131-
$ {orch-cli} exec __<workspace_pod_name>__ \
142+
{orch-cli} exec __<workspace_pod_name>__ \
132143
--namespace=__<workspace_namespace>__ \
133-
-- cat /public-certs/tls-ca-bundle.pem
144+
-- cat /etc/pki/ca-trust/extracted/pem/tls-ca-bundle.pem
134145
----
135146

136147
.Additional resources

0 commit comments

Comments
 (0)