安裝 kubectl - Amazon EKS

安裝 kubectl

Kubernetes 使用名為 kubectl 的命令列公用程式與叢集 API 伺服器通訊。kubectl 二進位檔提供多種作業系統套件管理工具適用的版本,此選項通常比手動下載與安裝程序簡便得多。您可以根據具體的作業系統或套件管理工具,依照 Kubernetes 文件的指示進行安裝。

本主題將協助您下載並安裝由 Amazon EKS 所提供適用於 MacOS、Linux 和 Windows 作業系統的 kubectl 二進位檔。這些二進位檔案版本和上游社群版本相同,並非 Amazon EKS 或 AWS 專屬。

注意

您所使用的 kubectl 版本,必須與 Amazon EKS 叢集控制平面的版本差距一個版本以內。例如,1.15 kubectl 用戶端應該使用 Kubernetes 1.14、1.15 和 1.16 叢集。

macOS

在 macOS 上安裝 kubectl

  1. 從 Amazon S3 下載 Amazon EKS 提供之適用您叢集 Kubernetes 版本的 kubectl 二進位檔:

    • Kubernetes 1.16 版:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.8/2020-04-16/bin/darwin/amd64/kubectl
    • Kubernetes 1.15 版:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.10/2020-02-22/bin/darwin/amd64/kubectl
      注意

      您可以將此版本與 1.15.10 和 1.15.11 叢集搭配使用。

    • Kubernetes 1.14 版:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.14.6/2019-08-22/bin/darwin/amd64/kubectl
    • Kubernetes 1.13 版:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.13.8/2019-08-14/bin/darwin/amd64/kubectl
  2. (選用) 使用您的二進位檔 SHA-256 總和,驗證下載的二進位檔。

    1. 若您使用 MacOS,請下載適用您叢集 Kubernetes 版本的 SHA-256 總和:

      • Kubernetes 1.16 版:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.8/2020-04-16/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.15 版:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.10/2020-02-22/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.14 版:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.14.6/2019-08-22/bin/darwin/amd64/kubectl.sha256
      • Kubernetes 1.13 版:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.13.8/2019-08-14/bin/darwin/amd64/kubectl.sha256
    2. 檢查適用您下載的二進位檔的 SHA-256 總和。

      openssl sha1 -sha256 kubectl
    3. 將命令輸出產生的 SHA-256 總和與您下載的 SHA-256 檔案進行比對。兩者應該相符。

  3. 申請此二進位檔的執行許可。

    chmod +x ./kubectl
  4. 將二進位檔複製到 PATH 中的資料夾。如果您已安裝某一版本的 kubectl,建議您建立 $HOME/bin/kubectl 並確認您的 $PATH 中會先出現 $HOME/bin

    mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin
  5. (選用) 將 $HOME/bin 路徑新增到 shell 初始化檔案,因此當您開啟 shell 時,該組態已設定完畢。

    echo 'export PATH=$PATH:$HOME/bin' >> ~/.bash_profile
  6. 安裝 kubectl 之後,您可使用以下命令驗證其版本:

    kubectl version --short --client
Linux

