Skip to content

Commit 759016e

Browse files
committed
docs: combine BareMetal and vSphere certificate scenarios
Merge Scenario 2 (BareMetal) and Scenario 3 (vSphere) into a single scenario since both platforms have identical self-signed ingress behavior and redundant proxyCA overrides. Renumber remaining scenarios accordingly. Signed-off-by: Min Zhang <minzhang@redhat.com>
1 parent e65e3ed commit 759016e

1 file changed

Lines changed: 18 additions & 27 deletions

File tree

docs/ztvp-certificates.md

Lines changed: 18 additions & 27 deletions
Original file line numberDiff line numberDiff line change
@@ -90,22 +90,28 @@ signed by a public CA.
9090
No platform override file is needed. The chart's default `values.yaml` handles
9191
this scenario out of the box.
9292

93-
### Scenario 2: Bare Metal with Self-Signed Ingress
93+
### Scenario 2: Bare Metal / vSphere with Self-Signed Ingress
9494

95-
Bare metal clusters typically use self-signed certificates for the default
96-
ingress. Since `proxyCA` is enabled by default (see Scenario 1), the ingress
97-
CA is automatically injected cluster-wide. Workloads that verify TLS on routes
98-
(e.g., ACS Central connecting to Keycloak) work without extra configuration.
95+
Bare metal and vSphere clusters typically use self-signed certificates for the
96+
default ingress. Since `proxyCA` is enabled by default (see Scenario 1), the
97+
ingress CA is automatically injected cluster-wide. Workloads that verify TLS
98+
on routes (e.g., ACS Central connecting to Keycloak) work without extra
99+
configuration.
100+
101+
**Platform overrides:**
102+
103+
* `overrides/values-ztvp-certificates-BareMetal.yaml`
104+
* `overrides/values-ztvp-certificates-VSphere.yaml`
99105

100-
**Platform override** (`overrides/values-ztvp-certificates-BareMetal.yaml`):
106+
Both contain:
101107

102108
```yaml
103109
proxyCA:
104110
enabled: true
105111
```
106112
107-
> **Note:** This override is now redundant because the chart default is
108-
> `proxyCA.enabled: true`. It is retained for clarity and backward
113+
> **Note:** These overrides are now redundant because the chart default is
114+
> `proxyCA.enabled: true`. They are retained for clarity and backward
109115
> compatibility with older chart versions.
110116

111117
**Behavior is identical to Scenario 1** -- Phases 8.5 and 8.6 run by default:
@@ -117,22 +123,7 @@ proxyCA:
117123
3. The CNO propagates the merged bundle to every node, making the ingress CA
118124
trusted system-wide for all pods without explicit volume mounts.
119125

120-
### Scenario 3: vSphere with Self-Signed Ingress
121-
122-
Identical behavior to Bare Metal. vSphere clusters also typically use
123-
self-signed ingress certificates.
124-
125-
**Platform override** (`overrides/values-ztvp-certificates-VSphere.yaml`):
126-
127-
```yaml
128-
proxyCA:
129-
enabled: true
130-
```
131-
132-
> **Note:** This override is also redundant; the chart default already enables
133-
> `proxyCA`.
134-
135-
### Scenario 4: Enterprise Custom CA
126+
### Scenario 3: Enterprise Custom CA
136127

137128
When the organization uses a private PKI (e.g., a corporate root CA that
138129
signed the cluster's ingress certificate), the administrator creates a
@@ -165,7 +156,7 @@ oc create secret generic custom-ca-bundle \
165156
3. The combined bundle contains both the custom CA and the auto-detected
166157
certificates.
167158

168-
### Scenario 5: Multiple Additional CAs
159+
### Scenario 4: Multiple Additional CAs
169160

170161
When several external CAs are needed (e.g., corporate root CA, a partner CA,
171162
and an intermediate CA), use `additionalCertificates` via the
@@ -195,7 +186,7 @@ customCA:
195186
2. All additional certificates are combined with auto-detected and custom CAs
196187
in Phase 7.
197188

198-
### Scenario 6: Image Pull Trust for Built-In Registry
189+
### Scenario 5: Image Pull Trust for Built-In Registry
199190

200191
When an image registry (e.g., Quay or the embedded OpenShift registry) is
201192
exposed behind the cluster ingress with a self-signed or internal CA, kubelet
@@ -220,7 +211,7 @@ image pulls fail with `x509: certificate signed by unknown authority`. The
220211
`additionalTrustedCA.name` to that ConfigMap.
221212
4. The Machine Config Operator rolls the trust configuration out to all nodes.
222213

223-
### Scenario 7: Custom Source Locations
214+
### Scenario 6: Custom Source Locations
224215

225216
In non-standard environments where the ingress CA or service CA are stored in
226217
different locations, `customSource` overrides the default auto-detection

0 commit comments

Comments
 (0)