자체 관리형 Amazon Linux 노드 시작하기

(선택 사항) AmazonEKS_CNI_Policy 관리형 IAM 정책이 Amazon EKS 노드 IAM 역할에 연결되어 있는 경우 Kubernetes aws-node 서비스 계정에 연결하는 IAM 역할에 대신 할당하는 것이 좋습니다. 자세한 내용은 서비스 계정용 IAM 역할(IRSA)을 사용하도록 Amazon VPC CNI plugin for Kubernetes 구성 단원을 참조하십시오.

다음 명령은 기존 클러스터의 노드 그룹을 생성합니다. al-nodes을 노드 그룹의 이름으로 바꿉니다. 노드 그룹 이름은 63자를 초과할 수 없습니다. 문자나 숫자로 시작하되, 나머지 문자의 경우 하이픈과 밑줄을 포함할 수 있습니다. my-cluster를 클러스터 이름으로 바꿉니다. 이름에는 영숫자(대소문자 구분)와 하이픈만 사용할 수 있습니다. 영숫자로 시작해야 하며 100자 이하여야 합니다. 이름은 클러스터를 생성하는 AWS 리전과 AWS 계정 내에서 고유해야 합니다. 나머지 example value를 고유한 값으로 바꿉니다. 노드는 기본적으로 제어 영역과 동일한 Kubernetes 버전으로 작성됩니다.

--node-type의 값을 선택하기 전에 Amazon EC2 인스턴스 유형 선택 부분을 검토하세요.

my-key를 Amazon EC2 키 페어 또는 퍼블릭 키 이름으로 바꿉니다. 이 키는 노드를 시작한 후 SSH로 연결하는 데 사용됩니다. Amazon EC2 키 페어가 아직 없는 경우 AWS Management Console에서 새로 생성할 수 있습니다. 자세한 내용을 알아보려면 Amazon EC2 사용 설명서의 Amazon EC2 키 페어를 참조하세요.

다음 명령을 사용하여 노드 그룹을 생성합니다.

eksctl create nodegroup \
  --cluster my-cluster \
  --name al-nodes \
  --node-type t3.medium \
  --nodes 3 \
  --nodes-min 1 \
  --nodes-max 4 \
  --ssh-access \
  --managed=false \
  --ssh-public-key my-key

다음과 같은 노드 그룹을 배포할 수 있습니다.

사용 가능한 모든 옵션 및 기본값의 전체 목록을 보려면 다음 명령을 입력합니다.

eksctl create nodegroup --help

노드가 클러스터에 조인하지 못한 경우 문제 해결 가이드의 노드가 클러스터 조인에 실패 섹션을 참조하세요.

예제 출력은 다음과 같습니다. 노드가 생성되는 동안 여러 줄이 출력됩니다. 출력의 마지막 줄 중 하나는 다음 예제 줄과 유사합니다.

[✔]  created 1 nodegroup(s) in cluster "my-cluster"

(선택 사항) 샘플 애플리케이션을 배포하여 클러스터 및 Linux 노드를 테스트합니다.

다음과 같은 조건에 해당하면 IMDS에 대한 Pod 액세스를 차단하는 것이 좋습니다.

자세한 내용은 작업자 노드에 할당된 인스턴스 프로파일에 대한 액세스 제한 부분을 참조하세요.

AWS CloudFormation 템플릿의 최신 버전 다운로드

curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/cloudformation/2022-12-23/amazon-eks-nodegroup.yaml

클러스터 상태가 ACTIVE가 되기를 기다립니다. 클러스터가 활성화되기 전에 노드를 시작하면 노드가 클러스터에 등록되지 않고 노드를 다시 시작해야 합니다.

