AWS Outposts에 Amazon Linux 노드 생성 - Amazon EKS
eksctlAWS Management Console

AWS Outposts에 Amazon Linux 노드 생성

이 주제에서는 Amazon EKS 클러스터에 등록하는 Outpost에서 Amazon Linux 노드의 Auto Scaling을 시작하는 방법을 설명합니다. 클러스터는 AWS 클라우드 또는 Outpost에 있을 수 있습니다.

  • 기존 Outpost. 자세한 내용은 AWS Outposts이란 무엇입니까? 단원을 참조하십시오.

  • 기존 Amazon EKS 클러스터. AWS 클라우드에 클러스터를 배포하려면 Amazon EKS 클러스터 생성 부분을 참조하세요. Outpost에 클러스터를 배포하려면 고가용성을 위해 AWS Outposts에서 로컬 Amazon EKS 클러스터 생성 부분을 참조하세요.

  • AWS 클라우드의 클러스터에서 노드를 생성 중이며 활성화된 AWS Outposts, AWS Wavelength 또는 AWS 로컬 영역이 있는 AWS 리전에 서브넷이 있다고 가정합니다. 그러면 클러스터를 생성할 때 해당 서브넷이 전달되지 않았어야 합니다. Outpost의 클러스터에 노드를 생성하는 경우 클러스터 생성 시 Outpost 서브넷을 전달해야 합니다.

  • (AWS 클라우드의 클러스터에 권장됨) 필요한 IAM 정책이 연결된 자체 IAM 역할로 구성된 Amazon VPC CNI plugin for Kubernetes 추가 기능입니다. 자세한 내용은 IRSA를 사용하도록 Amazon VPC CNI 플러그인 구성 단원을 참조하십시오. 로컬 클러스터는 서비스 계정에 대한 IAM 역할을 지원하지 않습니다.

eksctl 또는 AWS Management Console(AWS CloudFormation 템플릿 사용)을 사용하여 자체 관리형 Amazon Linux 노드 그룹을 생성할 수 있습니다. Terraform도 사용할 수 있습니다.

이 페이지에 설명된 다음 도구를 사용하여 로컬 클러스터를 생성할 수 있습니다.

eksctl

