EKS 클러스터에 Windows 노드 배포

클러스터에 Windows 지원을 사용하려면 다음을 수행합니다.

1. 클러스터에 Amazon Linux 노드가 없고 Pods에 보안 그룹을 사용하는 경우 다음 단계로 건너뜁니다. 그렇지 않으면 AmazonEKSVPCResourceController 관리형 정책이 클러스터 역할에 연결되어 있는지 확인합니다. eksClusterRole를 클러스터 역할 이름으로 교체합니다.

   aws iam list-attached-role-policies --role-name eksClusterRole
   

   예제 출력은 다음과 같습니다.

   {
       "AttachedPolicies": [
           {
               "PolicyName": "AmazonEKSClusterPolicy",
               "PolicyArn": "arn:aws:iam::aws:policy/AmazonEKSClusterPolicy"
           },
           {
               "PolicyName": "AmazonEKSVPCResourceController",
               "PolicyArn": "arn:aws:iam::aws:policy/AmazonEKSVPCResourceController"
           }
       ]
   }

   이전 출력에서와 같이 정책이 연결된 경우 다음 단계를 건너뜁니다.

2. AmazonEKSVPCResourceController 관리형 정책을 Amazon EKS 클러스터 IAM 역할에 연결합니다. eksClusterRole를 클러스터 역할 이름으로 교체합니다.

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

3. 다음 콘텐츠를 가진 vpc-resource-controller-configmap.yaml이라는 파일을 생성합니다:

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: amazon-vpc-cni
     namespace: kube-system
   data:
     enable-windows-ipam: "true"

4. 클러스터에 ConfigMap 적용.

   kubectl apply -f vpc-resource-controller-configmap.yaml
   

5. aws-auth ConfigMap에 Windows 노드의 인스턴스 역할에 대한 매핑이 포함되어 eks:kube-proxy-windows RBAC 권한 그룹을 포함하는지 확인합니다. 다음 명령을 실행하여 확인할 수 있습니다.

   kubectl get configmap aws-auth -n kube-system -o yaml
   

   예제 출력은 다음과 같습니다.

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: aws-auth
     namespace: kube-system
   data:
     mapRoles: |
       - groups:
         - system:bootstrappers
         - system:nodes
         - eks:kube-proxy-windows # This group is required for Windows DNS resolution to work
         rolearn: arn:aws:iam::111122223333:role/eksNodeRole
         username: system:node:{{EC2PrivateDNSName}}
   [...]
   

   그룹 아래에 eks:kube-proxy-windows가 표시될 것입니다. 그룹이 지정되지 않은 경우 ConfigMap을 업데이트하거나 생성하여 필수 그룹을 포함해야 합니다. aws-auth ConfigMap에 대한 자세한 내용은 클러스터에 aws-authConfigMap 적용 섹션을 참조하세요.