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
ChallengePresented и затем 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.

Проверенные источники