자체 관리형 Amazon Linux 노드 생성

장치에 설치된 eksctl 명령줄 도구의 버전 0.194.0 이상 또는 AWS CloudShell이 필요합니다. eksctl을 설치 또는 업그레이드하려면 eksctl 설명서에서 Installation을 참조하세요.

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

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

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

(선택 사항) 샘플 애플리케이션을 배포하여 클러스터 및 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가 되기를 기다립니다. 클러스터가 활성화되기 전에 노드를 시작하면 노드가 클러스터에 등록되지 않고 노드를 다시 시작해야 합니다.

AWSCloudFormation 콘솔을 엽니다.

스택 생성(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이 표시되면 필요에 따라 이를 업데이트합니다.

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

노드의 상태를 확인하고 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/deployments/static/nvidia-device-plugin.yml

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

(선택 사항) AmazonEKS_CNI_Policy 관리형 IAM 정책(IPv4 클러스터를 사용하는 경우) 또는 AmazonEKS_CNI_IPv6_Policy(IPv6 클러스터를 사용하는 경우 직접 만든 것)이 Amazon EKS 노드 IAM 역할에 연결되어 있는 경우, 대신 Kubernetes aws-node 서비스 계정에 연결하는 IAM 역할에 할당하는 것을 권장합니다. 자세한 내용은 IRSA를 사용하도록 Amazon VPC CNI 플러그인 구성 단원을 참조하십시오.

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

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