7.5 KiB
| title | content_type | weight |
|---|---|---|
| Windows上でのkubectlのインストールおよびセットアップ | task | 10 |
{{% heading "prerequisites" %}}
kubectlのバージョンは、クラスターのマイナーバージョンとの差分が1つ以内でなければなりません。 たとえば、クライアントがv{{< skew currentVersion >}}であれば、v{{< skew currentVersionAddMinor -1 >}}、v{{< skew currentVersionAddMinor 0 >}}、v{{< skew currentVersionAddMinor 1 >}}のコントロールプレーンと通信できます。 最新の互換性のあるバージョンのkubectlを使うことで、不測の事態を避けることができるでしょう。
Windowsへkubectlをインストールする
Windowsへkubectlをインストールするには、次の方法があります:
curlを使用してWindowsへkubectlのバイナリをインストールする
-
最新の{{< skew currentVersion >}}のパッチリリースをダウンロードしてください: [kubectl {{< skew currentPatchVersion >}}](https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl.exe)。
または、
curlがインストールされていれば、次のコマンドも使用できます:curl.exe -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl.exe"{{< note >}} 最新の安定版を入手する際は(たとえばスクリプトで使用する場合)、https://dl.k8s.io/release/stable.txtを参照してください。 {{< /note >}}
-
バイナリを検証してください(オプション)
kubectlのチェックサムファイルをダウンロードします:curl.exe -LO "https://dl.k8s.io/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl.exe.sha256"チェックサムファイルに対して
kubectlバイナリを検証します:-
コマンドプロンプトを使用して、
CertUtilの出力とダウンロードしたチェックサムファイルを手動で比較します:CertUtil -hashfile kubectl.exe SHA256 type kubectl.exe.sha256 -
PowerShellにて
-eqオペレーターを使用して自動で検証を行い、TrueまたはFalseで結果を取得します:$(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256)
-
-
kubectlバイナリのフォルダーをPATH環境変数に追加します。 -
kubectlのバージョンがダウンロードしたものと同じであることを確認してください:kubectl version --clientまたは、バージョンの詳細を表示するために次を使用します:
kubectl version --client --output=yaml
{{< note >}}
Docker Desktop for Windowsは、それ自身のバージョンのkubectlをPATHに追加します。
Docker Desktopをすでにインストールしている場合、Docker Desktopインストーラーによって追加されたPATHの前に追加するか、Docker Desktopのkubectlを削除してください。
{{< /note >}}
Chocolatey、Scoopまたはwingetを使用してWindowsへインストールする
-
Windowsへkubectlをインストールするために、ChocolateyパッケージマネージャーやScoopコマンドラインインストーラー、wingetパッケージマネージャーを使用することもできます。
{{< tabs name="kubectl_win_install" >}} {{% tab name="choco" %}}
choco install kubernetes-cli{{% /tab %}} {{% tab name="scoop" %}}
scoop install kubectl{{% /tab %}} {{% tab name="winget" %}}
winget install -e --id Kubernetes.kubectl{{% /tab %}} {{< /tabs >}}
-
インストールしたバージョンが最新であることを確認してください:
kubectl version --client -
ホームディレクトリへ移動してください:
# cmd.exeを使用している場合はcd %USERPROFILE%を実行してください。 cd ~ -
.kubeディレクトリを作成してください:mkdir .kube -
作成した
.kubeディレクトリへ移動してください:cd .kube -
リモートのKubernetesクラスターを使うために、kubectlを設定してください:
New-Item config -type file
{{< note >}} Notepadなどの選択したテキストエディターから設定ファイルを編集してください。 {{< /note >}}
kubectlの設定を検証する
{{< include "included/verify-kubectl.md" >}}
オプションのkubectlの設定とプラグイン
シェルの自動補完を有効にする
kubectlはBash、Zsh、Fish、PowerShellの自動補完を提供しています。 これにより、入力を大幅に削減することができます。
以下にPowerShellの自動補完の設定手順を示します。
{{< include "included/optional-kubectl-configs-pwsh.md" >}}
kubectl convertプラグインをインストールする
{{< include "included/kubectl-convert-overview.md" >}}
-
次のコマンドを使用して最新リリースをダウンロードしてください:
curl.exe -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl-convert.exe" -
バイナリを検証してください(オプション)。
kubectl-convertのチェックサムファイルをダウンロードします:curl.exe -LO "https://dl.k8s.io/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl-convert.exe.sha256"チェックサムファイルに対して
kubectl-convertバイナリを検証します:-
コマンドプロンプトを使用して、
CertUtilの出力とダウンロードしたチェックサムファイルを手動で比較します:CertUtil -hashfile kubectl-convert.exe SHA256 type kubectl-convert.exe.sha256 -
PowerShellにて
-eqオペレーターを使用して自動で検証を行い、TrueまたはFalseで結果を取得します:$($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256)
-
-
kubectl-convertバイナリのフォルダーをPATH環境変数に追加します。 -
プラグインが正常にインストールされたことを確認してください。
kubectl convert --help何もエラーが表示されない場合は、プラグインが正常にインストールされたことを示しています。
-
プラグインのインストール後、インストールファイルを削除してください:
del kubectl-convert.exe del kubectl-convert.exe.sha256
{{% heading "whatsnext" %}}
{{< include "included/kubectl-whats-next.md" >}}