eksctl CLI로 EKS Auto Mode 클러스터 생성하기

이 주제에서는 eksctl 명령줄 인터페이스(CLI)로 Amazon EKS Auto Mode 클러스터를 만드는 방법을 보여 줍니다. 단일 CLI 명령을 실행하거나 YAML 구성 파일을 적용해 Auto Mode 클러스터를 만들 수 있어요. 두 방법 모두 동일한 기능을 제공하며, YAML 방식은 클러스터 설정을 더 세밀하게 제어할 수 있습니다.

eksctl CLI는 기반 AWS 리소스 생성·구성을 처리해 EKS Auto Mode 클러스터 생성·관리 과정을 단순화합니다. 진행하기 전에 로컬 머신에 필요한 AWS 자격 증명과 권한이 구성되어 있는지 확인하세요. 이 가이드는 기본 Amazon EKS 개념에 익숙하고 필요한 CLI 도구를 이미 설치했다고 가정합니다.

Note: eksctl 버전 0.195.0 이상을 설치해야 합니다. 자세한 내용은 GitHub의 eksctl releases를 참고하세요.

출처: 문서

본문

CLI 명령으로 EKS Auto Mode 클러스터 생성

aws와 eksctl 도구가 설치되어 있어야 합니다. EC2 인스턴스, EC2 네트워킹, EKS 클러스터, IAM 역할을 포함한 AWS 리소스를 관리할 충분한 권한으로 AWS CLI에 로그인해야 해요. 자세한 내용은 Set up to use Amazon EKS를 참고하세요.

다음 명령을 실행해 eksctl로 새 EKS Auto Mode 클러스터를 만듭니다.

eksctl create cluster --name= --enable-auto-mode

YAML 파일로 EKS Auto Mode 클러스터 생성

aws와 eksctl 도구가 설치되어 있어야 하고, EC2 인스턴스, EC2 네트워킹, EKS 클러스터, IAM 역할을 포함한 AWS 리소스를 관리할 충분한 권한으로 AWS CLI에 로그인해야 합니다.

아래 샘플 ClusterConfig 리소스에서 EKS Auto Mode 구성 옵션을 검토하세요. 전체 ClusterConfig 사양은 eksctl 문서를 참고하세요.

AWS는 EKS Auto Mode 활성화를 권장합니다. EKS Auto Mode 클러스터를 처음 만드는 경우 nodeRoleARN을 지정하지 않고 두어 EKS Auto Mode용 Node IAM Role을 생성하는 것이 좋아요. AWS 계정에 Node IAM Role이 이미 있다면 재사용할 것을 권장합니다.
nodePools에 값을 지정하지 않는 것을 권장합니다. EKS Auto Mode가 기본 노드 풀을 생성합니다. Kubernetes API로 추가 노드 풀을 만들 수 있어요.

# cluster.yaml
apiVersion: eksctl.io/v1alpha5
kind: ClusterConfig

metadata:
  name:
  region:

iam:
  # ARN of the Cluster IAM Role
  # optional, eksctl creates a new role if not supplied
  # suggested to use one Cluster IAM Role per account
  serviceRoleARN:

autoModeConfig:
  # defaults to false
  enabled: boolean
  # optional, defaults to [general-purpose, system].
  # suggested to leave unspecified
  # To disable creation of nodePools, set it to the empty array ([]).
  nodePools: []string
  # optional, eksctl creates a new role if this is not supplied
  # and nodePools are present.
  nodeRoleARN: string

ClusterConfig 파일을 cluster.yaml로 저장하고 다음 명령으로 클러스터를 만듭니다.

eksctl create cluster -f cluster.yaml

더 알아보기 (Learn more)

공식 문서