Release notes for cert-manager v1.19.0

.spelling

@@ -325,6 +325,7 @@ literalSubject
 LiteralSubject
 LiteralSubjects
 SVIDs
+steerers
 stevehipwell
 TLDs
 TODO
@@ -494,6 +495,7 @@ OAuth
 observedGeneration
 onwards
 openshift-supported-versions
+parsable
 plaintext
 powershell
 pre
@@ -583,6 +585,8 @@ v1.18
 v1.18.0
 v1.18.0.
 v1.19
+v1.19.0
+alpha.0
 v1.5
 v1.5.0
 v1.5.0.

content/docs/cli/cainjector.md

@@ -25,7 +25,7 @@ Flags:
       --feature-gates mapStringBool                          A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
                                                              AllAlpha=true|false (ALPHA - default=false)
                                                              AllBeta=true|false (BETA - default=false)
-                                                             CAInjectorMerging=true|false (ALPHA - default=false)
+                                                             CAInjectorMerging=true|false (BETA - default=true)
                                                              ServerSideApply=true|false (ALPHA - default=false)
   -h, --help                                                 help for cainjector
       --kubeconfig string                                    Paths to a kubeconfig. Only required if out-of-cluster.

content/docs/cli/controller.md

@@ -40,6 +40,7 @@ Flags:
       --enable-profiling                                     Enable profiling for controller.
       --extra-certificate-annotations strings                Extra annotation to be added by the ingress-shim controller to certificate object
       --feature-gates mapStringBool                          A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
+                                                             ACMEHTTP01IngressPathTypeExact=true|false (BETA - default=true)
                                                              AllAlpha=true|false (ALPHA - default=false)
                                                              AllBeta=true|false (BETA - default=false)
                                                              DefaultPrivateKeyRotationPolicyAlways=true|false (BETA - default=true)

content/docs/cli/webhook.md

@@ -22,6 +22,7 @@ Flags:
       --dynamic-serving-leaf-duration duration               leaf duration of serving certificates (default 168h0m0s)
       --enable-profiling                                     Enable profiling for webhook.
       --feature-gates mapStringBool                          A set of key=value pairs that describe feature gates for alpha/experimental features. Options are:
+                                                             ACMEHTTP01IngressPathTypeExact=true|false (BETA - default=true)
                                                              AllAlpha=true|false (ALPHA - default=false)
                                                              AllBeta=true|false (BETA - default=false)
                                                              DefaultPrivateKeyRotationPolicyAlways=true|false (BETA - default=true)

content/docs/releases/README.md

@@ -21,15 +21,14 @@ should be stable enough to run.
 
 | Release  | Release Date | End of Life     | [Supported Kubernetes / OpenShift Versions][s] | [Tested Kubernetes Versions][test] |
 |:--------:|:------------:|:---------------:|:----------------------------------------------:|:----------------------------------:|
+| [1.19][] | Oct 07, 2025 | Release of 1.21 | 1.31 → 1.34 / 4.18 → 4.19                      | 1.31 → 1.34                        |
 | [1.18][] | Jun 10, 2025 | Release of 1.20 | 1.29 → 1.33   /   4.16 → 4.18                  | 1.29 → 1.33                        |
-| [1.17][] | Feb 03, 2025 | Release of 1.19 | 1.29 → 1.33   /   4.16 → 4.18                  | 1.29 → 1.32                        |
-
 
 ## Upcoming releases
 
 | Release  | Release Date | End of Life     | [Supported Kubernetes / OpenShift Versions][s] | [Tested Kubernetes Versions][test] |
 |:--------:|:------------:|:---------------:|:----------------------------------------------:|:----------------------------------:|
-| [1.19][] | Oct 7, 2025  | Release of 1.21 | 1.31 → 1.34 / 4.18 → 4.19                      | 1.31 → 1.34                        |
+| [1.20][] | Feb 10, 2026 | Release of 1.21 | 1.31 → 1.34 / 4.18 → 4.19                      | 1.31 → 1.34                        |
 
 Dates in the future are not firm commitments and are subject to change.
 
@@ -308,6 +307,7 @@ are no longer supported.
 
 | Release      | Release Date | EOL          | Compatible Kubernetes versions | Compatible OpenShift versions |
 |--------------|:------------:|:------------:|:------------------------------:|:-----------------------------:|
+| [1.17][]     | Feb 03, 2025 | Oct 07, 2025 | 1.29 → 1.33                    | 1.29 → 1.32                   |
 | [1.16][]     | Oct 03, 2024 | Jun 10, 2025 | 1.25 → 1.32                    | 4.14 → 4.17                   |
 | [1.15][]     | Jun 05, 2024 | Feb 03, 2025 | 1.25 → 1.32                    | 4.12 → 4.16                   |
 | [1.14][]     | Feb 03, 2024 | Oct 03, 2024 | 1.24 → 1.31                    | 4.11 → 4.16                   |

