[{"data":1,"prerenderedAt":314},["ShallowReactive",2],{"blog-ja-k3s-cert-manager-acme-renewal-pitfalls":3,"blog-related-ja-k3s-cert-manager-acme-renewal-pitfalls":262,"blog-ja-k3s-cert-manager-acme-renewal-pitfalls-alt":251},{"id":4,"title":5,"author":6,"body":7,"date":245,"description":246,"extension":247,"image":248,"locale":249,"meta":250,"navigation":251,"path":252,"seo":253,"stem":254,"tags":255,"__hash__":261},"blog\u002Fblog\u002Fja\u002Fk3s-cert-manager-acme-renewal-pitfalls.md","土曜の朝、K3sの本番サイトがTLS証明書切れで落ちた。手動更新から抜け出すACME自動化の設計","Kubo Team",{"type":8,"value":9,"toc":227},"minimark",[10,19,22,33,36,41,48,63,68,79,83,92,96,105,109,126,129,138,142,148,151,154,161,165,177,186,189,192,196,202,205,211,214,217,220],[11,12,13,14,18],"p",{},"土曜の朝、Slackの通知音でスマホが鳴る。本番サイトが503を返している。原因はTLS証明書の期限切れ。しかも、そのクラスタには数ヶ月前に ",[15,16,17],"code",{},"cert-manager"," を導入済みだった。「証明書は自動更新されるはずでは」という疑問が頭をよぎる。",[11,20,21],{},"こうした事故は、K3sやKubernetesの現場で決して珍しくない。cert-managerを入れることと、cert-managerが実際に証明書を更新し続けることは、まったく別の問題だからだ。手動でCSR（証明書署名要求）を作成し、認証局に送り、署名を受け取ってアップロードするという多段階の作業は、担当者が変わるたびに手順が引き継がれずミスを生んできた。皮肉なことに、自動化ツールを導入した後も、設定の誤りや監視の欠如という形で同じ属人化のリスクは残り続ける。",[11,23,24,25,32],{},"K3sは",[26,27,31],"a",{"href":28,"rel":29},"https:\u002F\u002Fdocs.k3s.io\u002Fnetworking\u002Fnetworking-services",[30],"nofollow","デフォルトでTraefikをIngressコントローラーとして同梱しており","、外部からのTLS終端はこのTraefikとcert-managerが発行するSecretの組み合わせで成り立っている。つまりcert-manager側の更新が滞れば、K3sクラスタ全体のTLS終端がそのまま止まる構造だ。",[11,34,35],{},"この記事では、cert-managerを導入していても証明書が静かに失効する4つのパターンと、TLS証明書の自動更新を「導入した」で終わらせず「動き続けている」状態にするための設計を、K3s環境を前提に解説する。",[37,38,40],"h2",{"id":39},"なぜ導入したと動いているは別問題なのか-cert-managerが静かに失敗する4パターン","なぜ「導入した」と「動いている」は別問題なのか — cert-managerが静かに失敗する4パターン",[11,42,43],{},[44,45],"img",{"alt":46,"src":47},"section01","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-cert-manager-acme-renewal-pitfalls\u002Fsection01.webp",[11,49,50,51,56,57,62],{},"cert-managerは",[26,52,55],{"href":53,"rel":54},"https:\u002F\u002Fgithub.com\u002Fcert-manager\u002Fcert-manager",[30],"GitHub上で公開されているOSSプロジェクト","で、",[26,58,61],{"href":59,"rel":60},"https:\u002F\u002Fwww.cncf.io\u002Fannouncements\u002F2024\u002F11\u002F12\u002Fcloud-native-computing-foundation-announces-cert-manager-graduation\u002F",[30],"CNCFのGraduatedプロジェクト","でもあり、月間5億ダウンロードを記録するほど広く使われている、信頼性の高いツールだ。それでも本番環境で証明書更新が失敗する事例は後を絶たない。典型的な原因は次の4つに集約される。",[64,65,67],"h3",{"id":66},"_1-issuer-clusterissuerの参照ミス","1. Issuer \u002F ClusterIssuerの参照ミス",[11,69,70,71,74,75,78],{},"cert-managerでは、証明書発行元を ",[15,72,73],{},"Issuer","（namespace限定）または ",[15,76,77],{},"ClusterIssuer","（クラスタ全体）というリソースで定義する。Certificateリソースがどちらを参照するかを取り違えたり、namespaceをまたいだ参照を誤って設定したりすると、issuanceがそもそも実行されない。クラスタが複数namespaceにまたがる本番運用では、この種の設定ミスが特に発生しやすい。",[64,80,82],{"id":81},"_2-dns-01検証の失敗","2. DNS-01検証の失敗",[11,84,85,86,91],{},"ワイルドカード証明書や複数ドメインを扱う場合、cert-managerは",[26,87,90],{"href":88,"rel":89},"https:\u002F\u002Fcert-manager.io\u002Fdocs\u002Fconfiguration\u002Facme\u002Fdns01\u002F",[30],"DNS-01チャレンジ","でドメイン所有権を検証する。これは、ACMEサーバーが要求するTXTレコードをDNSに書き込み、伝播を待ってから検証する仕組みだ。Ingressのホスト名を変更した後にDNS設定を更新し忘れたり、DNSプロバイダーのAPI認証情報が期限切れになっていたりすると、検証は静かに失敗し続ける。",[64,93,95],{"id":94},"_3-lets-encryptのレート制限枯渇","3. Let's Encryptのレート制限枯渇",[11,97,98,99,104],{},"Let's Encryptは公平な利用のためレート制限を設けている。",[26,100,103],{"href":101,"rel":102},"https:\u002F\u002Fletsencrypt.org\u002Fdocs\u002Frate-limits\u002F",[30],"公式ドキュメント","によれば、登録ドメインあたり7日間で発行できる証明書は50件、同一アカウントが3時間に作成できる新規オーダーは300件までだ。設定ミスによって同じ証明書の発行リクエストが繰り返し失敗すると、この上限にすぐ達し、正当な更新リクエストまでブロックされる。しかも認可の失敗が1時間に5回を超えるとアカウント単位で一時的に制限され、復旧にはセルフサービスポータルでの対応が必要になる。",[64,106,108],{"id":107},"_4-secretが更新されてもpodingressが再読み込みしない","4. Secretが更新されてもPod・Ingressが再読み込みしない",[11,110,111,112,115,116,121,122,125],{},"cert-managerが証明書を更新すると、その内容はKubernetesの ",[15,113,114],{},"Secret"," に書き込まれる。",[26,117,120],{"href":118,"rel":119},"https:\u002F\u002Fkubernetes.io\u002Fdocs\u002Fconcepts\u002Fconfiguration\u002Fsecret\u002F",[30],"Kubernetes公式ドキュメント","によれば、Secretをボリュームとしてマウントしている場合、kubeletは変更を検知して結果整合的にファイルを更新する。しかし、",[15,123,124],{},"subPath"," でマウントしている場合はこの自動更新の対象外になる。さらに、証明書を環境変数として読み込んでいるアプリケーションや、起動時に一度だけ証明書をメモリに読み込むプロセスは、Secretが更新されても再起動しない限り古い証明書を使い続けてしまう。",[11,127,128],{},"これら4つに共通するのは、いずれも「エラーとして目に見える形で通知されない」という点だ。更新が失敗しても、証明書の有効期限が実際に切れるまでシステムは正常に動作しているように見える。これが、手動運用時代の「気づいたときには手遅れ」という構造をそのまま引き継いでしまう理由だ。",[11,130,131,132,137],{},"こうした落とし穴の多くは、Issuer設定やDNSプロバイダー連携を、クラスタを作るたびに手作業でゼロから構築していることに起因する。",[26,133,136],{"href":134,"rel":135},"https:\u002F\u002Fkubo.hexabase.io\u002F",[30],"Kubo","のようにcert-manager導入とClusterIssuer設定がテンプレート化されたマネージドK3s基盤を使えば、そもそも参照ミスや設定漏れが起きにくい状態からスタートできる。",[37,139,141],{"id":140},"動いているはずを動いているに変える設計-監視renewbeforeステージング検証","「動いているはず」を「動いている」に変える設計 — 監視・renewBefore・ステージング検証",[11,143,144],{},[44,145],{"alt":146,"src":147},"section02","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-cert-manager-acme-renewal-pitfalls\u002Fsection02.webp",[11,149,150],{},"証明書の自動更新を「機能させ続ける」ためには、ツールを入れるだけでなく、失敗を検知できる仕組みと余裕を持った設計が欠かせない。",[64,152,153],{"id":153},"有効期限切れ前に気づく監視を組み込む",[11,155,156,157,160],{},"cert-managerはCertificateリソースのステータスとして更新状況を公開しており、Prometheusのメトリクスとして取得できる。証明書の残存有効期間をダッシュボード化し、一定日数を下回ったらアラートを発報する仕組みを、cert-manager自体の監視とは独立して持っておくことが重要だ。「更新が成功したこと」ではなく「証明書が有効期限内であること」を直接監視するのがポイントになる。",[26,158,136],{"href":134,"rel":159},[30],"のようにPrometheus + Grafanaが標準搭載されたマネージドK3s基盤であれば、この監視スタック自体をゼロから構築する手間は発生しない。",[64,162,164],{"id":163},"renewbeforeでバッファを確保する","renewBeforeでバッファを確保する",[11,166,167,172,173,176],{},[26,168,171],{"href":169,"rel":170},"https:\u002F\u002Fcert-manager.io\u002Fdocs\u002Fusage\u002Fcertificate\u002F",[30],"cert-managerの公式ドキュメント","によれば、更新タイミングを指定しない場合、証明書は有効期間の3分の2が経過した時点で自動的に更新される。90日証明書であれば約30日前が目安だ。この既定値は、DNS伝播の遅延やレート制限による一時的な失敗を吸収するためのバッファとして機能している。",[15,174,175],{},"spec.renewBefore"," を明示的に設定する場合は、このバッファを削りすぎないよう注意したい。",[11,178,179,180,185],{},"なお、Let's Encryptは証明書の有効期間を段階的に短縮する方針を",[26,181,184],{"href":182,"rel":183},"https:\u002F\u002Fletsencrypt.org\u002F2026\u002F02\u002F24\u002Frate-limits-45-day-certs",[30],"公式に発表しており","、90日から64日、将来的には45日へと移行する計画が進んでいる。有効期間が短くなるほど更新の失敗が本番影響に直結するまでの猶予も短くなるため、監視とバッファ設計の重要性はむしろ高まる。",[64,187,188],{"id":188},"ステージング環境で検証してから本番に適用する",[11,190,191],{},"Issuerの設定変更や新しいDNSプロバイダーの導入は、Let's Encryptのステージング環境で検証してからClusterIssuerを切り替えるべきだ。ステージング環境は本番と同じレート制限の仕組みを持ちながら、失敗しても本番のレート制限を消費しない。設定ミスに気づかないまま本番のClusterIssuerで試行錯誤すると、それだけでレート制限を使い切ってしまうリスクがある。",[37,193,195],{"id":194},"マネージドk3sならこの気づいたら失効を構造ごとなくせる","マネージドK3sなら、この「気づいたら失効」を構造ごとなくせる",[11,197,198],{},[44,199],{"alt":200,"src":201},"section03","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-cert-manager-acme-renewal-pitfalls\u002Fsection03.webp",[11,203,204],{},"ここまで見てきた4つの失敗パターンと、それを防ぐための監視・バッファ設計は、どれも技術的には難しくない。しかし、これらを継続的に「正しく設定され、正しく監視されている」状態に保つこと自体が、実は見落とされがちな運用コストになる。Issuer設定のレビュー、Prometheusアラートルールの保守、DNS認証情報のローテーション管理——こうした地味な作業の積み重ねが、K3sクラスタが増えるほど、あるいは担当者が変わるほど属人化していく。",[11,206,207,210],{},[26,208,136],{"href":134,"rel":209},[30],"のマネージドK3s基盤には、cert-manager + Let's Encryptによる証明書自動管理が標準搭載されている。ClusterIssuerの初期設定やDNSプロバイダー連携、監視の仕組みをゼロから構築・保守する必要がなく、K3sベースの軽量性を保ったまま本格的なKubernetesの機能をそのまま使える。EKSやAKSと同等のコンテナ基盤を、4vCPU\u002F8GB\u002F40GB×3ノード構成で月額48,000円〜という水準で運用できるのも、こうした運用の標準化によるところが大きい。",[11,212,213],{},"証明書管理という一見地味な領域こそ、「壊れたときの被害が大きいのに、壊れるまで気づきにくい」という性質を持つ。ここを構造ごとマネージド側に任せることは、単なる楽さの追求ではなく、本番障害のリスクそのものを削減する設計判断だと言える。",[37,215,216],{"id":216},"まとめ",[11,218,219],{},"cert-managerを導入することと、TLS証明書の自動更新が実際に機能し続けることの間には、Issuer参照ミス・DNS-01検証失敗・レート制限枯渇・Secret未リロードという見えにくい落とし穴がある。手動更新時代の属人化を解消するために自動化ツールを入れたはずが、設定と監視を怠れば同じ「気づいたときには手遅れ」の構造に戻ってしまう。",[11,221,222,223,226],{},"有効期限を直接監視すること、renewBeforeで十分なバッファを確保すること、ステージング環境で変更を検証すること——この3つを運用に組み込んで初めて、証明書管理は「導入した」から「動いている」に変わる。そしてこの運用負荷そのものを構造的になくしたいなら、",[26,224,136],{"href":134,"rel":225},[30],"のようにcert-manager運用が標準搭載されたマネージドK3s基盤への移行も、現実的な選択肢の一つになるはずだ。",{"title":228,"searchDepth":229,"depth":229,"links":230},"",2,[231,238,243,244],{"id":39,"depth":229,"text":40,"children":232},[233,235,236,237],{"id":66,"depth":234,"text":67},3,{"id":81,"depth":234,"text":82},{"id":94,"depth":234,"text":95},{"id":107,"depth":234,"text":108},{"id":140,"depth":229,"text":141,"children":239},[240,241,242],{"id":153,"depth":234,"text":153},{"id":163,"depth":234,"text":164},{"id":188,"depth":234,"text":188},{"id":194,"depth":229,"text":195},{"id":216,"depth":229,"text":216},"2026-08-27","K3sの本番環境にcert-managerを導入していても、Issuerの参照ミスやDNS検証失敗、Let's Encryptのレート制限、Secret未リロードといった見落としで証明書は静かに失効する。手動更新時代の属人化と同じ罠に陥らないための、ACME自動更新を本当に機能させる監視・設計のポイントを解説する。","md","https:\u002F\u002Fcdn.kubo.hexabase.io\u002Fimages\u002Fblog\u002Fk3s-cert-manager-acme-renewal-pitfalls\u002Feyecatch.webp","ja",{},true,"\u002Fblog\u002Fja\u002Fk3s-cert-manager-acme-renewal-pitfalls",{"title":5,"description":246},"blog\u002Fja\u002Fk3s-cert-manager-acme-renewal-pitfalls",[256,257,17,258,259,260],"k3s","kubernetes","tls","lets-encrypt","acme","gwTOLNjWPFQk7sHuZVC3g_j78_8P2E872tqmJodZU9s",[263,270,279,286,296,305],{"path":264,"title":265,"description":266,"date":267,"tags":268},"\u002Fblog\u002Fja\u002Fk3s-cert-manager-servicelb-http01-challenge-renewal-failure","K3sでcert-managerの証明書が自動更新されない。HTTP-01チャレンジをServiceLBが奪っていた","K3sでcert-managerの証明書が更新されない原因はTraefikでもcert-manager自体でもなく、port 80\u002F443を専有するServiceLBだった。HTTP-01チャレンジが静かに失敗する仕組みと恒久対処を解説する。","2026-09-25",[256,257,17,269,258,259],"servicelb",{"path":271,"title":272,"description":273,"date":274,"tags":275},"\u002Fblog\u002Fja\u002Fcert-manager-automatic-tls","cert-manager で Kubernetes の TLS 証明書を自動管理する","cert-manager を使って Kubernetes 環境の TLS 証明書を自動発行・自動更新する方法を解説。Let's Encrypt、ACME チャレンジ、Ingress 連携まで。","2026-05-27",[17,257,258,259,260,276,277,278],"cncf","セキュリティ","証明書",{"path":280,"title":281,"description":282,"date":283,"tags":284},"\u002Fblog\u002Fja\u002Fkubernetes-certificate-management-cert-manager-process-debt","証明書の更新、1行のコードより2ヶ月の会議が長かった。Kubernetesの証明書管理が『技術』ではなく『手続き』の問題である理由","Kubernetesの証明書管理は技術的には数日で終わる。だが実際に時間がかかるのは合意形成という『手続き』だ。cert-managerによる自動化と、組織的負債をなくす設計を解説する。","2026-08-09",[256,257,17,258,285],"security",{"path":287,"title":288,"description":289,"date":290,"tags":291},"\u002Fblog\u002Fja\u002Fk3s-longhorn-openebs-mayastor-storage-selection","Longhornで十分か、OpenEBS Mayastorが要るか。K3sストレージ選定を性能要件で決める","K3sのストレージ、まだ「とりあえずLonghorn」で決めていませんか。LonghornとOpenEBS Mayastorをハードウェア要件・レプリカ構成・性能特性という4つの軸で徹底比較し、本番導入前に後悔しない選定基準をチェックリスト形式でわかりやすく解説します。","2026-11-15",[256,257,292,293,294,295],"longhorn","openebs","mayastor","storage",{"path":297,"title":298,"description":299,"date":300,"tags":301},"\u002Fblog\u002Fja\u002Fk3s-proxmox-ceph-csi-rbd-multiattach-node-maintenance","Multi-Attach error for volume。ProxmoxのK3s+Ceph CSIでノードメンテ前に知っておくべきRBDロックの罠","Proxmox上のK3sでノードをdrainしたら、Ceph CSI(RBD)のPVがMulti-Attach errorでPending化した。原因はexclusive lockとwatcherの残存、フェンシングのレース条件。復旧コマンドとNetworkFenceによる恒久対策を解説する。","2026-11-14",[256,257,302,303,304,295],"proxmox","ceph-csi","rbd",{"path":306,"title":307,"description":308,"date":309,"tags":310},"\u002Fblog\u002Fja\u002Fproxmox-corosync-self-fencing-k3s-etcd-quorum","2台のProxmoxで組んだK3sクラスタが、ネットワークの瞬断で同時に全滅した。原因はCorosyncのself-fencingだった","2台のProxmoxホストでK3sクラスタを運用していたら、数秒のネットワーク瞬断でホストごとリブートし、K3sのetcd quorumまで巻き込まれて全滅した。原因のCorosync self-fencingと、ノード配置設計での再発防止策を解説する。","2026-11-11",[256,257,302,311,312,313],"etcd","high-availability","quorum",1794902456806]