eksctl을 사용하여 자체 관리형 Linux 노드를 시작하기`

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

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

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

    instance-type을 Outpost에서 사용 가능한 인스턴스 유형으로 바꿉니다.

    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 instance-type \
    --nodes 3 --nodes-min 1 --nodes-max 4 --managed=false --node-volume-type gp2 --subnet-ids subnet-id

    AWS 클라우드에 클러스터가 배포된 경우:

    사용 가능한 모든 옵션과 기본값의 전체 목록은 eksctl 설명서의 AWS Outposts 지원을 참조하세요.

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

AWS Management Console

1단계: AWS Management Console을 사용하여 자체 관리형 Linux 노드를 시작하기

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

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

  2. AWSCloudFormation 콘솔을 엽니다.

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

  4. 템플릿 지정(Specify template)에서 템플릿 파일 업로드(Upload a template file)를 선택한 다음 파일 선택(Choose file)을 선택합니다. 이전 단계에서 다운로드한 amazon-eks-nodegroup.yaml 파일을 선택한 후 Next(다음)를 선택합니다.

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

    • 스택 이름: AWS CloudFormation 스택에 대한 스택 이름을 선택합니다. 예를 들어 al-nodes라고 할 수 있습니다. 이름에는 영숫자(대소문자 구분)와 하이픈만 사용할 수 있습니다. 영숫자로 시작해야 하며 100자 이하여야 합니다. 이름은 클러스터를 생성하는 AWS 리전과 AWS 계정 내에서 고유해야 합니다.

    • ClusterName: 클러스터의 이름을 입력합니다. 이 이름이 클러스터 이름과 일치하지 않으면 노드가 클러스터에 조인할 수 없습니다.

    • ClusterControlPlaneSecurityGroup: VPC를 생성할 때 생성한 AWS CloudFormation 출력에서 SecurityGroups값을 선택합니다.

      다음 단계에서는 해당 그룹을 검색하는 한 가지 작업을 보여줍니다.

      1. Amazon EKS 콘솔을 엽니다.

      2. 클러스터의 이름을 선택합니다.

      3. 네트워킹 탭을 선택합니다.

      4. ClusterControlPlaneSecurityGroup 드롭다운 목록에서 선택할 때 추가 보안 그룹(Additional Security Group) 값을 참조로 사용하세요.

    • NodeGroupName: 노드 그룹의 이름을 입력합니다. 이 이름은 나중에 노드에 대해 생성된 Auto Scaling 노드 그룹을 식별하는 데 사용할 수 있습니다.

    • NodeAutoScalingGroupMinSize: Auto Scaling 그룹이 축소할 수 있는 노드의 최소 노드 수를 입력합니다.

    • NodeAutoScalingGroupDesiredCapacity: 스택을 생성할 때 조정할 원하는 노드 수를 입력합니다.

    • NodeAutoScalingGroupMaxSize: Auto Scaling 그룹이 확장할 수 있는 노드의 최대 노드 수를 입력합니다.

    • NodeInstanceType: 노드에 대한 인스턴스 유형을 선택합니다. 클러스터가 AWS 클라우드에서 실행 중인 경우 자세한 내용을 알아보려면 최적의 Amazon EC2 노드 인스턴스 유형 선택 부분을 참조하세요. 클러스터가 Outpost에서 실행 중인 경우 Outpost에서 사용할 수 있는 인스턴스 유형만 선택할 수 있습니다.

    • NodeImageIdSSMParam: 가변 Kubernetes 버전용 최신 Amazon EKS 최적화 AMI의 Amazon EC2 Systems Manager 파라미터로 미리 채워집니다. Amazon EKS에서 지원되는 다른 Kubernetes 마이너 버전을 사용하려면 1.XX를 다른 지원 버전으로 교체하세요. 클러스터와 동일한 Kubernetes 버전을 지정하는 것이 좋습니다.

      Amazon EKS 최적화 가속 AMI를 사용하려면 amazon-linux-2를 amazon-linux-2-gpu로 바꿉니다. Amazon EKS 최적화 Arm AMI를 사용하려면 amazon-linux-2를 amazon-linux-2-arm64로 바꿉니다.

      참고

      Amazon EKS 노드 AMI는 Amazon Linux를 기반으로 합니다. 원하는 버전에 대한 탭을 선택하여 Amazon Linux 보안 센터에서 Amazon Linux의 보안 또는 개인정보 보호 이벤트를 추적할 수 있습니다. 해당 RSS 피드를 구독할 수도 있습니다. 보안 및 프라이버시 이벤트에는 문제의 개요, 영향을 받는 패키지 및 인스턴스를 업데이트하여 문제를 해결하는 방법이 포함됩니다.

    • NodeImageId: (선택 사항) Amazon EKS 최적화 AMI 대신 사용자 정의 AMI를 사용 중인 경우 해당 AWS 리전에 노드 AMI ID를 입력합니다. 여기에서 값을 지정하면 NodeImageIdSSMParam 필드에 있는 모든 값이 재정의됩니다.

    • NodeVolumeSize: 노드에 대해 루트 볼륨 크기를 GiB 단위로 지정합니다.

    • NodeVolumeType: 노드의 루트 볼륨 유형을 지정합니다.

    • KeyName: 시작 이후 SSH를 사용하여 노드에 연결하는 데 사용할 수 있는 Amazon EC2 SSH 키 페어 이름을 입력합니다. Amazon EC2 키 페어가 아직 없는 경우 AWS Management Console에서 새로 생성할 수 있습니다. 자세한 내용을 알아보려면 Amazon EC2 사용 설명서의 Amazon EC2 키 페어를 참조하세요.

      참고

      여기에 키 페어를 입력하지 않으면 AWS CloudFormation 스택이 생성되지 않습니다.

    • BootstrapArguments: 노드에 전달할 수 있는 몇 가지 선택적 인수가 있습니다. 자세한 내용은 GitHub의 부트스트랩 스크립트 사용 정보를 참조하세요. AWS Outposts 에서 Kubernetes 컨트롤 플레인 인스턴스가 실행되는 경우 AWS Outposts의 Amazon EKS 로컬 클러스터에 노드를 추가하고 있으며 클러스터(프라이빗 클러스터라고도 함)에 수신 및 송신 인터넷 연결이 없으면 다음과 같은 부트스트랩 인수를 한 줄로 제공해야 합니다.

      --b64-cluster-ca ${CLUSTER_CA} --apiserver-endpoint https://${APISERVER_ENDPOINT} --enable-local-outpost true --cluster-id ${CLUSTER_ID}

    • DisableIMDSv1: 기본적으로 각 노드는 인스턴스 메타데이터 서비스 버전 1(IMDSv1) 및 IMDSv2를 지원합니다. IMDSv1을 사용 중지할 수 있습니다. 향후 노드 그룹의 노드와 Pods가 IMDSv1을 사용하지 못하게 하려면 DisableIMDSv1을 true로 설정합니다. IMDS에 대한 자세한 내용은 인스턴스 메타데이터 서비스 구성을 참조하세요. 노드의 IMDS 액세스 제한에 대한 자세한 내용은 작업자 노드에 할당된 인스턴스 프로파일에 대한 액세스 제한을 참조하세요.

    • VpcId: 생성한 VPC에 대한 ID를 입력합니다. VPC를 선택하기 전에 VPC 요구 사항과 고려 사항을 검토하세요.

    • Subnets(서브넷): 클러스터가 Outpost에 있는 경우 VPC에서 프라이빗 서브넷을 하나 이상 선택합니다. 서브넷을 선택하기 전에 을 검토하세요. 클러스터의 네트워킹 탭에서 각 서브넷 링크를 열면 어떤 서브넷이 프라이빗인지 확인할 수 있습니다.

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

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

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

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

2단계: 노드가 클러스터에 조인하도록 하려면

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

    kubectl describe configmap -n kube-system aws-auth

  2. 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. 파일을 저장하고 텍스트 편집기를 종료합니다.

  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

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

    kubectl get nodes --watch

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

    참고

    권한 부여 또는 리소스 유형 오류가 표시되는 경우 문제 해결 주제의 권한이 없거나 액세스가 거부됨(kubectl) 부분을 참조하세요.

    노드가 클러스터에 참여하지 못하면 Amazon EKS 클러스터 및 노드 문제 해결의 노드가 클러스터 조인에 실패와 AWS 전초 기지에서 로컬 Amazon EKS 클러스터 문제 해결의 클러스터에 노드를 조인할 수 없음를 참조하세요.

  5. Amazon EBS CSI 드라이버를 설치합니다. 자세한 내용을 알아보려면 GitHub에서 Installation(설치)을 참조하세요. Set up driver permission(드라이버 권한 설정) 섹션에서 Using IAM instance profile(IAM 인스턴스 프로파일 사용) 옵션에 대한 지침을 따릅니다. gp2 스토리지 클래스를 사용해야 합니다. gp3 스토리지 클래스는 지원되지 않습니다.

    클러스터에 gp2 스토리지 클래스를 생성하려면 다음 단계를 수행합니다.

    1. 다음 명령을 실행해 gp2-storage-class.yaml 파일을 생성합니다.

      cat >gp2-storage-class.yaml <<EOF
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  annotations:
    storageclass.kubernetes.io/is-default-class: "true"
  name: ebs-sc
provisioner: ebs.csi.aws.com
volumeBindingMode: WaitForFirstConsumer
parameters:
  type: gp2
  encrypted: "true"
allowVolumeExpansion: true
EOF

    2. 매니페스트를 클러스터에 적용합니다.

      kubectl apply -f gp2-storage-class.yaml

  6. (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

3단계: 추가 작업

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

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