content/docs/releases/release-notes/release-notes-1.19.md

@@ -5,45 +5,104 @@ description: 'cert-manager release notes: cert-manager 1.19'
 
 cert-manager is the easiest way to automatically manage certificates in Kubernetes and OpenShift clusters.
 
-cert-manager 1.19 introduces several new features and breaking changes.
-
-TODO
+This release focuses on expanding platform compatibility, improving deployment flexibility, enhancing observability, and addressing key reliability issues.
 
 Be sure to review all new features and changes below, and read the full release notes carefully before upgrading.
 
 ## Major Themes
 
-TODO
+###  Deployment and Platform Compatibility
+- The default network policy now includes `IPv6` rules to improve support for dual-stack and `IPv6` enabled clusters.
+- The Helm chart has a new `global.nodeSelector` value, to set a single node selector across all cert-manager components. This simplifies the deployment of cert-manager.
+- The Helm chart has a new (experimental) `global.hostUsers` flag which, if set to `false`, configures all the cert-manager Pods to use the [User Namespace feature of Kubernetes `>= 1.33`](https://kubernetes.io/docs/tasks/configure-pod-container/user-namespaces/). You can use this feature to reduce the damage a compromised container can do to the host or other pods in the same node. This new feature is disabled by default to maintain compatibility with Kubernetes `< 1.33`. In the future, when Kubernetes 1.32 reaches its end-of-life, the Helm chart value may be removed (or become a no-op) and cert-manager Pods will be configured to use user-namespaces by default.
+
+### ACME and Certificate Management
+- There is a new feature gate `ACMEHTTP01IngressPathTypeExact`, to allow `ingress-nginx` users to turn off the new default Ingress `PathType: Exact` setting. This is useful if you are using an old version of `ingress-nginx` which does not properly support `PathType: Exact`.
+- The Issuer and ClusterIssuer custom resources have new fields which allow you to configure resource requests and resource limits for ACME HTTP-01 solver pods. This allows teams to override the global `--acme-http01-solver-resource-*` flag values which are set by the platform administrator.
+- The ACME challenge authorization timeout has been increased to two minutes to reduce `error waiting for authorization` failures.
+- There is now stricter solver validation to reject configurations that specify multiple ingress selection options (e.g. `class`, `ingressClassName`, `name`).
+- There are DNS and API improvements. A new `protocol` field was added for the `rfc2136` DNS01 provider.
+- The `CAInjectorMerging` feature has been promoted to BETA which means it is enabled by default. This means the feature, which configures the CA Injector to merges new CA certificates with existing ones instead of replacing them outright, is now considered stable and will be active unless explicitly disabled.
+- There are various reliability fixes related to certificates and CSRs: increased maximum parsable PEM sizes, corrected permitted URI domain handling in CSR name constraints, and improved admission error messages for malformed PEM data.
+
+### Observability, Reliability, and Maintenance
+- There is a new Prometheus metric called `certmanager_certificate_challenge_status`.
+- POTENTIALLY BREAKING: A high cardinality label, called `path`, was removed from the `certmanager_acme_client_request_count` and `certmanager_acme_client_request_duration_seconds` metrics. It is replaced with a new bounded cardinality label called `action`. This may require updates to dashboards and alerts.
 
 ## Community
 
 As always, we'd like to thank all of the community members who helped in this release cycle, including all below who merged a PR and anyone that helped by commenting on issues, testing, or getting involved in cert-manager meetings. We're lucky to have you involved.
 
 A special thanks to:
-
-- TODO
-
+{/* BEGIN contributors */}
+- [`@StingRayZA`](https://github.com/StingRayZA)
+- [`@armagankaratosun`](https://github.com/armagankaratosun)
+- [`@hjoshi123`](https://github.com/hjoshi123)
+- [`@jcpunk`](https://github.com/jcpunk)
+- [`@kinolaev`](https://github.com/kinolaev)
+- [`@lunarwhite`](https://github.com/lunarwhite)
+- [`@mladen-rusev-cyberark`](https://github.com/mladen-rusev-cyberark)
+- [`@prasad89`](https://github.com/prasad89)
+- [`@quantpoet`](https://github.com/quantpoet)
+- [`@sspreitzer`](https://github.com/sspreitzer)
+{/* END contributors */}
 for their contributions, comments and support!
 
 Also, thanks to the cert-manager maintainer team for their help in this release:
-
-- [@inteon](https://github.com/inteon)
-- [@erikgb](https://github.com/erikgb)
-- [@SgtCoDFish](https://github.com/SgtCoDFish)
-- [@ThatsMrTalbot](https://github.com/ThatsMrTalbot)
-- [@munnerz](https://github.com/munnerz)
-- [@maelvls](https://github.com/maelvls)
+{/* BEGIN maintainers */}
+- [`@SgtCoDFish`](https://github.com/SgtCoDFish)
+- [`@ThatsMrTalbot`](https://github.com/ThatsMrTalbot)
+- [`@erikgb`](https://github.com/erikgb)
+- [`@inteon`](https://github.com/inteon)
+- [`@maelvls`](https://github.com/maelvls)
+- [`@munnerz`](https://github.com/munnerz)
+- [`@wallrj`](https://github.com/wallrj)
+{/* END maintainers */}
 
 And finally, thanks to the cert-manager steering committee for their feedback in this release cycle:
-
-- [@FlorianLiebhart](https://github.com/FlorianLiebhart)
-- [@ssyno](https://github.com/ssyno)
-- [@ianarsenault](https://github.com/ianarsenault)
-- [@TrilokGeer](https://github.com/TrilokGeer)
-
-
+{/* BEGIN steerers */}
+- [`@FlorianLiebhart`](https://github.com/FlorianLiebhart)
+- [`@TrilokGeer`](https://github.com/TrilokGeer)
+- [`@ianarsenault`](https://github.com/ianarsenault)
+- [`@ssyno`](https://github.com/ssyno)
+{/* END steerers */}
+
+{/* BEGIN changelog v1.19.0 */}
 ## `v1.19.0`
 
-Changes since `v1.18.2`:
-
-TODO
+Changes since `v1.18.0`:
+
+### Feature
+
+- Add IPv6 rules to the default network policy ([`#7726`](https://github.com/cert-manager/cert-manager/pull/7726), [`@jcpunk`](https://github.com/jcpunk))
+- Add `global.nodeSelector` to helm chart to allow for a single `nodeSelector` to be set across all services. ([`#7818`](https://github.com/cert-manager/cert-manager/pull/7818), [`@StingRayZA`](https://github.com/StingRayZA))
+- Add a feature gate to default to Ingress `pathType` `Exact` in ACME HTTP01 Ingress challenge solvers. ([`#7795`](https://github.com/cert-manager/cert-manager/pull/7795), [`@sspreitzer`](https://github.com/sspreitzer))
+- Add generated `applyconfigurations` allowing clients to make type-safe server-side apply requests for cert-manager resources. ([`#7866`](https://github.com/cert-manager/cert-manager/pull/7866), [`@erikgb`](https://github.com/erikgb))
+- Added API defaults to issuer references group (cert-manager.io) and kind (Issuer). ([`#7414`](https://github.com/cert-manager/cert-manager/pull/7414), [`@erikgb`](https://github.com/erikgb))
+- Added `certmanager_certificate_challenge_status` Prometheus metric. ([`#7736`](https://github.com/cert-manager/cert-manager/pull/7736), [`@hjoshi123`](https://github.com/hjoshi123))
+- Added `protocol` field for `rfc2136` DNS01 provider ([`#7881`](https://github.com/cert-manager/cert-manager/pull/7881), [`@hjoshi123`](https://github.com/hjoshi123))
+- Added experimental field `hostUsers` flag to all pods. Not set by default. ([`#7973`](https://github.com/cert-manager/cert-manager/pull/7973), [`@hjoshi123`](https://github.com/hjoshi123))
+- Support configurable resource requests and limits for ACME HTTP01 solver pods through ClusterIssuer and Issuer specifications, allowing granular resource management that overrides global `--acme-http01-solver-resource-*` settings. ([`#7972`](https://github.com/cert-manager/cert-manager/pull/7972), [`@lunarwhite`](https://github.com/lunarwhite))
+- The `CAInjectorMerging` feature has been promoted to BETA and is now enabled by default ([`#8017`](https://github.com/cert-manager/cert-manager/pull/8017), [`@ThatsMrTalbot`](https://github.com/ThatsMrTalbot))
+- The controller, webhook and ca-injector now log their version and git commit on startup for easier debugging and support. ([`#8072`](https://github.com/cert-manager/cert-manager/pull/8072), [`@prasad89`](https://github.com/prasad89))
+- Updated `certificate` metrics to the collector approach. ([`#7856`](https://github.com/cert-manager/cert-manager/pull/7856), [`@hjoshi123`](https://github.com/hjoshi123))
+
+### Bug or Regression
+
+- ACME: Increased challenge authorization timeout to 2 minutes to fix `error waiting for authorization` ([`#7796`](https://github.com/cert-manager/cert-manager/pull/7796), [`@hjoshi123`](https://github.com/hjoshi123))
+- BUGFIX: permitted URI domains were incorrectly used to set the excluded URI domains in the CSR's name constraints ([`#7816`](https://github.com/cert-manager/cert-manager/pull/7816), [`@kinolaev`](https://github.com/kinolaev))
+- Enforced ACME HTTP-01 solver validation to properly reject configurations when multiple ingress options (`class`, `ingressClassName`, `name`) are specified simultaneously ([`#8021`](https://github.com/cert-manager/cert-manager/pull/8021), [`@lunarwhite`](https://github.com/lunarwhite))
+- Increase maximum sizes of PEM certificates and chains which can be parsed in cert-manager, to handle leaf certificates with large numbers of DNS names or other identities ([`#7961`](https://github.com/cert-manager/cert-manager/pull/7961), [`@SgtCoDFish`](https://github.com/SgtCoDFish))
+- Reverted adding the `global.rbac.disableHTTPChallengesRole` Helm option. ([`#7836`](https://github.com/cert-manager/cert-manager/pull/7836), [`@inteon`](https://github.com/inteon))
+- This change removes the `path` label of core ACME client metrics and will require users to update their monitoring dashboards and alerting rules if using those metrics. ([`#8109`](https://github.com/cert-manager/cert-manager/pull/8109), [`@mladen-rusev-cyberark`](https://github.com/mladen-rusev-cyberark))
+- Use the latest version of `ingress-nginx` in E2E tests to ensure compatibility ([`#7792`](https://github.com/cert-manager/cert-manager/pull/7792), [`@wallrj`](https://github.com/wallrj))
+
+### Other (Cleanup or Flake)
+
+- Helm: Fix naming template of `tokenrequest` RoleBinding resource to improve consistency ([`#7761`](https://github.com/cert-manager/cert-manager/pull/7761), [`@lunarwhite`](https://github.com/lunarwhite))
+- Improve error messages when certificates, CRLs or private keys fail admission due to malformed or missing PEM data ([`#7928`](https://github.com/cert-manager/cert-manager/pull/7928), [`@SgtCoDFish`](https://github.com/SgtCoDFish))
+- Major upgrade of Akamai SDK. NOTE: The new version has not been fully tested end-to-end due to the lack of cloud infrastructure. ([`#8003`](https://github.com/cert-manager/cert-manager/pull/8003), [`@hjoshi123`](https://github.com/hjoshi123))
+- Update kind images to include the Kubernetes 1.33 node image ([`#7786`](https://github.com/cert-manager/cert-manager/pull/7786), [`@wallrj`](https://github.com/wallrj))
+- Use `maps.Copy` for cleaner map handling ([`#8092`](https://github.com/cert-manager/cert-manager/pull/8092), [`@quantpoet`](https://github.com/quantpoet))
+- Vault: Migrate Vault E2E add-on tests from deprecated `vault-client-go` to the new `vault/api` client. ([`#8059`](https://github.com/cert-manager/cert-manager/pull/8059), [`@armagankaratosun`](https://github.com/armagankaratosun))
+{/* END changelog v1.19.0 */}

content/docs/releases/upgrading/upgrading-1.18-1.19.md

@@ -3,9 +3,16 @@ title: Upgrading from v1.18 to v1.19
 description: 'cert-manager installation: Upgrading v1.18 to v1.19'
 ---
 
-Before upgrading cert-manager from 1.18 to 1.19, please read the following important notes about breaking changes in 1.19:
+Before upgrading cert-manager from 1.18 to 1.19, please read the following important notes about breaking changes:
 
-TODO
+## Potentially Breaking: ACME metrics label changes
+
+A high cardinality label, called `path`, was removed from the `certmanager_acme_client_request_count` and `certmanager_acme_client_request_duration_seconds` metrics.
+It is replaced with a new bounded cardinality label called `action`.
+If you are using these metrics, you may need to update your dashboards and alerts.
+
+1. Update any dashboards and alerts that using the old `path` label, to use the new bounded `action` label.
+2. If you rely on the high-cardinality `path` label, consider adding a Prometheus relabeling or recording rule to preserve the prior semantics (but beware of storage and cost).
 
 ## Next Steps
 

content/docs/variables.json

@@ -1,3 +1,3 @@
 {
-  "cert_manager_latest_version": "v1.18.2"
+  "cert_manager_latest_version": "v1.19.0"
 }

scripts/gendocs/generate-new-import-path-docs

@@ -155,7 +155,7 @@ LATEST_VERSION="docs" # to also upgrade a specific version, use v1.13-docs, v1.1
 #genversionwithcli "release-1.15" "v1.15-docs"
 #genversionwithcli "release-1.16" "v1.16-docs"
 #genversionwithcli "release-1.17" "v1.17-docs"
-genversionwithcli "release-1.18" "$LATEST_VERSION"
+genversionwithcli "release-1.19" "$LATEST_VERSION"
 
 # Rather than generate the same docs again for /docs, copy from the latest version