ACME はドメイン検証が Pingress に到達できる状態で証明書を発行・更新します。
準備
DNS と 80/443 を用意します。標準 HTTP-01 は 80 を使います。
curl -i http://app.example.com/.well-known/acme-challenge/healthzリダイレクトに頼らず 200 になることを確認します。AAAA、プロキシ、ファイアウォールを先に修正します。
Pingress の有効化時は自動証明書が既定で選択されています。選択を外し、後から証明書設定で有効にすることもできます。
作成 API の既定値は "acme": "LetsEncrypt" です。HTTP のみ、または手動管理の証明書を使用する場合は "acme": null を指定します。保持されたアカウントと自動証明書は削除され、アップロード済みの証明書は保持されます。staging/Pebble は本番の公開信頼を持たないテスト環境です。API の dns-persist-01 は対応 CA 向けで、汎用 DNS プロバイダー設定ではありません。検証方式を参照してください。
タイミング
証明書はバックグラウンドで発行します。発行は約 5 分、更新は約 8 時間ごとに確認します。更新時期は CA の情報または有効期間に従います。
検証経路を維持してください。手動証明書は自動更新されません。
調査
クライアントで名前、発行者、期限を確認し、公開した IPv4/IPv6 双方を試します。IPv4 が成功しても誤った AAAA が失敗を起こします。
自動証明書のアカウントを準備してから Pingress をデプロイします。デプロイに失敗した場合、アカウントは再試行用に保持されます。Pingress がまだ存在せず、自動証明書が保存されていなければ、API で別の対応 CA を選択できます。
原因を直してから再試行します。独自証明書も参照してください。