Ubuntu 26.04 kubeconfig の基本

Ubuntu 26.04 で Kubernetes の kubeconfig を配置し、管理端末から kubectl を使う基本を整理します。

目的

kubeconfig は、Ubuntu 26.04 をサーバーとして運用するときに、構成の意味と確認ポイントをそろえるための項目です。単にコマンドを実行するだけでなく、設定前後の状態を確認し、再起動後にも同じ状態になるかを見ます。

まず現在のパッケージ、サービス、設定ファイルの状態を確認します。既存設定を把握してから変更することで、障害時に戻しやすくなります。

kubectl cluster-info
kubectl get nodes

必要なパッケージを導入します。環境によってはすでに入っている場合もあるため、導入後にバージョンとサービス状態を確認します。

kubectl config current-context 2>/dev/null || true
ls -l ~/.kube 2>/dev/null || true

設定ファイルは、変更前にバックアップを取り、変更内容を小さく分けて確認します。自動化する場合でも、手動で意味を確認できる形にしておくと運用時に困りにくくなります。

mkdir -p ~/.kube
sudo cp /etc/kubernetes/admin.conf ~/.kube/config
sudo chown $(id -u):$(id -g) ~/.kube/config

設定反映後は、サービス状態、待受ポート、ログを確認します。エラーがなければ、再起動後にも同じ状態になるかを確認します。

kubectl config get-contexts

kubeconfig はクラスタへの認証情報です。共有やバックアップでは権限管理に注意し、管理者用と利用者用を分けます。

Ubuntu 26.04 kubeconfig の基本は、設定した時点で終わりではなく、再起動後、パッケージ更新後、関連サービスの変更後にも期待した状態が維持されているかを見る必要があります。

確認では、設定ファイル、サービス状態、ログ、待受ポート、実際の疎通を分けて見ます。どれか一つだけを見ると、設定は正しいがサービスが反映していない、サービスは起動しているが通信できない、といった状態を見落としやすくなります。

systemctl --failed
journalctl -p warning --since today --no-pager
ss -ltnup | head

サーバー設定は、再起動後に同じ状態へ戻ることが重要です。手動で一時的に反映した設定と、永続化された設定を混同しないようにします。

運用では、変更前の状態、変更したファイル、確認したコマンド、問題が起きたときの戻し方を残しておくと、後から個別記事を修正するときにも判断しやすくなります。

Ubuntu 26.04 kubeconfig の基本