cert-manager оставляет след каждого этапа в Kubernetes-ресурсах. Если Secret не появился, найдите первое звено со статусом False, pending или invalid. Массовый restart controller обычно стирает время и отвлекает от причины: неверного Issuer, отказа ACME account, недоступного HTTP-01 URL или DNS-01 записи.
Работайте в namespace проблемного Certificate и сохраните вывод describe до изменений. Начните с `Certificate`, затем используйте имена ресурсов из Events. Для ACME ожидаемая цепочка выглядит так: Certificate → CertificateRequest → Order → Challenge.
Карта ресурсов показывает место остановки
| Ресурс | Нормальный признак | Если его нет |
|---|---|---|
| Certificate | Есть Ready или причина Issuing | Проверить spec.secretName и issuerRef |
| CertificateRequest | Создан и ссылается на нужный Issuer | Смотреть approval, policy и Events |
| Order | Переходит из pending в valid | Открыть Reason и связанные Challenges |
| Challenge | Presented и затем valid | Разобрать self-check, solver и внешний доступ |
| Secret | Содержит актуальные tls.crt и tls.key | Не создавать вручную вместо устранения причины |
kubectl -n app describe certificate example-tls
kubectl -n app get certificaterequest,order,challenge
kubectl -n app describe certificaterequest <name>
kubectl -n app describe order <name>
kubectl -n app describe challenge <name>Имена подставляйте из фактического вывода. Не копируйте команды удаления из случайного ответа: Order и Challenge связаны с конкретным запросом, а принудительное пересоздание до исправления DNS или Ingress создаст тот же отказ и может приблизить лимиты ACME-сервера.
Issuer должен быть Ready до проверки домена
Если Issuer или ClusterIssuer не готов, Challenge может вообще не появиться. Проверьте ссылку `issuerRef`: имя, kind и group. Затем посмотрите Conditions и Events самого Issuer. Ошибки регистрации ACME account, контактного адреса или доступа к account key Secret решаются на этом уровне.
Namespace важен: обычный Issuer находится рядом с Certificate, ClusterIssuer — кластерный. Secret, на который ссылается Issuer, должен быть доступен в ожидаемом месте согласно типу и конфигурации. Не переносите приватные ключи в логи ради диагностики.
HTTP-01 проверяйте тем же публичным путём
Для HTTP-01 cert-manager создаёт временные объекты solver и выполняет self-check URL под `/.well-known/acme-challenge/`. Проверьте DNS имени, IngressClass, Service и доступ к точному URL извне. Редирект на HTTPS, другой ingress controller, firewall или split DNS могут привести к тому, что пользовательский сайт работает, а challenge — нет.
Сравните ответ изнутри кластера и из публичной сети. Если публичный ACME endpoint видит токен, а self-check cert-manager не видит, исследуйте NAT loopback, private DNS или различие маршрутов. Подмена всего Ingress на время выпуска сертификата создаёт лишний риск; корректируйте только solver-route.
DNS-01 — это проверка зоны и прав обновления
В статусе Challenge видно, была ли запись presented и чего ждёт self-check. Запрашивайте TXT у авторитетного сервера зоны. Если запись создана в другой DNS-зоне, публичный resolver её не увидит. Если запись видна, но controller продолжает ждать, сравните рекурсивные резолверы и делегирование.
- У API-учётной записи DNS должны быть права только на нужную зону.
- Секреты провайдера не должны попадать в describe-отчёт или тикет.
- Для wildcard используется DNS-01; HTTP-01 не заменяет его.
- После исправления дождитесь нового события и проверьте переход Order в valid.
Финальная проверка после выпуска
Ready=True у Certificate — ещё не вся проверка. Сравните SAN в сертификате, срок действия, Secret, который читает Ingress, и сертификат, реально выдаваемый внешнему клиенту. Старый TLS может оставаться в другом Secret, load balancer или кеширующем прокси.
Для разбора сохраните YAML без Secret data, Conditions и Events четырёх ресурсов, версию cert-manager, тип solver и результаты публичной проверки challenge. Этого достаточно, чтобы найти остановку без передачи account key.