k8s-cert-manager-troubleshooting
cert-manager troubleshooting
Find out why cert-manager does not issue or renew a certificate, and propose a fix. Read first, ask before changing. Run the investigation commands freely. Run a command under an "Ask first" line only after the user approves that exact command; if your credentials do not allow it, give it to the user to run. Never run a "Proposed fix"; hand it to the user.
cert-manager works in a chain. A Certificate says what is wanted. cert-manager creates a CertificateRequest for each issuance, which an Issuer (one namespace) or ClusterIssuer (whole cluster) signs. For ACME issuers (Let's Encrypt and others) the request also gets an Order with one Challenge per domain. Follow the chain from the Certificate and stop at the first object that is not Ready.
The commands use placeholders: my-namespace, my-app-tls (the Certificate),
my-issuer and my-cluster-issuer. Replace them with the real names. The cert-manager
namespace and Deployment names are those of the default install; a Helm install may use
other names (find them with the first command of step 5).