14장 eksctl 선언으로 lab cluster를 만든다

examples/cluster/cluster.yaml을 연다. metadata.region과 version, logging retention을 확인한다. Auto Mode의 기본 NodePool을 사용하므로 nodePools를 굳이 지정하지 않는다. Access Entry를 쓰기 위해 authentication mode는 API로 둔다.

eksctl create cluster -f examples/cluster/cluster.yaml

생성은 여러 AWS resource를 만들고 시간이 걸린다. terminal을 닫기 전에 CloudFormation stack과 EKS cluster status를 확인한다.

aws eks describe-cluster --name flownote-lab 
  --query 'cluster.{status:status,version:version,endpoint:endpoint}'
kubectl get nodes -o wide
kubectl get nodepool
kubectl get nodeclass

처음에는 workload가 없어 Auto Mode node가 보이지 않을 수 있다. Pod가 scheduling을 요청하면 compute가 생긴다. EC2 console에서 instance가 안 보인다고 즉시 실패로 판단하지 않는다. 2026년 4월 이후 새 Auto Mode managed resource는 기본 list view에서 숨겨질 수 있으므로 EKS compute tab, kubectl get nodes, managed resource visibility 설정을 확인한다.

생성 실패는 마지막 error 한 줄만 보지 않는다.

eksctl utils describe-stacks --cluster flownote-lab
aws cloudformation describe-stack-events 
  --stack-name eksctl-flownote-lab-cluster 
  --query 'StackEvents[?ResourceStatus==`CREATE_FAILED`].[LogicalResourceId,ResourceStatusReason]'