Linux上でのkubectlのインストールおよびセットアップ

始める前に

kubectlのバージョンは、クラスターのマイナーバージョンとの差分が1つ以内でなければなりません。 たとえば、クライアントがv1.31であれば、v1.30、v1.31、v1.32のコントロールプレーンと通信できます。 最新の互換性のあるバージョンのkubectlを使うことで、不測の事態を避けることができるでしょう。

Linuxへkubectlをインストールする

Linuxへkubectlをインストールするには、次の方法があります:

• curlを使用してLinuxへkubectlのバイナリをインストールする
• ネイティブなパッケージマネージャーを使用してインストールする
• 他のパッケージマネージャーを使用してインストールする

curlを使用してLinuxへkubectlのバイナリをインストールする

1. 次のコマンドにより、最新リリースをダウンロードしてください:

   • x86-64
   • ARM64

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
      

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl"
      

   備考:

   特定のバージョンをダウンロードする場合、コマンドの$(curl -L -s https://dl.k8s.io/release/stable.txt)の部分を特定のバージョンに書き換えてください。

   たとえば、Linux x86-64へ1.31.0のバージョンをダウンロードするには、次のコマンドを入力します:

   curl -LO https://dl.k8s.io/release/v1.31.0/bin/linux/amd64/kubectl
   

   そして、Linux ARM64に対しては、次のコマンドを入力します:

   curl -LO https://dl.k8s.io/release/v1.31.0/bin/linux/arm64/kubectl
   

2. バイナリを検証してください(オプション)

   kubectlのチェックサムファイルをダウンロードします:

   • x86-64
   • ARM64

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
      

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl.sha256"
      

   チェックサムファイルに対してkubectlバイナリを検証します:

   echo "$(cat kubectl.sha256)  kubectl" | sha256sum --check
   

   正しければ、出力は次のようになります:

   kubectl: OK
   

   チェックに失敗すると、sha256は0以外のステータスで終了し、次のような出力を表示します:

   kubectl: FAILED
   sha256sum: WARNING: 1 computed checksum did NOT match
   

   備考:

   同じバージョンのバイナリとチェックサムをダウンロードしてください。

3. kubectlをインストールしてください

   sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
   

   備考:

   ターゲットシステムにルートアクセスを持っていない場合でも、~/.local/binディレクトリにkubectlをインストールできます:

   chmod +x kubectl
   mkdir -p ~/.local/bin
   mv ./kubectl ~/.local/bin/kubectl
   # そして ~/.local/bin を $PATH の末尾 (または先頭) に追加します
   

4. インストールしたバージョンが最新であることを確認してください:

   kubectl version --client
   

   または、バージョンの詳細を表示するために次を使用します:

   kubectl version --client --output=yaml
   

ネイティブなパッケージマネージャーを使用してインストールする

• Debianベースのディストリビューション
• Red Hatベースのディストリビューション
• SUSEベースのディストリビューション

他のパッケージマネージャーを使用してインストールする

• Snap
• Homebrew

snap install kubectl --classic
kubectl version --client

brew install kubectl
kubectl version --client

kubectlの設定を検証する

kubectlがKubernetesクラスターを探索し接続するために、kubeconfigファイルが必要です。 これは、kube-up.shによりクラスターを作成した際や、Minikubeクラスターを正常にデプロイした際に自動生成されます。 デフォルトでは、kubectlの設定は~/.kube/configに格納されています。

クラスターの状態を取得し、kubectlが適切に設定されていることを確認してください:

kubectl cluster-info

URLのレスポンスが表示されている場合は、kubectlはクラスターに接続するよう正しく設定されています。

以下のようなメッセージが表示されている場合は、kubectlは正しく設定されていないか、Kubernetesクラスターに接続できていません。

The connection to the server <server-name:port> was refused - did you specify the right host or port?

たとえば、ラップトップ上(ローカル環境)でKubernetesクラスターを起動するような場合、Minikubeなどのツールを最初にインストールしてから、上記のコマンドを再実行する必要があります。

kubectl cluster-infoがURLレスポンスを返したにもかかわらずクラスターにアクセスできない場合は、次のコマンドで設定が正しいことを確認してください:

kubectl cluster-info dump

エラーメッセージ'No Auth Provider Found'のトラブルシューティング

Kubernetes 1.26にて、kubectlは以下のクラウドプロバイダーが提供するマネージドKubernetesのビルトイン認証を削除しました。 これらのプロバイダーは、クラウド固有の認証を提供するkubectlプラグインをリリースしています。 手順については以下のプロバイダーのドキュメントを参照してください:

• Azure AKS: kubelogin plugin
• Google Kubernetes Engine: gke-gcloud-auth-plugin

(この変更とは関係なく、他の理由で同じエラーメッセージが表示される可能性もあります。)

オプションのkubectlの設定とプラグイン

シェルの自動補完を有効にする

kubectlはBash、Zsh、Fish、PowerShellの自動補完を提供しています。 これにより、入力を大幅に削減することができます。

以下にBash、Fish、Zshの自動補完の設定手順を示します。

• Bash
• Fish
• Zsh

source /usr/share/bash-completion/bash_completion

echo 'source <(kubectl completion bash)' >>~/.bashrc

kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl > /dev/null
sudo chmod a+r /etc/bash_completion.d/kubectl

echo 'alias k=kubectl' >>~/.bashrc
echo 'complete -o default -F __start_kubectl k' >>~/.bashrc

source ~/.bashrc

kubectl completion fish | source

source <(kubectl completion zsh)

autoload -Uz compinit
compinit

kubectl convertプラグインをインストールする

異なるAPIバージョン間でマニフェストを変換できる、Kubernetesコマンドラインツールkubectlのプラグインです。 これは特に、新しいKubernetesのリリースで、非推奨ではないAPIバージョンにマニフェストを移行する場合に役に立ちます。 詳細については非推奨ではないAPIへの移行を参照してください。

1. 次のコマンドを使用して最新リリースをダウンロードしてください:

   • x86-64
   • ARM64

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"
      

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl-convert"
      

2. バイナリを検証してください(オプション)

   kubectl-convertのチェックサムファイルをダウンロードします:

   • x86-64
   • ARM64

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert.sha256"
      

   
      curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl-convert.sha256"
      

   チェックサムファイルに対してkubectl-convertバイナリを検証します:

   echo "$(cat kubectl-convert.sha256) kubectl-convert" | sha256sum --check
   

   正しければ、出力は次のようになります:

   kubectl-convert: OK
   

   チェックに失敗すると、sha256は0以外のステータスで終了し、次のような出力を表示します:

   kubectl-convert: FAILED
   sha256sum: WARNING: 1 computed checksum did NOT match
   

   備考:

   同じバージョンのバイナリとチェックサムをダウンロードしてください。

3. kubectl-convertをインストールしてください

   sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert
   

4. プラグインが正常にインストールできたことを確認してください

   kubectl convert --help
   

   何もエラーが表示されない場合は、プラグインが正常にインストールされたことを示しています。

5. プラグインのインストール後、インストールファイルを削除してください:

   rm kubectl-convert kubectl-convert.sha256
   

次の項目

• Minikubeをインストールする
• クラスターの作成に関する詳細をスタートガイドで確認する。
• アプリケーションを起動して公開する方法を学ぶ。
• あなたが作成していないクラスターにアクセスする必要がある場合は、クラスターアクセスドキュメントの共有を参照してください。
• kubectlリファレンスドキュメントを参照する