Kubernetes kubectl の導入 – リモートクラスタを操作する基本

kubectl は Kubernetes API を操作するための基本ツールです。クラスタのノードに直接 SSH して操作するのではなく、管理端末から kubeconfig を使ってリモートの Kubernetes API に接続する形にすると、操作場所と権限を整理しやすくなります。

kubectl を導入する

古い記事では CentOS 上でバイナリを直接取得する例を書いていました。現在も考え方は同じで、利用する環境に合わせて公式手順または OS のパッケージ管理で kubectl を導入します。

curl -LO "https://storage.googleapis.com/kubernetes-release/release/$(curl -s https://storage.googleapis.com/kubernetes-release/release/stable.txt)/bin/linux/amd64/kubectl"
chmod +x ./kubectl
sudo mv ./kubectl /usr/local/bin/kubectl
kubectl version --client

リモートクラスタへ接続する

リモートの Kubernetes に接続するには、接続先クラスタの kubeconfig が必要です。kubeconfig には cluster、user、context が含まれます。

kubectl config view --raw
mkdir -p ${HOME}/.kube
chmod 700 ${HOME}/.kube

接続先を確認する

kubectl config current-context
kubectl config get-contexts
kubectl cluster-info
kubectl get node -o wide

複数クラスタを扱う場合

複数クラスタを扱う場合は、context 名を分かりやすくしておくことが重要です。クラスタ名や context 名が似ていると、意図しないクラスタで操作する危険があります。

kubectl config use-context <context-name>
kubectl config rename-context <old-context> <new-context>

まとめ

kubectl は単なるコマンドではなく、Kubernetes API への操作入口です。管理端末、kubeconfig、context、権限を整理しておくことで、複数クラスタを扱う場合でも誤操作を減らせます。

関連記事

Kubernetes MetalLB の導入 – LoadBalancer Service をオンプレ環境で成立させる Kubernetes Helm の導入 – Chart でアプリケーション構成を管理する Kubernetes Multus の導入 – Pod に複数 NIC を接続する Kubernetes kubeconfig の管理 – 複数クラスタと context を整理する Kubernetes 構築・運用ガイド – オンプレ環境のクラスタ設計を整理する Kubernetes マニフェストの apiVersion を理解する Kubernetes コントロールプレーンノードを追加できない場合 – kubeadm-certs を再生成する Kubernetes Nginx コンテナの実行 – Deployment で Pod を管理する