安裝或更新 kubectl - Amazon EKS

協助改善此頁面

想要為此使用者指南做出貢獻嗎? 捲動至此頁面底部,然後選取 [編輯此頁面於] GitHub。您的貢獻將有助於使我們的用戶指南更適合所有人。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

安裝或更新 kubectl

Kubectl 是一種命令列工具,可用來與 Kubernetes API 伺服器進行通訊。kubectl 二進位檔案可在眾多作業系統套件軟體管理工具中使用。在安裝時使用套件管理工具,時常會比手動下載與安裝程序更加簡便。

本主題將協助您在裝置上下載並安裝或更新 kubectl 二進位檔案。二進位檔案與上游社群版本相同。二進製文件不是唯一的 Amazon EKS 或 AWS.

注意

您所使用的 kubectl 版本,必須與 Amazon EKS 叢集控制平面的版本差距在一個版本以內。例如,1.29 kubectl 用戶端搭配 Kubernetes、1.281.291.30 叢集運作。

安裝或更新 kubectl
  1. 判斷您是否已在裝置上安裝 kubectl

    kubectl version --client

    若您已在裝置路徑中安裝 kubectl,則範例輸出包含下列類似資訊。若您要更新目前使用較新版本安裝的版本,請完成下一個步驟,確定將新版本安裝在目前版本所處的位置。

    Client Version: v1.30.X-eks-1234567

    若您未收到輸出,表示您尚未安裝 kubectl,或其未安裝在裝置路徑中的位置。

  2. macOS、Linux 和 Windows 作業系統上安裝或更新 kubectl

    macOS
    macOS 上安裝或更新 kubectl
    1. 從 Amazon S3 下載適用您叢集 Kubernetes 版本的二進位檔案。

      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/darwin/amd64/kubectl
      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/darwin/amd64/kubectl
      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/darwin/amd64/kubectl
      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/darwin/amd64/kubectl
      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/darwin/amd64/kubectl
      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/darwin/amd64/kubectl
      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/darwin/amd64/kubectl
      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/darwin/amd64/kubectl
      • Kubernetes 1.22

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/darwin/amd64/kubectl
      • Kubernetes 1.21

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/darwin/amd64/kubectl
    2. (選用) 使用您的二進位檔案 SHA-256 檢查總和,驗證下載的二進位檔案。

      1. 下載適用於您叢集 Kubernetes 版本的 SHA-256 檢查總和。

        • Kubernetes 1.30

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.22

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/darwin/amd64/kubectl.sha256
        • Kubernetes 1.21

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/darwin/amd64/kubectl.sha256
      2. 檢查適用您下載之二進位檔案的 SHA-256 檢查總和。

        openssl sha1 -sha256 kubectl
      3. 確保輸出中產生的檢查總和與下載 kubectl.sha256 檔案中的檢查總和相符。

    3. 將執行許可套用至二進位檔。

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

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

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile
    Linux (amd64)
    在 Linux (amd64) 上安裝或更新 kubectl
    1. 從 Amazon S3 下載適用您叢集 Kubernetes 版本的 kubectl 二進位檔案。

      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl
      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl
      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/amd64/kubectl
      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/amd64/kubectl
      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/amd64/kubectl
      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/amd64/kubectl
      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/amd64/kubectl
      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/amd64/kubectl
      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/amd64/kubectl
      • Kubernetes 1.22

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/amd64/kubectl
      • Kubernetes 1.21

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/amd64/kubectl
    2. (選用) 使用您的二進位檔案 SHA-256 檢查總和,驗證下載的二進位檔案。

      1. 使用適用於您裝置硬體平台的命令,從 Amazon S3下載 Amazon EKS 提供之適用您叢集 Kubernetes 版本的 SHA-256 檢查總和。每個版本的第一個連結適用於 amd64,第二個連結則適用於 arm64

        • Kubernetes 1.30

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.30

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.22

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/amd64/kubectl.sha256
        • Kubernetes 1.21

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/amd64/kubectl.sha256
      2. 執行下列其中一個命令,檢查您下載的二進製檔案的 SHA-256 檢查總和。

        • sha256sum -c kubectl.sha256

          使用此命令時,請確保看到下列輸出:

          kubectl: OK
        • openssl sha1 -sha256 kubectl

          使用此命令時,確保輸出中產生的檢查總和與下載 kubectl.sha256 檔案中的檢查總和相符。

    3. 將執行許可套用至二進位檔。

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

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

      注意

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

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
    Linux (arm64)
    在 Linux (arm64) 上安裝或更新 kubectl
    1. 從 Amazon S3 下載適用您叢集 Kubernetes 版本的 kubectl 二進位檔案。

      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/arm64/kubectl
      • Kubernetes 1.30

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/arm64/kubectl
      • Kubernetes 1.29

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/arm64/kubectl
      • Kubernetes 1.28

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/arm64/kubectl
      • Kubernetes 1.27

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/arm64/kubectl
      • Kubernetes 1.26

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/arm64/kubectl
      • Kubernetes 1.25

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/arm64/kubectl
      • Kubernetes 1.24

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/arm64/kubectl
      • Kubernetes 1.23

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/arm64/kubectl
      • Kubernetes 1.22

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/arm64/kubectl
      • Kubernetes 1.21

        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/arm64/kubectl
    2. (選用) 使用您的二進位檔案 SHA-256 檢查總和,驗證下載的二進位檔案。

      1. 使用適用於您裝置硬體平台的命令,從 Amazon S3下載 Amazon EKS 提供之適用您叢集 Kubernetes 版本的 SHA-256 檢查總和。每個版本的第一個連結適用於 amd64,第二個連結則適用於 arm64

        • Kubernetes 1.30

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.30

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.29

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.28

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.27

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.26

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.25

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.24

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.23

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.22

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/linux/arm64/kubectl.sha256
        • Kubernetes 1.21

          curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/linux/arm64/kubectl.sha256
      2. 執行下列其中一個命令,檢查您下載的二進製檔案的 SHA-256 檢查總和。

        • sha256sum -c kubectl.sha256

          使用此命令時,請確保看到下列輸出:

          kubectl: OK
        • openssl sha1 -sha256 kubectl

          使用此命令時,確保輸出中產生的檢查總和與下載 kubectl.sha256 檔案中的檢查總和相符。

    3. 將執行許可套用至二進位檔。

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

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

      注意

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

      echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
    Windows
    在 Windows 上安裝或更新 kubectl
    1. 開啟 PowerShell 終端機。

    2. 從 Amazon S3 下載適用您叢集 Kubernetes 版本的 kubectl 二進位檔案。

      • Kubernetes 1.30

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.29

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.28

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.27

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.26

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.25

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.24

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.23

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.22

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/windows/amd64/kubectl.exe
      • Kubernetes 1.21

        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/windows/amd64/kubectl.exe
    3. (選用) 使用您的二進位檔案 SHA-256 檢查總和,驗證下載的二進位檔案。

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

        • Kubernetes 1.30

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.0/2024-05-12/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.29

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.3/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.28

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.28.8/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.27

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.27.12/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.26

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.26.15/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.25

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.25.16/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.24

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.24.17/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.23

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.23.17/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.22

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.22.17/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
        • Kubernetes 1.21

          curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.21.14/2024-04-19/bin/windows/amd64/kubectl.exe.sha256
      2. 檢查適用您下載之二進位檔案的 SHA-256 檢查總和。

        Get-FileHash kubectl.exe
      3. 確保輸出中產生的檢查總和與下載 kubectl.sha256 檔案中的檢查總和相符。 PowerShell輸出應該是字符的大寫等效字符串。

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

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

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

      3. 編輯您的使用者或系統 PATH 環境變數,將新目錄新增至 PATH

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

  3. 安裝 kubectl 後,您可以驗證其版本。

    kubectl version --client

第一次安裝 kubectl 時,它並未設定可與任何伺服器通訊。我們會視需要在其他程序中涵蓋此組態。如果您需要更新組態來與特定叢集進行通訊,那麼您可以執行下列命令。region-code以叢集所 AWS 區域 在的位置取代。使用您叢集的名稱取代 my-cluster

aws eks update-kubeconfig --region region-code --name my-cluster