

 **協助改進此頁面** 

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

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

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

# 設定以使用 Amazon EKS
<a name="setting-up"></a>

如需為 Amazon EKS 叢集的命令列管理做準備，需要安裝多種工具。藉助以下各項來設定憑證，建立及修改叢集，以及在叢集執行後使用叢集：
+  [設定 AWS CLI](install-awscli.md) – 透過 AWS CLI 來設定及管理使用 Amazon EKS 叢集所需的服務。尤其需要透過 AWS CLI 來設定憑證，但您亦需使用其他 AWS 服務。
+  [設定 kubectl 與 eksctl](install-kubectl.md) – `eksctl` CLI 可與 AWS 互動，來建立、修改及刪除 Amazon EKS 叢集。一旦叢集啟動，則使用開放原始碼 `kubectl` 命令，來管理 Amazon EKS 叢集內的 Kubernetes 物件。
+ 設定開發環境 (選用) – 考慮新增以下各款工具：
  +  **本機部署工具** – 若您不熟悉 Kubernetes，則考慮安裝 [minikube](https://minikube.sigs.k8s.io/docs/) 或 [kind](https://kind.sigs.k8s.io/) 等本機部署工具。這些工具可讓您在本機電腦上，使用 Amazon EKS 叢集來測試應用程式。
  +  **套件管理器** – [helm](helm.md) 是適用於 Kubernetes 的熱門套件管理器，可用於簡化複雜套件的安裝和管理。藉助 [Helm](helm.md)，您可以更輕鬆地在 Amazon EKS 叢集上安裝和管理 AWS Load Balancer Controller 等套件。

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

# 設定 AWS CLI
<a name="install-awscli"></a>

[AWS CLI](https://aws.amazon.com/cli/) 是適用於使用 AWS 服務的命令列工具，包括 Amazon EKS。其也用於從本機電腦對 IAM 使用者或角色進行身分驗證，以便存取 Amazon EKS 叢集和其他 AWS 資源。若要從命令列佈建 AWS 中的資源，您需要取得要在命令列中使用的 AWS 存取金鑰 ID 和私密金鑰。然後您需要在 AWS CLI 中對這些憑證進行設定。若您尚未安裝 AWS CLI，請參閱《*AWS 命令列介面使用者指南*》中的[安裝或更新至 AWS CLI 的最新版本](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html)一節。

## 建立存取金鑰
<a name="create-access-key"></a>

1. 登入 [AWS 管理主控台](https://console.aws.amazon.com/)。

1. 對於單一使用者或多個使用者帳戶：
   +  **單一使用者帳戶**：在右上角，選擇 AWS 使用者名稱，以開啟導覽選單。例如，選擇 ** `webadmin` **。
   +  **多個使用者帳戶**：從服務清單中選擇 IAM。從 IAM 儀表板中，選取**使用者**，然後選擇使用者的名稱。

1. 選擇 **Security credentials (安全登入資料)**。

1. 在**存取金鑰**之下選擇**建立存取金鑰**。

1. 選擇**命令列介面 (CLI)**，然後選擇**下一步**。

1. 選擇** Create access key (建立新的存取金鑰)**。

1. 選擇**下載 .csv 檔案**。

## 設定 AWS CLI
<a name="configure-cli"></a>

安裝 AWS CLI 之後，請遵循這些步驟完成設定。如需詳細資訊，請參閱《*AWS 命令列介面使用者指南*》中的[設定 AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html)。

1. 在終端機視窗中，輸入以下命令：

   ```
   aws configure
   ```

   您也可以選擇設定具名設定檔，例如 `--profile cluster-admin`。如果您在 AWS CLI 中設定了具名設定檔，則必須**永遠**在後續命令中傳遞此旗標。

1. 輸入您的 AWS 憑證。例如：

   ```
   Access Key ID [None]: AKIAIOSFODNN7EXAMPLE
   Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
   Default region name [None]: region-code
   Default output format [None]: json
   ```

## 取得安全字符
<a name="security-token"></a>

如有需要，請執行下列命令以取得 AWS CLI 的新安全字符。如需詳細資訊，請參閱《*AWS CLI 命令參考*》中的 [get-session-token](https://docs.aws.amazon.com/cli/latest/reference/sts/get-session-token.html)。

依預設，該字符的有效期為 15 分鐘。若要變更預設工作階段逾時，請傳遞 `--duration-seconds` 旗標。例如：

```
aws sts get-session-token --duration-seconds 3600
```

此命令會傳回 AWS CLI 工作階段的暫時安全憑證。您應該會看到下列回應輸出：

```
{
    "Credentials": {
        "AccessKeyId": "ASIA5FTRU3LOEXAMPLE",
        "SecretAccessKey": "JnKgvwfqUD9mNsPoi9IbxAYEXAMPLE",
        "SessionToken": "VERYLONGSESSIONTOKENSTRING",
        "Expiration": "2023-02-17T03:14:24+00:00"
    }
}
```

## 若要驗證使用者身分
<a name="verify-identity"></a>

如有需要，請執行下列命令以驗證終端工作階段的 IAM 使用者身分 (例如 *ClusterAdmin*) 的 AWS 憑證。

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

此命令會傳回為 AWS CLI 設定的 IAM 實體的 Amazon Resource Name (ARN)。您應該會看到類似以下內容的回應輸出：

```
{
    "UserId": "AKIAIOSFODNN7EXAMPLE",
    "Account": "01234567890",
    "Arn": "arn:aws:iam::01234567890:user/ClusterAdmin"
}
```

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

# 設定 `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.2/2026-02-27/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.34` 

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

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

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

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

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/darwin/amd64/kubectl
     ```
   + Kubernetes `1.29` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/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.2/2026-02-27/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.34` 

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

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

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

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

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/darwin/amd64/kubectl.sha256
        ```
      + Kubernetes `1.29` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/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.2/2026-02-27/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.34` 

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

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

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

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

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/linux/amd64/kubectl
     ```
   + Kubernetes `1.29` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/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.2/2026-02-27/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.34` 

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

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

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

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

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/linux/amd64/kubectl.sha256
        ```
      + Kubernetes `1.29` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/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.2/2026-02-27/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.34` 

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

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

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

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

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/linux/arm64/kubectl
     ```
   + Kubernetes `1.29` 

     ```
     curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/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.2/2026-02-27/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.34` 

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

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

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

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

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/linux/arm64/kubectl.sha256
        ```
      + Kubernetes `1.29` 

        ```
        curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/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.2/2026-02-27/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.34` 

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

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

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

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

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.30.14/2026-02-27/bin/windows/amd64/kubectl.exe
     ```
   + Kubernetes `1.29` 

     ```
     curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/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.2/2026-02-27/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.34` 

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

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

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.32.12/2026-02-27/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-02-27/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-02-27/bin/windows/amd64/kubectl.exe.sha256
        ```
      + Kubernetes `1.29` 

        ```
        curl.exe -O https://s3.us-west-2.amazonaws.com/amazon-eks/1.29.15/2026-02-27/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) 