Upgrading from v1.5 to v1.6
Upgrading cert-manager CRDs and stored versions of cert-manager custom resources
Following their deprecation in version 1.4, the cert-manager API versions
v1alpha2, v1alpha3, and v1beta1 are no longer served.
This means if your deployment manifests contain any of these API versions, you will not be able to deploy them after upgrading.
cmctl utility or old
kubectl cert-manager plugin can convert old manifests to
v1 for you.
⛔️ If you are upgrading cert-manager on a cluster which has previously had
v1.0.0, you will need to ensure that all cert-manager custom
resources are stored in
v1 version and that cert-manager CRDs do not
reference the deprecated APIs before you upgrade to
This is explained in more detail in the Upgrading existing cert-manager resources page.
If you are currently using HTTP-01 challenges or the Ingress shim annotations, please read the Ingress class compatibility notes to see if your Ingress controller has any known issues with the migration to Ingress v1.
Now Follow the Regular Upgrade Process
From here on you can follow the regular upgrade process.