のインストールkubectl - Amazon EKS

「翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。」

のインストールkubectl

Kubernetes では、クラスター API サーバーとの通信に kubectl というコマンドラインユーティリティを使用します。kubectl バイナリは、多数のオペレーティングシステムのパッケージで利用できます。このオプションは多くの場合、手動のダウンロードおよびインストールプロセスよりはるかに簡単です。Kubernetes のドキュメントにある個別のオペレーティングシステムやパッケージマネージャー用の手順に従えばインストールできます。

このトピックでは、Amazon EKS 提供の kubectl バイナリを macOS、LinuxWindows オペレーティングシステム用にダウンロードしてインストールします。これらのバイナリは、アップストリームコミュニティのバージョンと同じであり、Amazon EKS または AWS に固有ではありません。

注記

Amazon EKS クラスターコントロールプレーンとのマイナーバージョンの相違が 1 つ以内である kubectl バージョンを使用する必要があります。たとえば、1.17 kubectl クライアントは Kubernetes 1.16、1.17、および 1.18 クラスターで動作します。

と 中国 (寧夏) を除くすべてのリージョン中国 (北京)

リージョンで作業している場合に kubectl をインストールするには、「中国」を参照してください。中国リージョン

[kubectl を macOS にインストールするには]

  1. クラスターの Kubernetes バージョンに応じて、Amazon EKS 提供の kubectl バイナリを Amazon S3 からダウンロードします。

    • Kubernetes 1.18:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/darwin/amd64/kubectl
    • Kubernetes 1.17:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/darwin/amd64/kubectl
    • Kubernetes 1.16:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/darwin/amd64/kubectl
    • Kubernetes 1.15:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.12/2020-11-02/bin/darwin/amd64/kubectl
  2. (オプション) ダウンロードされたバイナリを SHA-256 サムで検証します。

    1. クラスターの Kubernetes バージョンに応じて、SHA-256 sum (macOS 版) をダウンロードします。

      • Kubernetes 1.18:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.17:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.16:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.15:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.12/2020-11-02/bin/darwin/amd64/kubectl.sha256
    2. ダウンロードしたバイナリの SHA-256 サムを確認します。

      openssl sha1 -sha256 kubectl
    3. コマンド出力で生成された SHA-256 sum とダウンロードした SHA-256 ファイルを比較します。両者は一致する必要があります。

  3. バイナリへの実行アクセス権限を適用します。

    chmod +x ./kubectl
  4. バイナリを PATH のフォルダにコピーします。 すでに kubectl のバージョンをインストールしている場合は、$HOME/bin/kubectl を作成し、$HOME/bin の先頭が $PATH になるようにすることをお勧めします。

    mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin
  5. (オプション) シェルを開いたときに設定されるように、シェルの初期化ファイルに $HOME/bin パスを追加します。

    echo 'export PATH=$PATH:$HOME/bin' >> ~/.bash_profile
  6. kubectl をインストールしたら、以下のコマンドを使用してバージョンを確認できます。

    kubectl version --short --client

[Linux に kubectl をインストールするには]

  1. によって提供された Amazon EKS kubectl バイナリを、クラスターの Kubernetes バージョン用に からダウンロードします。Amazon S3Arm バージョンをダウンロードするには、コマンドを実行する前に amd64arm64 に変更します。

    • Kubernetes 1.18:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl
    • Kubernetes 1.17:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/amd64/kubectl
    • Kubernetes 1.16:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/linux/amd64/kubectl
    • Kubernetes 1.15:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.12/2020-11-02/bin/linux/amd64/kubectl
  2. (オプション) ダウンロードされたバイナリを SHA-256 サムで検証します。

    1. クラスターの Kubernetes バージョンに応じて、SHA-256 sum (Linux 版) をダウンロードします。Arm バージョンをダウンロードするには、コマンドを実行する前に <amd64>arm64 に変更します。

      • Kubernetes 1.18:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/linux/amd64/kubectl.sha256
      • Kubernetes 1.17:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/linux/amd64/kubectl.sha256
      • Kubernetes 1.16:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/linux/amd64/kubectl.sha256
      • Kubernetes 1.15:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.12/2020-11-02/bin/linux/amd64/kubectl.sha256
    2. ダウンロードしたバイナリの SHA-256 サムを確認します。

      openssl sha1 -sha256 kubectl
    3. コマンド出力で生成された SHA-256 sum とダウンロードした SHA-256 ファイルを比較します。両者は一致する必要があります。

  3. バイナリへの実行アクセス権限を適用します。

    chmod +x ./kubectl
  4. バイナリを PATH のフォルダにコピーします。 すでに kubectl のバージョンをインストールしている場合は、$HOME/bin/kubectl を作成し、$HOME/bin の最初が $PATH であることを確認することをお勧めします。

    mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin
  5. (オプション) シェルを開いたときに設定されるように、シェルの初期化ファイルに $HOME/bin パスを追加します。

    注記

    このステップでは、Bash シェルを使用していることを前提としています。別のシェルを使用している場合は、特定のシェル初期化ファイルを使用するよう、コマンドを変更します。

    echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc
  6. kubectl をインストールしたら、以下のコマンドを使用してそのバージョンを確認できます。

    kubectl version --short --client

