cert-manager Issuer & Certificate Troubleshooting Prompt
Diagnose stuck cert-manager Certificates — pending challenges, failing ACME orders, DNS-01 propagation, and renewal loops — and produce a working Issuer config.
- Target user
- Platform engineers debugging TLS certificate automation on Kubernetes
- Difficulty
- Intermediate
- Tools
- Claude, ChatGPT
The prompt
You are a senior platform engineer who has shipped automated TLS with cert-manager across hundreds of domains and untangled every flavor of stuck challenge. I will provide: - The `Certificate`, `Issuer`/`ClusterIssuer`, and `Ingress` (or Gateway) manifests - Output of `kubectl describe certificate`, `certificaterequest`, `order`, and `challenge` - cert-manager controller logs around the failure window - Whether using HTTP-01 or DNS-01, and the DNS provider - Symptoms (stuck Pending, "too many certificates", renewal not firing, wrong SAN) Walk me through this in order: 1. **Trace the resource chain** — explain the `Certificate → CertificateRequest → Order → Challenge` cascade and tell me exactly which object to `describe` first based on my symptom. Most people stop at `Certificate`; teach me to read the leaf object. 2. **HTTP-01 failures** — verify the solver Ingress/pod is reachable from the internet, the `.well-known/acme-challenge` path routes correctly, and there's no redirect/auth in front. Give the curl command to test the token endpoint. 3. **DNS-01 failures** — check the TXT record actually propagated (`dig`), the provider credentials/RBAC are correct, and propagation timeout vs ACME polling. Cover split-horizon DNS gotchas. 4. **Rate limits** — detect Let's Encrypt rate-limit errors, explain the weekly caps, and prescribe using the staging issuer plus existing-secret reuse to recover without burning quota. 5. **Renewal loops** — why a cert renews early or repeatedly; clock skew; `renewBefore` math; duplicate CertificateRequests. 6. **Clock / chain issues** — wrong intermediate chain, untrusted CA, `usages` mismatch (server vs client auth). 7. **The fix** — give me corrected manifests (Issuer + Certificate) with the right solver block, and the precise commands to force a clean re-issue without orphaning the old secret. Output as: (a) root cause in one sentence, (b) the diagnostic command sequence I should have run, (c) corrected YAML, (d) a verification checklist proving the cert issued and Ingress serves it, (e) one preventive guardrail (alert or policy). Be explicit about which steps touch public-facing endpoints versus DNS.
Run this prompt with AI
Test it, get an AI-improved version, or compare models — live in the Prompt Workspace. No copy-paste.
Related prompts
-
Kubernetes Kubelet Certificate Rotation & CSR Debug Prompt
Debug kubelet client/serving certificate rotation failures and stuck CertificateSigningRequests that leave nodes NotReady or unable to authenticate — restoring rotation without manually minting risky long-lived certs.
-
Kubernetes Admission Webhook Debug Prompt
Diagnose admission webhook failures — timeout, TLS cert errors, mutating/validating semantics, failure policy traps, cluster-wide outages from webhook misconfig.
-
Kubernetes Ingress Troubleshooting Prompt
Diagnose Ingress routing failures, controller misconfiguration, TLS issues, 404/502/503 cascades, and path-vs-host mismatches across NGINX, Traefik, Contour, and HAProxy controllers.
-
Helm Secrets + SOPS Encrypted Values Workflow Prompt
Design a GitOps-safe workflow for encrypting Helm values with the helm-secrets plugin and SOPS (age/KMS) — encrypted values in git, decryption at deploy time, key rotation, and CI wiring.
More Kubernetes & Helm prompts & error guides
Browse every Kubernetes & Helm prompt and troubleshooting guide in one place.
Reading prompts? Get all 500 in one free PDF
500 battle-tested, copy-paste AI prompts engineered by a senior systems engineer — every one with fill-in placeholders and safety/back-out notes. Drop your email and it's yours.
- 500 prompts: Linux · Kubernetes · Terraform · OpenStack · GitLab · Docker · Monitoring · Incident Response
- Instant PDF download — yours free, forever
- Plus one practical AI-workflow email a week (no spam)
Single opt-in · unsubscribe anytime · no spam.