Skip to content

Commit 01eaa27

Browse files
committed
Address copilot comments and update 3pp versions
Signed-off-by: Fiachra Corcoran <fiachra.corcoran@est.tech>
1 parent 0dd6ce8 commit 01eaa27

2 files changed

Lines changed: 14 additions & 9 deletions

File tree

docs/config.toml

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -71,12 +71,13 @@ version = "latest"
7171
latestTag = "1.5.7"
7272

7373
# latest tested versions
74-
version_docker = "v28.1.1"
75-
version_go = "v1.25.3"
76-
version_git = "v2.51.2"
77-
version_kind = "v0.30.0"
78-
version_kube = "v1.34.2"
79-
version_kpt = "v1.0.0-beta.62.1"
74+
version_docker = "28.0.4"
75+
version_go = "1.26.3"
76+
version_git = "2.54.0"
77+
version_kind = "0.32.0"
78+
version_kube = "1.36.1"
79+
version_kpt = "1.0.0-beta.67"
80+
version_certmanager = "1.21.1"
8081

8182
# A link to latest version of the docs. Used in the "version-banner" partial to
8283
# point people to the main doc site.

docs/content/en/docs/6_configuration_and_deployments/configurations/components/porch-webhooks/cert-manager-webhooks.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,14 +13,16 @@ Self-signed certificates are generated by `scripts/webhook-utils.sh` during depl
1313

1414
The limitation of self-signed certificates is that they don't auto-rotate before expiration, which can cause webhook outages if not manually renewed.
1515

16-
## Production Setup with cert-manager
16+
## cert-manager Setup (Example)
17+
18+
This section shows a basic cert-manager setup using self-signed certificates. This approach is suitable for testing and development environments. For production deployments with organizational trust requirements, use a CA-backed issuer or ACME provider instead.
1719

1820
Use cert-manager for automatic certificate management:
1921

2022
1. **Install cert-manager** (if not already installed):
2123

2224
```bash
23-
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.14.0/cert-manager.yaml
25+
kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v{{ .Site.Params.version_certmanager }}/cert-manager.yaml
2426
```
2527

2628
2. **Create an Issuer** that signs webhook certificates:
@@ -65,7 +67,9 @@ kubectl apply -f issuer.yaml
6567
kubectl apply -f certificate.yaml
6668
```
6769

68-
Once deployed, cert-manager automatically manages the certificate lifecycle. It creates and updates the Secret `porch-controllers-webhook-tls`, watches for expiration, rotates before renewal, and patches the caBundle into ValidatingWebhookConfiguration resources. No code changes or manual intervention required—the porch-controllers pod automatically uses the updated certificate.
70+
Once deployed, cert-manager automatically manages the certificate lifecycle. It creates and updates the Secret `porch-controllers-webhook-tls`, watches for expiration, and rotates before renewal.
71+
72+
The `caBundle` is automatically patched into ValidatingWebhookConfiguration resources when cert-manager's CA injector is enabled (via the `cert-manager.io/inject-ca-from` annotation on the webhook configuration). This requires cert-manager's cainjector component. Without it, you must manually patch the caBundle or use a webhook configuration that references the certificate directly. The porch-controllers pod automatically uses the updated certificate once it's in place.
6973

7074
## Certificate Paths
7175

0 commit comments

Comments
 (0)