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

Kubernetesのコマンドラインツールであるkubectlを使用して、Kubernetesクラスターに対してコマンドを実行することができます。kubectlによってアプリケーションのデプロイや、クラスターのリソース管理、検査およびログの表示を行うことができます。kubectlの操作に関する完全なリストは、kubectlリファレンスドキュメントを参照してください。

始める前に

kubectlのバージョンは、クラスターのマイナーバージョンとの差分が1つ以内でなければなりません。たとえば、クライアントがv1.2であれば、v1.1、v1.2、v1.3のマスターで動作するはずです。最新バージョンのkubectlを使うことで、不測の事態を避けることができるでしょう。

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

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

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

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

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

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

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

2. kubectlバイナリを実行可能にしてください。

   chmod +x ./kubectl
   

3. バイナリをPATHの中に移動させてください。

   sudo mv ./kubectl /usr/local/bin/kubectl
   

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

   kubectl version --client
   

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

• Ubuntu、DebianまたはHypriotOS
• CentOS、RHELまたはFedora

sudo apt-get update && sudo apt-get install -y apt-transport-https gnupg2
curl -s https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee -a /etc/apt/sources.list.d/kubernetes.list
sudo apt-get update
sudo apt-get install -y kubectl

cat <<EOF > /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF
yum install -y kubectl

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

• Snap
• Homebrew

snap install kubectl --classic

kubectl version --client

brew install kubectl

kubectl version --client

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

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

1. 最新リリースをダウンロードしてください:

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

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

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

    curl -LO https://dl.k8s.io/release/v1.27.4/bin/darwin/amd64/kubectl
   

2. kubectlバイナリを実行可能にしてください。

   chmod +x ./kubectl
   

3. バイナリをPATHの中に移動させてください。

   sudo mv ./kubectl /usr/local/bin/kubectl
   

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

   kubectl version --client
   

Homebrewを使用してmacOSへインストールする

macOSでHomebrewパッケージマネージャーを使用していれば、Homebrewでkubectlをインストールすることもできます。

1. インストールコマンドを実行してください:

   brew install kubectl
   

   または

   brew install kubernetes-cli
   

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

   kubectl version --client
   

MacPortsを使用してmacOSへインストールする

macOSでMacPortsパッケージマネージャーを使用していれば、MacPortsでkubectlをインストールすることもできます。

1. インストールコマンドを実行してください:

   sudo port selfupdate
   sudo port install kubectl
   

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

   kubectl version --client
   

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

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

1. こちらのリンクから、最新リリースである1.27.4をダウンロードしてください。

   または、curlをインストールされていれば、次のコマンドも使用できます:

   curl -LO https://dl.k8s.io/release/v1.27.4/bin/windows/amd64/kubectl.exe
   

   最新の安定版を入手する際は(たとえばスクリプトで使用する場合)、https://dl.k8s.io/release/stable.txtを参照してください。

2. バイナリをPATHに追加します

3. kubectlのバージョンがダウンロードしたものと同じであることを確認してください:

   kubectl version --client
   

PSGalleryからPowerShellを使用してインストールする

WindowsでPowershell Galleryパッケージマネージャーを使用していれば、Powershellでkubectlをインストールおよびアップデートすることもできます。

1. インストールコマンドを実行してください(必ずDownloadLocationを指定してください):

   Install-Script -Name 'install-kubectl' -Scope CurrentUser -Force
   install-kubectl.ps1 [-DownloadLocation <path>]
   

   備考: DownloadLocationを指定しない場合、kubectlはユーザのTempディレクトリにインストールされます。

   インストーラーは$HOME/.kubeを作成し、設定ファイルを作成します。

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

   kubectl version --client
   

ChocolateyまたはScoopを使用してWindowsへインストールする

1. Windowsへkubectlをインストールするために、ChocolateyパッケージマネージャーやScoopコマンドラインインストーラーを使用することもできます。

   • choco
   • scoop

   choco install kubernetes-cli
   

   scoop install kubectl
   

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

   kubectl version --client
   

3. ホームディレクトリへ移動してください:

   # cmd.exeを使用している場合は cd %USERPROFILE% を実行してください。
   cd ~
   

4. .kubeディレクトリを作成してください:

   mkdir .kube
   

5. 作成した.kubeディレクトリへ移動してください:

   cd .kube
   

6. リモートのKubernetesクラスターを使うために、kubectlを設定してください:

   New-Item config -type file
   

Google Cloud SDKの一部としてダウンロードする

Google Cloud SDKの一部として、kubectlをインストールすることもできます。

1. Google Cloud SDKをインストールしてください。

2. kubectlのインストールコマンドを実行してください:

   gcloud components install kubectl
   

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

   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

kubectlの任意の設定

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

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

以下にBash(LinuxとmacOSの違いも含む)およびZshの自動補完の設定手順を示します。

• LinuxでのBash
• macOSでのBash
• Zsh

source /usr/share/bash-completion/bash_completion

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

echo $BASH_VERSION

brew install bash

echo $BASH_VERSION $SHELL

brew install bash-completion@2

export BASH_COMPLETION_COMPAT_DIR="/usr/local/etc/bash_completion.d"
[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"

source <(kubectl completion zsh)

echo 'alias k=kubectl' >>~/.zshrc
echo 'compdef __start_kubectl k' >>~/.zshrc

autoload -Uz compinit
compinit