在 Linux 上安裝 kubectl

  1. 從 Amazon S3 下載 Amazon EKS 提供之適用您叢集 Kubernetes 版本的 kubectl 二進位檔:

    • Kubernetes 1.16 版:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.8/2020-04-16/bin/linux/amd64/kubectl
    • Kubernetes 1.15 版:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.10/2020-02-22/bin/linux/amd64/kubectl
      注意

      您可以將此版本與 1.15.10 和 1.15.11 叢集搭配使用。

    • Kubernetes 1.14 版:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.14.6/2019-08-22/bin/linux/amd64/kubectl
    • Kubernetes 1.13 版:

      curl -o kubectl https://amazon-eks.s3.us-west-2.amazonaws.com/1.13.8/2019-08-14/bin/linux/amd64/kubectl
  2. (選用) 使用您的二進位檔 SHA-256 總和,驗證下載的二進位檔。

    1. 若您使用 Linux,請下載適用您叢集 Kubernetes 版本的 SHA-256 總和:

      • Kubernetes 1.16 版:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.8/2020-04-16/bin/linux/amd64/kubectl.sha256
      • Kubernetes 1.15 版:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.10/2020-02-22/bin/linux/amd64/kubectl.sha256
      • Kubernetes 1.14 版:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.14.6/2019-08-22/bin/linux/amd64/kubectl.sha256
      • Kubernetes 1.13 版:

        curl -o kubectl.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.13.8/2019-08-14/bin/linux/amd64/kubectl.sha256
    2. 檢查適用您下載的二進位檔的 SHA-256 總和。

      openssl sha1 -sha256 kubectl
    3. 將命令輸出產生的 SHA-256 總和與您下載的 SHA-256 檔案進行比對。兩者應該相符。

  3. 申請此二進位檔的執行許可。

    chmod +x ./kubectl
  4. 將二進位檔複製到 PATH 中的資料夾。如果您已安裝某一版本的 kubectl,建議您建立 $HOME/bin/kubectl 並確認您的 $PATH 中會先出現 $HOME/bin

    mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$PATH:$HOME/bin
  5. (選用) 將 $HOME/bin 路徑新增到 shell 初始化檔案,因此當您開啟 shell 時,該組態已設定完畢。

    注意

    本步驟假設您是使用 Bash shell;若您使用其他 shell,請將命令更改為使用具體的 shell 初始化檔案。

    echo 'export PATH=$PATH:$HOME/bin' >> ~/.bashrc
  6. 安裝 kubectl 之後,您可使用以下命令驗證其版本:

    kubectl version --short --client
Windows

在 Windows 上安裝 kubectl

  1. 開啟 PowerShell 終端機。

  2. 從 Amazon S3 下載 Amazon EKS 提供之適用您叢集 Kubernetes 版本的 kubectl 二進位檔:

    • Kubernetes 1.16 版:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.8/2020-04-16/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.15 版:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.15.10/2020-02-22/bin/windows/amd64/kubectl.exe
      注意

      您可以將此版本與 1.15.10 和 1.15.11 叢集搭配使用。

    • Kubernetes 1.14 版:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.14.6/2019-08-22/bin/windows/amd64/kubectl.exe
    • Kubernetes 1.13 版:

      curl -o kubectl.exe https://amazon-eks.s3.us-west-2.amazonaws.com/1.13.8/2019-08-14/bin/windows/amd64/kubectl.exe
  3. (選用) 使用您的二進位檔 SHA-256 總和,驗證下載的二進位檔。

    1. 若您使用 Windows,請下載適用您叢集 Kubernetes 版本的 SHA-256 總和:

      • Kubernetes 1.16 版:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.16.8/2020-04-16/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.10/2020-02-22/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.14 版:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.14.6/2019-08-22/bin/windows/amd64/kubectl.exe.sha256
      • Kubernetes 1.13 版:

        curl -o kubectl.exe.sha256 https://amazon-eks.s3.us-west-2.amazonaws.com/1.13.8/2019-08-14/bin/windows/amd64/kubectl.exe.sha256
    2. 檢查適用您下載的二進位檔的 SHA-256 總和。

      Get-FileHash kubectl.exe
    3. 將命令輸出產生的 SHA-256 總和與您下載的 SHA-256 檔案進行比對。兩者應該相符,只不過 PowerShell 輸出會是大寫。

  4. 將二進位檔複製到 PATH 中的資料夾。如果您的 PATH 中已有命令列公用程式專用的現存目錄,請將二進位檔複製到該目錄。否則,請完成下列步驟。

    1. 建立新目錄以供存放命令列二進位檔,例如 C:\bin

    2. kubectl.exe 二進位檔複製到該新目錄。

    3. 編輯您的使用者或系統 PATH 環境變數,將新目錄加入該路徑。

    4. 關閉 PowerShell 終端機再重新開啟以挑選新的 PATH 變數。

  5. 安裝 kubectl 之後,您可使用以下命令驗證其版本:

    kubectl version --short --client