[Windows に kubectl をインストールするには]

  1. ターミナルを開きます。PowerShell

  2. クラスターの Kubernetes バージョンに応じて、Amazon EKS 提供の kubectl バイナリを Amazon S3 からダウンロードします。

    • Kubernetes 1.18:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.17:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.16:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.15:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.12/2020-11-02/bin/windows/amd64/kubectl.exe
  3. (オプション) ダウンロードされたバイナリを SHA-256 サムで検証します。

    1. クラスターの Kubernetes バージョンに応じて、SHA-256 sum (Windows 版) をダウンロードします。

      • Kubernetes 1.18:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.17:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.16:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.15/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.15:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.12/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
    2. ダウンロードしたバイナリの SHA-256 サムを確認します。

      Get-FileHash kubectl.exe
    3. コマンド出力で生成された SHA-256 sum とダウンロードした SHA-256 ファイルを比較します。出力は大文字になりますが、2 つが一致する必要があります。PowerShell

  4. バイナリを PATH のフォルダにコピーします。 コマンドラインユーティリティで使用する PATH 内に既存のディレクトリがある場合、そのディレクトリにバイナリをコピーします。それ以外の場合は、以下のステップを完了します。

    1. コマンドラインのバイナリ用に新しいディレクトリ (C:\bin など) を作成します。

    2. kubectl.exe バイナリを新しいディレクトリにコピーします。

    3. ユーザーまたはシステムの PATH 環境変数を編集し、新しいディレクトリを PATH に追加します。

    4. 新しい PATH 変数を取得するには、PowerShell ターミナルを閉じ、新しいターミナルを開きます。

  5. kubectl をインストールしたら、以下のコマンドを使用してそのバージョンを確認できます。

    kubectl version --short --client

中国リージョン

または 中国 (北京) リージョンを使用している場合は、以下の手順を実行します。中国 (寧夏)他のリージョンで kubectl をインストールするには、「と 中国 (寧夏) を除くすべてのリージョン中国 (北京) 」を参照してください。

[kubectl を macOS にインストールするには]

  1. クラスターの Kubernetes バージョンに応じて、Amazon EKS 提供の kubectl バイナリを Amazon S3 からダウンロードします。

    • Kubernetes 1.18:

      curl -o kubectl https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.18.9/2020-11-02/bin/darwin/amd64/kubectl
    • Kubernetes 1.17:

      curl -o kubectl https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.17.12/2020-11-02/bin/darwin/amd64/kubectl
    • Kubernetes 1.16:

      curl -o kubectl https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.16.15/2020-11-02/bin/darwin/amd64/kubectl
    • Kubernetes 1.15:

      curl -o kubectl https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.15.12/2020-11-02/bin/darwin/amd64/kubectl
  2. (オプション) ダウンロードされたバイナリを SHA-256 サムで検証します。

    1. クラスターの Kubernetes バージョンに応じて、SHA-256 sum (macOS 版) をダウンロードします。

      • Kubernetes 1.18:

        curl -o kubectl.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.18.9/2020-11-02/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.17:

        curl -o kubectl.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.17.12/2020-11-02/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.16:

        curl -o kubectl.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.16.15/2020-11-02/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.15:

        curl -o kubectl.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.15.12/2020-11-02/bin/darwin/amd64/kubectl.sha256
    2. ダウンロードしたバイナリの SHA-256 サムを確認します。

      openssl sha1 -sha256 kubectl
    3. コマンド出力で生成された SHA-256 sum とダウンロードした SHA-256 ファイルを比較します。両者は一致する必要があります。

  3. バイナリへの実行アクセス権限を適用します。

    chmod +x ./kubectl
  4. バイナリを PATH のフォルダにコピーします。 すでに kubectl のバージョンをインストールしている場合は、$HOME/bin/kubectl を作成し、$HOME/bin の先頭が $PATH になるようにすることをお勧めします。

    mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin
  5. (オプション) シェルを開いたときに設定されるように、シェルの初期化ファイルに $HOME/bin パスを追加します。

    echo 'export PATH=$PATH:$HOME/bin' >> ~/.bash_profile
  6. kubectl をインストールしたら、以下のコマンドを使用してそのバージョンを確認できます。

    kubectl version --short --client

