10 KiB
| title | content_type | weight |
|---|---|---|
| macOS上でのkubectlのインストールおよびセットアップ | task | 10 |
{{% heading "prerequisites" %}}
kubectlのバージョンは、クラスターのマイナーバージョンとの差分が1つ以内でなければなりません。 たとえば、クライアントがv{{< skew currentVersion >}}であれば、v{{< skew currentVersionAddMinor -1 >}}、v{{< skew currentVersionAddMinor 0 >}}、v{{< skew currentVersionAddMinor 1 >}}のコントロールプレーンと通信できます。 最新の互換性のあるバージョンのkubectlを使うことで、不測の事態を避けることができるでしょう。
macOSへkubectlをインストールする
macOSへkubectlをインストールするには、次の方法があります:
curlを使用してmacOSへkubectlのバイナリをインストールする
-
最新リリースをダウンロードしてください:
{{< tabs name="download_binary_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl" {{< /tab >}} {{< tab name="Appleシリコン" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl" {{< /tab >}} {{< /tabs >}}
{{< note >}} 特定のバージョンをダウンロードする場合、コマンドの
$(curl -L -s https://dl.k8s.io/release/stable.txt)の部分を特定のバージョンに置き換えてください。例えば、Intel macOSへ{{< skew currentPatchVersion >}}のバージョンをダウンロードするには、次のコマンドを入力します:
curl -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/darwin/amd64/kubectl"Appleシリコン上のmacOSに対しては、次を入力します:
curl -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/darwin/arm64/kubectl"{{< /note >}}
-
バイナリを検証してください(オプション)
kubectlのチェックサムファイルをダウンロードします:
{{< tabs name="download_checksum_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl.sha256" {{< /tab >}} {{< tab name="Appleシリコン" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl.sha256" {{< /tab >}} {{< /tabs >}}
チェックサムファイルに対してkubectlバイナリを検証します:
echo "$(cat kubectl.sha256) kubectl" | shasum -a 256 --check正しければ、出力は次のようになります:
kubectl: OKチェックに失敗すると、
shasumは0以外のステータスで終了し、次のような出力を表示します:kubectl: FAILED shasum: WARNING: 1 computed checksum did NOT match{{< note >}} 同じバージョンのバイナリとチェックサムをダウンロードしてください。 {{< /note >}}
-
kubectlバイナリを実行可能にしてください。
chmod +x ./kubectl -
kubectlバイナリを
PATHの中に移動させてください。sudo mv ./kubectl /usr/local/bin/kubectl sudo chown root: /usr/local/bin/kubectl{{< note >}}
/usr/local/binがPATH環境変数の中に含まれるようにしてください。 {{< /note >}} -
インストールしたバージョンが最新であることを確認してください:
kubectl version --clientまたは、バージョンの詳細を表示するために次を使用します:
kubectl version --client --output=yaml -
kubectlをインストールし、検証した後は、チェックサムファイルを削除してください:
rm kubectl.sha256
Homebrewを使用してmacOSへインストールする
macOSでHomebrewパッケージマネージャーを使用していれば、Homebrewでkubectlをインストールできます。
-
インストールコマンドを実行してください:
brew install kubectlまたは
brew install kubernetes-cli -
インストールしたバージョンが最新であることを確認してください:
kubectl version --client
MacPortsを使用してmacOSへインストールする
macOSでMacPortsパッケージマネージャーを使用していれば、MacPortsでkubectlをインストールできます。
-
インストールコマンドを実行してください:
sudo port selfupdate sudo port install kubectl -
インストールしたバージョンが最新であることを確認してください:
kubectl version --client
kubectlの設定を検証する
{{< include "included/verify-kubectl.md" >}}
オプションのkubectlの設定とプラグイン
シェルの自動補完を有効にする
kubectlはBash、Zsh、Fish、PowerShellの自動補完を提供しています。 これにより、入力を大幅に削減することができます。
以下にBash、Fish、Zshの自動補完の設定手順を示します。
{{< tabs name="kubectl_autocompletion" >}} {{< tab name="Bash" include="included/optional-kubectl-configs-bash-mac.md" />}} {{< tab name="Fish" include="included/optional-kubectl-configs-fish.md" />}} {{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}} {{< /tabs >}}
kubectl convertプラグインをインストールする
{{< include "included/kubectl-convert-overview.md" >}}
-
次のコマンドを使用して最新リリースをダウンロードしてください:
{{< tabs name="download_convert_binary_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert" {{< /tab >}} {{< tab name="Appleシリコン" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert" {{< /tab >}} {{< /tabs >}}
-
バイナリを検証してください(オプション)
kubectl-convertのチェックサムファイルをダウンロードします:
{{< tabs name="download_convert_checksum_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert.sha256" {{< /tab >}} {{< tab name="Appleシリコン" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert.sha256" {{< /tab >}} {{< /tabs >}}
チェックサムファイルに対してkubectl-convertバイナリを検証します:
echo "$(cat kubectl-convert.sha256) kubectl-convert" | shasum -a 256 --check正しければ、出力は次のようになります:
kubectl-convert: OKチェックに失敗すると、
shasumは0以外のステータスで終了し、次のような出力を表示します:kubectl-convert: FAILED shasum: WARNING: 1 computed checksum did NOT match{{< note >}} 同じバージョンのバイナリとチェックサムをダウンロードしてください。 {{< /note >}}
-
kubectl-convertバイナリを実行可能にしてください。
chmod +x ./kubectl-convert -
kubectl-convertバイナリを
PATHの中に移動してください。sudo mv ./kubectl-convert /usr/local/bin/kubectl-convert sudo chown root: /usr/local/bin/kubectl-convert{{< note >}}
/usr/local/binがPATH環境変数の中に含まれるようにしてください。 {{< /note >}} -
インストールしたバージョンが最新であることを確認してください
kubectl convert --help何もエラーが表示されない場合は、プラグインが正常にインストールされたことを示しています。
-
プラグインのインストール後、インストールファイルを削除してください:
rm kubectl-convert kubectl-convert.sha256
macOS上のkubectlをアンインストールする
kubectlのインストール方法に応じて、次の方法を使用してください。
コマンドラインを使用してkubectlをアンインストールする
-
システム上の
kubectlバイナリの場所を特定してください:which kubectl -
kubectlバイナリを削除してください:sudo rm <path><path>を前のステップのkubectlバイナリのパスに置き換えてください。 例えばsudo rm /usr/local/bin/kubectl。
Homebrewを使用してkubectlをアンインストールする
Homebrewを使用してkubectlをインストールした場合は、次のコマンドを実行してください:
brew remove kubectl
{{% heading "whatsnext" %}}
{{< include "included/kubectl-whats-next.md" >}}