AWS CloudFormation 콘솔(https://console.aws.amazon.com/cloudformation)을 엽니다.

스택 생성(Create stack)을 선택한 다음 새 리소스 사용(표준)(With new resources(standard))을 선택합니다.

템플릿 지정(Specify template)에서 템플릿 파일 업로드(Upload a template file)를 선택한 다음 파일 선택(Choose file)을 선택합니다.

다운로드한 amazon-eks-nodegroup.yaml 파일을 선택합니다.

다음을 선택합니다.

스택 세부 정보 지정(Specify stack details) 페이지에서 이에 따라 다음 파라미터를 입력한 후 다음(Next)을 선택합니다.

스택 옵션 구성(Configure stack options) 페이지에서 원하는 선택 항목을 선택한 후 다음(Next)을 선택합니다.

AWS CloudFormation에서 IAM 리소스를 생성할 수 있음을 인정합니다.(I acknowledge that might create IAM resources.)의 왼쪽에 있는 확인란을 선택한 다음 스택 생성(Create stack)을 선택합니다.

스택이 생성된 후 콘솔에서 이를 선택하고 출력(Outputs)을 선택합니다.

생성된 노드 그룹에 대해 NodeInstanceRole을 기록합니다. Amazon EKS 노드를 구성할 때 필요합니다.

aws-auth ConfigMap이 이미 있는지 확인합니다.

kubectl describe configmap -n kube-system aws-auth

aws-auth ConfigMap이 표시되면 필요에 따라 이를 업데이트합니다.

1. 편집을 위해 ConfigMap을 엽니다.

   kubectl edit -n kube-system configmap/aws-auth
   

2. 필요에 따라 새 mapRoles 항목을 추가합니다. rolearn 값을 이전 절차에서 기록한 NodeInstanceRole 값으로 설정합니다.

   [...]
   data:
     mapRoles: |
       - rolearn: <ARN of instance role (not instance profile)>
         username: system:node:{{EC2PrivateDNSName}}
         groups:
           - system:bootstrappers
           - system:nodes
   [...]

3. 파일을 저장하고 텍스트 편집기를 종료합니다.

"Error from server (NotFound): configmaps "aws-auth" not found라는 오류 메시지가 표시되면 스톡 ConfigMap을 적용합니다.

1. 구성 맵을 다운로드합니다.

   curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/cloudformation/2020-10-29/aws-auth-cm.yaml
   

2. aws-auth-cm.yaml 파일에서 rolearn 값을 이전 절차에서 기록한 NodeInstanceRole 값으로 설정합니다. 이 작업은 텍스트 편집기를 사용하거나 my-node-instance-role을 대체하고 다음 명령을 실행하여 수행할 수 있습니다.

   sed -i.bak -e 's|<ARN of instance role (not instance profile)>|my-node-instance-role|' aws-auth-cm.yaml
   

3. 구성을 적용합니다. 이 명령을 완료하는 데 몇 분이 걸릴 수 있습니다.

   kubectl apply -f aws-auth-cm.yaml
   

노드의 상태를 확인하고 Ready 상태가 될 때까지 대기합니다.

kubectl get nodes --watch

Ctrl+C를 입력하여 쉘 프롬프트로 돌아갑니다.

노드가 클러스터에 조인하지 못한 경우 문제 해결 가이드의 노드가 클러스터 조인에 실패 섹션을 참조하세요.

(GPU 노드만 해당) GPU 인스턴스 유형과 Amazon EKS 최적화 가속 AMI를 선택한 경우 클러스터에 Kubernetes용 NVIDIA 디바이스 플러그인을 DaemonSet(으)로 적용해야 합니다. 다음 명령을 실행하기 전에 vX.X.X을(를) 원하는 NVIDIA/k8s-device-plugin 버전으로 교체합니다.

kubectl apply -f https://raw.githubusercontent.com/NVIDIA/k8s-device-plugin/vX.X.X/nvidia-device-plugin.yml

(선택 사항) 샘플 애플리케이션을 배포하여 클러스터 및 Linux 노드를 테스트합니다.

(선택 사항) AmazonEKS_CNI_Policy 관리형 IAM 정책(IPv4 클러스터가 있는 경우) 또는 AmazonEKS_CNI_IPv6_Policy(IPv6 클러스터가 있는 경우 직접 생성)가 Amazon EKS 노드 IAM 역할에 연결된 경우 대신 Kubernetes aws-node 서비스 계정에 연결하는 IAM 역할에 할당하는 것이 좋습니다. 자세한 내용은 서비스 계정용 IAM 역할(IRSA)을 사용하도록 Amazon VPC CNI plugin for Kubernetes 구성 단원을 참조하십시오.

다음과 같은 조건에 해당하면 IMDS에 대한 Pod 액세스를 차단하는 것이 좋습니다.

자세한 내용은 워커 노드에 할당된 인스턴스 프로파일에 대한 액세스 제한 섹션을 참조하세요.