[Linux に kubectl をインストールするには]

  1. によって発行された Amazon EKS kubectl バイナリを、クラスターの Kubernetes バージョン用に からダウンロードします。Amazon S3Arm のバージョンをダウンロードするには、コマンドを実行する前に amd64arm64 に変更します。

    • Kubernetes 1.18:

      curl -o kubectl https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.18.9/2020-11-02/bin/linux/amd64/kubectl
    • Kubernetes 1.17:

      curl -o kubectl https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.17.12/2020-11-02/bin/linux/amd64/kubectl
    • Kubernetes 1.16:

      curl -o kubectl https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.16.15/2020-11-02/bin/linux/amd64/kubectl
    • Kubernetes 1.15:

      curl -o kubectl https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.15.12/2020-11-02/bin/linux/amd64/kubectl
  2. (オプション) ダウンロードされたバイナリを SHA-256 サムで検証します。

    1. クラスターの Kubernetes バージョンに応じて、SHA-256 sum (Linux 版) をダウンロードします。Arm バージョンをダウンロードするには、コマンドを実行する前に <amd64>arm64 に変更します。

      • Kubernetes 1.18:

        curl -o kubectl.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.18.9/2020-11-02/bin/linux/amd64/kubectl.sha256
      • Kubernetes 1.17:

        curl -o kubectl.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.17.12/2020-11-02/bin/linux/amd64/kubectl.sha256
      • Kubernetes 1.16:

        curl -o kubectl.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.16.15/2020-11-02/bin/linux/amd64/kubectl.sha256
      • Kubernetes 1.15:

        curl -o kubectl.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.15.12/2020-11-02/bin/linux/amd64/kubectl.sha256
    2. ダウンロードしたバイナリの SHA-256 サムを確認します。

      openssl sha1 -sha256 kubectl
    3. コマンド出力で生成された SHA-256 sum とダウンロードした SHA-256 ファイルを比較します。両者は一致する必要があります。

  3. バイナリへの実行アクセス権限を適用します。

    chmod +x ./kubectl
  4. バイナリを PATH のフォルダにコピーします。 すでに kubectl のバージョンをインストールしている場合は、$HOME/bin/kubectl を作成し、$HOME/bin の先頭が $PATH になるようにすることをお勧めします。

    mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin
  5. (オプション) シェルを開いたときに設定されるように、シェルの初期化ファイルに $HOME/bin パスを追加します。

    注記

    このステップでは、Bash シェルを使用していることを前提としています。別のシェルを使用している場合は、特定のシェル初期化ファイルを使用するよう、コマンドを変更します。

    echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc
  6. kubectl をインストールしたら、以下のコマンドを使用してそのバージョンを確認できます。

    kubectl version --short --client

[Windows に kubectl をインストールするには]

  1. ターミナルを開きます。PowerShell

  2. クラスターの Kubernetes バージョンに応じて、Amazon EKS 提供の kubectl バイナリを Amazon S3 からダウンロードします。

    • Kubernetes 1.18:

      curl -o kubectl.exe https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.17:

      curl -o kubectl.exe https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.16:

      curl -o kubectl.exe https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.16.15/2020-11-02/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.15:

      curl -o kubectl.exe https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.15.12/2020-11-02/bin/windows/amd64/kubectl.exe
  3. (オプション) ダウンロードされたバイナリを SHA-256 サムで検証します。

    1. クラスターの Kubernetes バージョンに応じて、SHA-256 sum (Windows 版) をダウンロードします。

      • Kubernetes 1.18:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.18.9/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.17:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.17.12/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.16:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.16.15/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.15:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.cn-north-1.amazonaws.com.cn/1.15.12/2020-11-02/bin/windows/amd64/kubectl.exe.sha256
    2. ダウンロードしたバイナリの SHA-256 サムを確認します。

      Get-FileHash kubectl.exe
    3. コマンド出力で生成された SHA-256 sum とダウンロードした SHA-256 ファイルを比較します。出力は大文字になりますが、2 つが一致する必要があります。PowerShell

  4. バイナリを PATH のフォルダにコピーします。 コマンドラインユーティリティで使用する PATH 内に既存のディレクトリがある場合、そのディレクトリにバイナリをコピーします。それ以外の場合は、以下のステップを完了します。

    1. コマンドラインのバイナリ用に新しいディレクトリ (C:\bin など) を作成します。

    2. kubectl.exe バイナリを新しいディレクトリにコピーします。

    3. ユーザーまたはシステムの PATH 環境変数を編集し、新しいディレクトリを PATH に追加します。

    4. 新しい PATH 変数を取得するには、PowerShell ターミナルを閉じ、新しいターミナルを開きます。

  5. kubectl をインストールしたら、以下のコマンドを使用してそのバージョンを確認できます。

    kubectl version --short --client