4. eksctl 기반 설치
Update: 2022-10-27 / 1H
eksctl 소개
eksctl은 관리형 Kubernetes 서비스 인 EKS에서 클러스터를 생성하기위한 간단한 CLI 도구입니다. Go로 작성되었으며 CloudFormation을 사용하며 Weaveworks 가 작성했으며 단 하나의 명령으로 몇 분 안에 기본 클러스터를 만듭니다. 이것은 EKS를 구성하기 위한 도구 이며, AWS 관리콘솔에서 제공하는 EKS UI, CDK, Terraform, Rancher 등 다양한 도구로도 구성이 가능합니다.
eksctl을 통한 EKS 구성
1.eksctl 설치
아래와 같이 eksctl을 Cloud9에 설치하고 버전을 확인합니다.
# eksctl 설정
curl --silent --location "https://github.com/weaveworks/eksctl/releases/latest/download/eksctl_$(uname -s)_amd64.tar.gz" | tar xz -C /tmp
sudo mv /tmp/eksctl /usr/local/bin
# eksctl 자동완성 - bash
. <(eksctl completion bash)
eksctl version
2. VPC/Subnet 정보 확인
앞서 Cloudformation 구성에서 생성한 VPC 자원들에 대한 고유의 자원 값을 추출해서, Cloud9 내에서 환경 변수에 저장합니다. 아래 Shell을 실행합니다.
~/environment/myeks/shell/eks_shell.sh
VPC id, subnet id, region, master arn은 eksctl을 통해 EKS cluster를 배포하는 데 사용합니다.
3. eksctl 배포 yaml 수정
eksctl yaml 생성을 위해 아래 Shell을 실행합니다. eksworkshop.yaml 이라는 파일이 자동으로 생성됩니다. 해당 파일은 eksctl 에서 eks cluster 구성을 위한 manifest 파일로 사용될 것입니다. (파일 위치 - ~/environment/myeks)
vpc/subnet id , KMS CMK keyARN 등이 다를 경우 설치 에러가 발생합니다. 또한 Cloud9의 publickeyPath의 경로도 확인하고, 반드시 다음 단계를 진행하기 전에 다시 한번 Review 합니다.
생성된 eksctl yaml 파일을 dry-run을 실행시켜서 확인해 봅니다.
4. cluster 생성
eksctl을 통해 EKS Cluster를 생성합니다.
EKS Cluster를 생성하기 위해 20분 정도 시간이 소요됩니다.
출력 결과 예시
5. Cluster 생성 확인
정상적으로 Cluster가 생성되었는지 확인합니다.
출력 결과 예시
생성된 VPC와 Subnet, Internet Gateway, NAT Gateway, Route Table등을 확인해 봅니다.
생성된 EC2 Worker Node들도 확인해 봅니다.
EKS와 eksctl을 통해 생생된 Cloudformation도 확인해 봅니다.
다음과 같은 구성도가 완성되었습니다.
6. EKS 구성 확인
EKS 콘솔을 통해서, 생성된 EKS Cluster를 확인 할 수 있습니다.
각 계정의 User로 로그인 한 경우, 아래에서 처럼 eks cluster에 대한 정보를 확인 할 수 없습니다. 이것은 권한이 없기 때문입니다. User의 권한을 Cloud9에서 추가해 줍니다.
configmap 인증 정보 수정
cloud9 IDE Terminal 에 kubectl 명령을 통해서, aws-auth 파일을 확인해 봅니다.
aws-auth.yaml 파일을 아래 디렉토리에 생성합니다.
Cloud9에서 ~/environment/aws-auth.yaml 을 열고, 아래 값을 aws-auth 파일에 입력합니다.
user arn에서 xxxxx 의 값은 account id 입니다. 아래와 같이 account id는 이미 Shell 환경 변수에 저장해 두었습니다.
아래 새로운 사용자의 권한을 mapRoles 뒤에 추가해 줍니다. kubectl edit는 vi edit과 동일하게 수정하는 방식입니다. 아래 명령을 입력하고 복사해서 붙여 넣습니다.
추가한 이후 aws-auth.yaml 파일 입니다.
aws-auth.yaml을 실행시켜 AWS IAM User 에서도 EKS Cluster 접근 권한을 활성화 합니다.
실제 configmap에 대한 값을 확인해 봅니다. configmap은 kube-system namespace에 존재합니다.
아래는 결과에 대한 예입니다.
EKS Cluster 결과 확인.
EKS Cluster를 다시 콘솔에서 확인해 봅니다. 생성한 모든 노드들을 확인할 수 있습니다. 생성한 클러스터를 선택합니다.
컴퓨팅을 선택하고, 생성된 WorkerNode들을 확인해 봅니다.
EKS Cluster내에 생성된 워크로드들을 확인해 볼 수 있습니다.
managed Node type과 Self Managed Node Type의 차이를 확인할 수 있습니다
Kuernetes의 Resource들을 선택하고 확인해 봅니다.
아래와 같은 EKS Cluster가 완성되었습니다. kubectl 명령을 통해 확인해 봅니다.
다음 섹션에서 워크로드들을 생성한 이후 EKS Cluster 메뉴에서 확인해 봅니다.
Last updated