Amazon EKS 叢集 IAM 角色

受 Amazon EKS 管理的 Kubernetes 叢集會代表您呼叫其他 AWS 服務，以管理您搭配本服務使用的資源。建立 Amazon EKS 叢集之前，您必須先建立具有以下 IAM 政策的 IAM 角色：

• AmazonEKSClusterPolicy

注意

在 2020 年 4 月 16 日之前，也必須使用 AmazonEKSServicePolicy，且建議名稱是 eksServiceRole。使用 AWSServiceRoleForAmazonEKS 服務連結角色時，該政策不再需要針對 2020 年 4 月 16 日或之後建立的叢集。

檢查現有的叢集角色

您可使用以下程序，檢查您的帳戶是否已有 Amazon EKS 叢集角色。

在 IAM 主控台中檢查 eksClusterRole

1. 前往網址 https://console.aws.amazon.com/iam/ 開啟 IAM 主控台。

2. 在左側導覽窗格中，選擇 Roles (角色)。

3. 搜尋 eksClusterRole 的角色清單。如果包含 eksClusterRole 的角色不存在，請參閱 建立 Amazon EKS 叢集角色 以建立角色。如果包含 eksClusterRole 的角色存在，請選取角色以檢視連接的政策。

4. 選擇 Permissions (許可)。

5. 確定 AmazonEKSClusterPolicy 受管政策已附加到該角色。如果已連接政策，則您的 Amazon EKS 叢集角色應已設定妥當。

6. 選擇 Trust Relationships (信任關係)，然後選擇 Edit trust policy (編輯信任政策)。

7. 確認信任關係包含下列政策。如果信任關係符合下列政策，請選擇 Cancel (取消)。如果信任關係不符合，請將政策複製到 Edit trust policy (編輯信任政策) 視窗中，然後選擇 Update policy (更新政策)。

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "eks.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }

建立 Amazon EKS 叢集角色

您可以使用 AWS Management Console 或 AWS CLI 建立叢集角色。

AWS Management Console

在 IAM 主控台中建立 Amazon EKS 叢集角色

1. 前往網址 https://console.aws.amazon.com/iam/ 開啟 IAM 主控台。

2. 選擇 Roles (角色)，然後選擇 Create role (建立角色)。

3. 在信任的實體類型)下，選取 AWS 服務。

4. 從其他 AWS 服務 的使用案例下拉式清單中，選擇 EKS。

5. 針對您的使用案例選擇 EKS - Cluster (EKS - 叢集)，然後選擇 Next (下一步)。

6. 在 Add permissions (新增許可) 標籤上，選擇 Next (下一步)。

7. 針對 Role name (角色名稱)，為您的角色輸入唯一名稱 (例如 eksClusterRole)。

8. 針對 Description (描述)，輸入描述性文字，如 Amazon EKS - Cluster role。

9. 選擇 建立角色。

AWS CLI

1. 將下列內容複製到名為 cluster-trust-policy.json 的檔案。

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Service": "eks.amazonaws.com"
         },
         "Action": "sts:AssumeRole"
       }
     ]
   }

2. 建立角色。您可以將 eksClusterRole 取代為您選擇的任何名稱。

   aws iam create-role \
     --role-name eksClusterRole \
     --assume-role-policy-document file://"cluster-trust-policy.json"

3. 將所需的 IAM 政策連接至角色。

   aws iam attach-role-policy \
     --policy-arn arn:aws:iam::aws:policy/AmazonEKSClusterPolicy \
     --role-name eksClusterRole