Kubernetes でコントロールプレーンノードを追加する時に、kubeadm-certs が存在せず kubeadm join --control-plane に失敗した時の確認です。
この記事の位置づけ
この記事は、kubeadm でコントロールプレーンノードを追加できない場合の証明書まわりを扱います。kubeadm-certs の期限や再生成を、クラスタ拡張時のつまずきとして確認します。
コントロールプレーン追加時の join コマンド
sudo kubeadm join 10.0.1.180:6443 --token <token> --discovery-token-ca-cert-hash <discovery-token-ca-cert-hash> --control-plane --certificate-key <certificate-key>発生したエラー
[download-certs] Downloading the certificates in Secret "kubeadm-certs" in the "kube-system" Namespace
error execution phase control-plane-prepare/download-certs: error downloading certs: error downloading the secret: Secret "kubeadm-certs" was not found in the "kube-system" Namespace. This Secret might have expired.
Please, run kubeadm init phase upload-certs --upload-certs on a control plane to generate a new one原因の見方
kubeadm-certs は control plane 追加時に必要な証明書を一時的に共有するための Secret です。存在しない、または期限切れの場合、既存 control plane 側で証明書を再アップロードして、新しい certificate-key を取得します。
既存 control plane で証明書を再アップロードする
sudo kubeadm init phase upload-certs --upload-certs新しい join コマンドを作成する
sudo kubeadm token create --print-join-command --certificate-key <certificate-key>確認すること
- 既存 control plane の API server が正常に動作しているか。
kubeadm-configConfigMap が読めるか。- container runtime の pause image など、preflight warning も合わせて確認する。
- 新しい control plane ノードで時刻同期が取れているか。
まとめ
control plane ノード追加に失敗した場合、token だけでなく certificate-key と kubeadm-certs の状態を確認します。エラーにある通り、既存 control plane で upload-certs を実行し、新しい join コマンドを作ることで復旧できる場合があります。
関連する記事
- Kubernetes クラスター構築 – kubeadm で controlPlaneEndpoint と CNI を確認する
control-plane join の前提になる kubeadm クラスタ構築の考え方を確認しています。 - Kubernetes kubeconfig の管理 – 複数クラスタと context を確認する
クラスタ追加後に kubectl の接続先と context を確認するための記事です。 - Kubernetes クラスタの初期化 – kubeadm reset の基本
join や構築をやり直す場合に確認したい kubeadm reset の位置づけを確認しています。 - Kubernetes 運用設計ガイド
Kubernetes 関連記事全体の入口です。
次に進む
- Kubernetes kubeconfig の管理 – 複数クラスタと context を確認する
control-plane を増やした後、複数クラスタや context の管理を確認します。 - Kubernetes クラスター構築 – kubeadm で controlPlaneEndpoint と CNI を確認する
kubeadm を使ったクラスタ構築全体の設計に戻って確認できます。
参考書籍
参考
書籍
書籍
参考書籍
Kubernetes完全ガイド 第2版
Kubernetes の仕組み、リソース、ネットワーク、運用観点を体系的に確認したい場合の参考書籍です。価格や在庫はリンク先で確認してください。
Amazon で見るこのリンクは Amazon アソシエイトリンクです。
Kubernetes コントロールプレーンノードを追加できない場合 – kubeadm-certs を再生成する
関連記事
Kubernetes クラスタの初期化 – kubeadm reset の基本
古い Kubernetes クラスター構築メモ – kubeadm 手順を現在の記事へ読み替える
Kubernetes クラスター構築 – kubeadm で controlPlaneEndpoint と CNI を決める
Kubernetes kubectl の導入 – リモートクラスタを操作する基本
Kubernetes kubeconfig の管理 – 複数クラスタと context を使い分ける
Kubernetes 運用設計ガイド
Kubernetes Nginx コンテナの実行 – Deployment で Pod を管理する
Kubernetes NetworkPolicy で Pod のアウトバウンド通信を制御する – egress と CNI を分けて考える