**協助改進此頁面** 

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

若要為本使用者指南貢獻內容，請點選每個頁面右側面板中的**在 GitHub 上編輯此頁面**連結。

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

# 設定 `kubectl` 和 `eksctl`
<a name="install-kubectl"></a>

**提示**  
 [註冊](https://aws-experience.com/emea/smb/events/series/get-hands-on-with-amazon-eks?trk=4a9b4147-2490-4c63-bc9f-f8a84b122c8c&sc_channel=el)即將舉行的 Amazon EKS 研討會。

安裝 CLI AWS 後，您應該安裝其他兩個工具來建立和管理 Kubernetes 叢集：
+  `kubectl`：`kubectl` 命令列工具是您用來管理 Kubernetes 叢集內資源的主要工具。此頁面說明如何下載和設定與 Kubernetes 叢集版本相符的 `kubectl` 二進位檔。請參閱[安裝或更新 kubectl](#kubectl-install-update)。
+  `eksctl`：`eksctl`命令列工具用於在 AWS 雲端或內部部署 （使用 EKS Anywhere) 中建立 EKS 叢集，以及修改和刪除這些叢集。請參閱[安裝 eksctl](#eksctl-install-update)。

## 安裝或更新 `kubectl`
<a name="kubectl-install-update"></a>

本主題將協助您在裝置上下載並安裝或更新 `kubectl` 二進位檔案。二進位檔案與[上游社群版本](https://kubernetes.io/docs/tasks/tools/#kubectl)相同。二進位對 Amazon EKS 或 來說不是唯一的 AWS。使用下列步驟來取得您需要的 `kubectl` 的特定版本，雖然許多建置器只需執行 `brew install kubectl` 即可安裝。

**注意**  
您所使用的 `kubectl` 版本，必須與 Amazon EKS 叢集控制平面的版本差距在一個版本以內。例如，`1.34` `kubectl` 用戶端搭配 Kubernetes `1.33`、`1.34` 和 `1.35` 叢集運作。

## 步驟 1：檢查是否已安裝 `kubectl`
<a name="_step_1_check_if_kubectl_is_installed"></a>

判斷您是否已在裝置上安裝 `kubectl`。

```
kubectl version --client
```

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

```
Client Version: v1.31.X-eks-1234567
```

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

## 步驟 2：安裝或更新 `kubectl`
<a name="_step_2_install_or_update_kubectl"></a>

在下列其中一個作業系統上安裝或更新 `kubectl`：
+  [macOS](#macos_kubectl) 
+  [Linux (amd64)](#linux_amd64_kubectl) 
+  [Linux (arm64)](#linux_arm64_kubectl) 
+  [Windows](#windows_kubectl) 

**注意**  
如果從本節使用的 AWS 區域下載到 AWS 區域的速度緩慢，請考慮設定 CloudFront 來前置內容。如需詳細資訊，請參閱[開始使用基本 CloudFront 分佈](https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/GettingStartedSimpleDistributon.html)。

### macOS
<a name="macos_kubectl"></a>

請遵循下列步驟以在 macOS 上安裝 `kubectl`。步驟包括：
+ 選擇並下載您想要的 Kubernetes 版本的二進位檔。
+ 選擇性地檢查二進位檔的檢查總和。
+ 將執行套用至二進位檔的許可。
+ 將二進位檔複製到 PATH 中的資料夾。
+ 選擇性地將二進位檔的目錄新增至 PATH。

程序：

1. 從 Amazon S3 下載適用於您叢集 Kubernetes 版本的二進位檔。
   + Kubernetes `1.35` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.3/2026-04-08/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.34` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.6/2026-04-08/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.33` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.10/2026-04-08/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.32` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.13/2026-04-08/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.31` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-04-08/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.30` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-04-08/bin/darwin/amd64/kubectl
     ```

1. (選用) 使用您的二進位檔案 `SHA-256` 檢查總和，驗證下載的二進位檔案。

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

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.3/2026-04-08/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.34` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.6/2026-04-08/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.33` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.10/2026-04-08/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.32` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.13/2026-04-08/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.31` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-04-08/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.30` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-04-08/bin/darwin/amd64/kubectl.sha256
        ```

   1. 檢查適用您下載之二進位檔案的 `SHA-256` 檢查總和。

      ```
      openssl sha1 -sha256 kubectl
      ```

   1. 確保輸出中產生的檢查總和與下載 `kubectl.sha256` 檔案中的檢查總和相符。

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

   ```
   chmod +x ./kubectl
   ```

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

   ```
   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
   ```

1. (選用) 將 `$HOME/bin` 路徑新增到 Shell 初始化檔案，因此當您開啟 shell 時，該組態已設定完畢。

   ```
   echo 'export PATH=$HOME/bin:$PATH' >> ~/.bash_profile
   ```

### Linux (amd64)
<a name="linux_amd64_kubectl"></a>

請遵循下列步驟以在 Linux 上安裝 `kubectl` (amd64)。步驟包括：
+ 選擇並下載您想要的 Kubernetes 版本的二進位檔。
+ 選擇性地檢查二進位檔的檢查總和。
+ 將執行套用至二進位檔的許可。
+ 將二進位檔複製到 PATH 中的資料夾。
+ 選擇性地將二進位檔的目錄新增至 PATH。

程序：

1. 從 Amazon S3 下載適用於您叢集 Kubernetes 版本的 `kubectl` 二進位檔。
   + Kubernetes `1.35` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.3/2026-04-08/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.34` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.6/2026-04-08/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.33` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.10/2026-04-08/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.32` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.13/2026-04-08/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.31` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-04-08/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.30` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-04-08/bin/linux/amd64/kubectl
     ```

1. (選用) 使用您的二進位檔案 `SHA-256` 檢查總和，驗證下載的二進位檔案。

   1. 使用裝置硬體平台的 命令，從 Amazon S3 下載叢集 Kubernetes 版本的`SHA-256`檢查總和。
      + Kubernetes `1.35` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.3/2026-04-08/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.34` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.6/2026-04-08/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.33` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.10/2026-04-08/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.32` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.13/2026-04-08/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.31` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-04-08/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.30` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-04-08/bin/linux/amd64/kubectl.sha256
        ```

   1. 執行下列其中一個命令，檢查您下載的二進製檔案的 `SHA-256` 檢查總和。

      ```
      sha256sum -c kubectl.sha256
      ```

      或

      ```
      openssl sha1 -sha256 kubectl
      ```

   1. 首先，您應該會看到 `kubectl: OK`；其次，您可以檢查輸出中產生的檢查總和是否與下載的 `kubectl.sha256` 檔案中的檢查總和相符。

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

   ```
   chmod +x ./kubectl
   ```

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

   ```
   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
   ```

1. (選用) 將 `$HOME/bin` 路徑新增到 Shell 初始化檔案，因此當您開啟 shell 時，該組態已設定完畢。
**注意**  
本步驟假設您是使用 Bash Shell；若您使用其他 Shell，請將命令更改為使用具體的 Shell 初始化檔案。

   ```
   echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
   ```

### Linux (arm64)
<a name="linux_arm64_kubectl"></a>

請遵循下列步驟以在 Linux 上安裝 `kubectl` (arm64)。步驟包括：
+ 選擇並下載您想要的 Kubernetes 版本的二進位檔。
+ 選擇性地檢查二進位檔的檢查總和。
+ 將執行套用至二進位檔的許可。
+ 將二進位檔複製到 PATH 中的資料夾。
+ 選擇性地將二進位檔的目錄新增至 PATH。

程序：

1. 從 Amazon S3 下載適用於您叢集 Kubernetes 版本的 `kubectl` 二進位檔。
   + Kubernetes `1.35` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.3/2026-04-08/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.34` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.6/2026-04-08/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.33` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.10/2026-04-08/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.32` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.13/2026-04-08/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.31` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-04-08/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.30` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-04-08/bin/linux/arm64/kubectl
     ```

1. (選用) 使用您的二進位檔案 `SHA-256` 檢查總和，驗證下載的二進位檔案。

   1. 使用裝置硬體平台的 命令，從 Amazon S3 下載叢集 Kubernetes 版本的`SHA-256`檢查總和。
      + Kubernetes `1.35` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.3/2026-04-08/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.34` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.6/2026-04-08/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.33` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.10/2026-04-08/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.32` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.13/2026-04-08/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.31` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-04-08/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.30` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-04-08/bin/linux/arm64/kubectl.sha256
        ```

   1. 執行下列其中一個命令，檢查您下載的二進製檔案的 `SHA-256` 檢查總和。

      ```
      sha256sum -c kubectl.sha256
      ```

      或

      ```
      openssl sha1 -sha256 kubectl
      ```

   1. 首先，您應該會看到 `kubectl: OK`；其次，您可以檢查輸出中產生的檢查總和是否與下載的 `kubectl.sha256` 檔案中的檢查總和相符。

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

   ```
   chmod +x ./kubectl
   ```

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

   ```
   mkdir -p $HOME/bin && cp ./kubectl $HOME/bin/kubectl && export PATH=$HOME/bin:$PATH
   ```

1. (選用) 將 `$HOME/bin` 路徑新增到 Shell 初始化檔案，因此當您開啟 shell 時，該組態已設定完畢。
**注意**  
本步驟假設您是使用 Bash Shell；若您使用其他 Shell，請將命令更改為使用具體的 Shell 初始化檔案。

   ```
   echo 'export PATH=$HOME/bin:$PATH' >> ~/.bashrc
   ```

### Windows
<a name="windows_kubectl"></a>

請遵循下列步驟以在 Windows 上安裝 `kubectl`。步驟包括：
+ 選擇並下載您想要的 Kubernetes 版本的二進位檔。
+ 選擇性地檢查二進位檔的檢查總和。
+ 將二進位檔複製到 PATH 中的資料夾。
+ 選擇性地將二進位檔的目錄新增至 PATH。

程序：

1. 開啟 PowerShell 終端機。

1. 從 Amazon S3 下載適用於您叢集 Kubernetes 版本的 `kubectl` 二進位檔。
   + Kubernetes `1.35` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.3/2026-04-08/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.34` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.6/2026-04-08/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.33` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.10/2026-04-08/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.32` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.13/2026-04-08/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.31` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-04-08/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.30` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-04-08/bin/windows/amd64/kubectl.exe
     ```

1. (選用) 使用您的二進位檔案 `SHA-256` 檢查總和，驗證下載的二進位檔案。

   1. 對於 Windows，下載適用於您叢集 Kubernetes 版本的 `SHA-256` 檢查總和。
      + Kubernetes `1.35` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.35.3/2026-04-08/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.34` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.34.6/2026-04-08/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.33` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.33.10/2026-04-08/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.32` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.13/2026-04-08/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.31` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.31.14/2026-04-08/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.30` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-04-08/bin/windows/amd64/kubectl.exe.sha256
        ```

   1. 檢查適用您下載之二進位檔案的 `SHA-256` 檢查總和。

      ```
      Get-FileHash kubectl.exe
      ```

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

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

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

   1. 將 `kubectl.exe` 二進位檔複製到該新目錄。

   1. 編輯您的使用者或系統 `PATH` 環境變數，將新目錄新增至 `PATH`。

   1. 關閉 PowerShell 終端，再重新開啟以挑選新的 `PATH` 變數。

1. 安裝 `kubectl` 後，您可以驗證其版本。

   ```
   kubectl version --client
   ```

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

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

1. 請考慮設定自動完成，這樣一來，在輸入前幾個字母後，您即可使用 Tab 鍵來完成 `kubectl` 子命令。如需詳細資訊，請參閱 Kubernetes 文件中的 [Kubectl 自動完成](https://kubernetes.io/docs/reference/kubectl/quick-reference/#kubectl-autocomplete)。

## 安裝 `eksctl`
<a name="eksctl-install-update"></a>

`eksctl` CLI 可用於與 EKS 叢集搭配使用。它會自動化許多個別任務。如需有關安裝 `eksctl` 的指示，請參閱 `eksctl` 文件中的[安裝](https://eksctl.io/installation)。對於 Linux，請使用 UNIX 指示。

當您使用 `eksctl` 時，您使用的 IAM 安全主體必須具有使用 Amazon EKS IAM 角色、服務連結角色、 AWS CloudFormation、VPC 和相關資源的許可。如需詳細資訊，請參閱《IAM 使用者指南》中的[動作](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonelastickubernetesservice.html)和[使用服務連結角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html)。您必須以同一位使用者的身分完成本指南中的所有步驟。若要檢查目前使用者，請執行以下命令：

```
aws sts get-caller-identity
```

## 後續步驟
<a name="install-kubectl-next-steps"></a>
+  [快速入門：部署 Web 應用程式並存放資料](quickstart.md)