# Windows上でのkubectlのインストールおよびセットアップ LLMS index: [llms.txt](/llms.txt) --- ## 始める前に kubectlのバージョンは、クラスターのマイナーバージョンとの差分が1つ以内でなければなりません。 たとえば、クライアントがv1.36であれば、v1.35、v1.36、v1.37のコントロールプレーンと通信できます。 最新の互換性のあるバージョンのkubectlを使うことで、不測の事態を避けることができるでしょう。 ## Windowsへkubectlをインストールする Windowsへkubectlをインストールするには、次の方法があります: - [curlを使用してWindowsへkubectlのバイナリをインストールする](#install-kubectl-binary-with-curl-on-windows) - [Chocolatey、Scoopまたはwingetを使用してWindowsへインストールする](#install-nonstandard-package-tools) ### curlを使用してWindowsへkubectlのバイナリをインストールする{#install-kubectl-binary-with-curl-on-windows} 1. 最新の1.36のパッチリリースをダウンロードしてください: [kubectl 1.36.0](https://dl.k8s.io/release/v1.36.0/bin/windows/amd64/kubectl.exe)。 または、`curl`がインストールされていれば、次のコマンドも使用できます: ```powershell curl.exe -LO "https://dl.k8s.io/release/v1.36.0/bin/windows/amd64/kubectl.exe" ```

備考:

最新の安定版を入手する際は(たとえばスクリプトで使用する場合)、https://dl.k8s.io/release/stable.txtを参照してください。
1. バイナリを検証してください(オプション) `kubectl`のチェックサムファイルをダウンロードします: ```powershell curl.exe -LO "https://dl.k8s.io/v1.36.0/bin/windows/amd64/kubectl.exe.sha256" ``` チェックサムファイルに対して`kubectl`バイナリを検証します: - コマンドプロンプトを使用して、`CertUtil`の出力とダウンロードしたチェックサムファイルを手動で比較します: ```cmd CertUtil -hashfile kubectl.exe SHA256 type kubectl.exe.sha256 ``` - PowerShellにて`-eq`オペレーターを使用して自動で検証を行い、`True`または`False`で結果を取得します: ```powershell $(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256) ``` 1. `kubectl`バイナリのフォルダーを`PATH`環境変数に追加します。 1. `kubectl`のバージョンがダウンロードしたものと同じであることを確認してください: ```cmd kubectl version --client ``` または、バージョンの詳細を表示するために次を使用します: ```cmd kubectl version --client --output=yaml ```

備考:

Docker Desktop for Windowsは、それ自身のバージョンのkubectlをPATHに追加します。 Docker Desktopをすでにインストールしている場合、Docker Desktopインストーラーによって追加されたPATHの前に追加するか、Docker Desktopのkubectlを削除してください。
### Chocolatey、Scoopまたはwingetを使用してWindowsへインストールする{#install-nonstandard-package-tools} 1. Windowsへkubectlをインストールするために、[Chocolatey](https://chocolatey.org)パッケージマネージャーや[Scoop](https://scoop.sh)コマンドラインインストーラー、[winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/)パッケージマネージャーを使用することもできます。 
choco install kubernetes-cli

scoop install kubectl

winget install -e --id Kubernetes.kubectl
1. インストールしたバージョンが最新であることを確認してください: ```powershell kubectl version --client ``` 1. ホームディレクトリへ移動してください: ```powershell # cmd.exeを使用している場合はcd %USERPROFILE%を実行してください。 cd ~ ``` 1. `.kube`ディレクトリを作成してください: ```powershell mkdir .kube ``` 1. 作成した`.kube`ディレクトリへ移動してください: ```powershell cd .kube ``` 1. リモートのKubernetesクラスターを使うために、kubectlを設定してください: ```powershell New-Item config -type file ```

備考:

Notepadなどの選択したテキストエディターから設定ファイルを編集してください。
## 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プラグインをリリースしています。 手順については以下のプロバイダーのドキュメントを参照してください:

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

## オプションのkubectlの設定とプラグイン ### シェルの自動補完を有効にする kubectlはBash、Zsh、Fish、PowerShellの自動補完を提供しています。 これにより、入力を大幅に削減することができます。 以下にPowerShellの自動補完の設定手順を示します。

PowerShellにおけるkubectlの補完スクリプトはkubectl completion powershellコマンドで生成できます。

すべてのシェルセッションでこれを行うには、次の行を$PROFILEファイルに追加します。

kubectl completion powershell | Out-String | Invoke-Expression

このコマンドは、PowerShellを起動する度に自動補完のスクリプトを再生成します。 生成されたスクリプトを直接$PROFILEファイルに追加することもできます。

生成されたスクリプトを$PROFILEファイルに追加するためには、PowerShellのプロンプトで次の行を実行します:

kubectl completion powershell >> $PROFILE

シェルをリロードした後、kubectlの自動補完が機能します。

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

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

1. 次のコマンドを使用して最新リリースをダウンロードしてください: ```powershell curl.exe -LO "https://dl.k8s.io/release/v1.36.0/bin/windows/amd64/kubectl-convert.exe" ``` 1. バイナリを検証してください(オプション)。 `kubectl-convert`のチェックサムファイルをダウンロードします: ```powershell curl.exe -LO "https://dl.k8s.io/v1.36.0/bin/windows/amd64/kubectl-convert.exe.sha256" ``` チェックサムファイルに対して`kubectl-convert`バイナリを検証します: - コマンドプロンプトを使用して、`CertUtil`の出力とダウンロードしたチェックサムファイルを手動で比較します: ```cmd CertUtil -hashfile kubectl-convert.exe SHA256 type kubectl-convert.exe.sha256 ``` - PowerShellにて`-eq`オペレーターを使用して自動で検証を行い、`True`または`False`で結果を取得します: ```powershell $($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256) ``` 1. `kubectl-convert`バイナリのフォルダーを`PATH`環境変数に追加します。 1. プラグインが正常にインストールされたことを確認してください。 ```shell kubectl convert --help ``` 何もエラーが表示されない場合は、プラグインが正常にインストールされたことを示しています。 1. プラグインのインストール後、インストールファイルを削除してください: ```powershell del kubectl-convert.exe del kubectl-convert.exe.sha256 ``` ## 次の項目