aws eks2

2.7 EKS 클러스터에 Worker 노드 추가하기

위에서 EKS 클러스터를 생성하긴 했지만 아직 Worker 노드가 추가된 것은 아닙니다. Worker 노드를 추가하기 위해서는 별도의 EC2 인스턴스를 생성한 뒤, 이를 EKS에 추가해야하며, 이 또한 AWS에서 제공되는 Cloudformation 템플릿을 통해 손쉽게 작업할 수 있습니다

시작하기 전, Worker 노드의 EC2 인스턴스에 쓰일 AMI를 미리 확인해놓아야 합니다. 이는 AWS Marketplace에서 확인할 수 있습니다.

AWS Marketplace에서 'eks' 로 검색하면 나오는 Amazon EKS-Optimized Amazon Linux AMI를 클릭합니다.

Continue to Subscribe를 클릭합니다.

Contiune to Configuration을 클릭합니다.

각 Select Box의 옵션을 적절하게 선택하고 나면 AMI id를 확인할 수 있습니다. 위 예시에서는 1.11 버전-20190211 버전을 선택하였고, AMI ID는 ami-0d87105164496b94b 입니다. 이 ID를 복사해 메모장에 적어놓습니다.

[AWS Web UI]

Cloudformation 페이지에 접속해 새로운 스택을 생성합니다. 이번에는 템플릿의 URL을 아래로 입력합니다.

 https://amazon-eks.s3-us-west-2.amazonaws.com/cloudformation/2019-02-11/amazon-eks-nodegroup.yaml

view raw post-eks-12 hosted with ❤ by GitHub

다음으로 Worker 노드 스택의 세부 정보를 입력해야 합니다. 다양한 정보를 입력해야 하는데, 신경써야 할 부분은 아래와 같습니다. 굵은 글씨로 강조한 옵션이 주의해서 설정해야 하는 항목입니다.

Cluster Name : 위에서 생성했던 EKS 클러스터의 이름을 입력해야 합니다.
ClusterControlPlaneSecurityGroup : 위에서 생성했던 eks-vpc-stack으로 시작하는 이름의 보안 그룹을 선택합니다.
NodeGroupName : 노드 그룹을 식별하기 위한 고유한 이름을 입력합니다.
NodeAutoScalingGroupMinSize : ASG(Auto Scailing Group)에 의해 최소로 줄어들 수 있는 노드의 갯수입니다.
NodeAutoScalingGroupDesiredCapacity : 생성 초기에 설정될 노드의 갯수입니다.
NodeAutoScalingGroupMaxSize : ASG(Auto Scailing Group)에 의해 최대로 늘어날 수 있는 노드의 갯수입니다.
NodeInstanceType : Worker 노드의 인스턴스 타입을 선택합니다.
NodeImageId : 위에서 적어두었던 EKS의 AMI ID를 입력합니다.
NodeVolumeSize : 각 노드의 볼륨 사이즈를 입력합니다. 기본적으로 20이 입력되어 있습니다.
KeyName : Worker 노드에 배포될 SSH 공개 키를 선택합니다. 기존에 생성해 둔 키 쌍을 선택해도 됩니다.
VpcId : 위에서 생성했던 eks-vpc-stack으로 시작하는 이름의 VPC를 선택합니다.
Subnets : 선택한 VPC에 속하는 2개의 Subnet을 선택합니다.

선택적으로, BootstrapArguments를 통해 Kubelet에 전달할 변수를 설정할 수 있다고도 하지만, 저는 입력하지 않았습니다.

제가 테스트를 위해 최종적으로 설정한 옵션은 아래와 같습니다.

설정을 마쳤다면 '다음' 버튼을 눌러 Worker 노드 그룹을 생성합니다. 마지막 화면에서 체크박스에 체크를 해야 생성이 시작됩니다.

이 또한 시간이 5~10분 정도 소요됩니다. Cloudformation 페이지에서 스택의 상태가 CREATE_COMPLETE로 바뀌면, 페이지 하단의 '출력' 탭에서 확인할 수 있는 NodeInstanceRole의 값을 복사해 메모장에 적어놓습니다.

이 값은 kubectl로 쿠버네티스에 접근하기 위한 권한 (kubeconfig) 을 aws-iam-authenticator를 통해 얻을 때 사용됩니다.

[AWS CLI]

CLI에서 Worker 노드 그룹을 생성하는 것은 조금 귀찮습니다. 그러나 미리 준비만 되어 있다면 그다지 어렵지는 않은 작업입니다.

다만 이번 AWS CLI에서는 Web UI에서 설정한 옵션을 전부 동일하게 설정하지는 않지만, 원한다면 NodeAutoScalingGroupMaxSize 등의 값을 JSON 파일에 별도로 추가해 사용할 수도 있습니다. 기본적으로 최소 1개, 생성 직후 3개, 최대 20개의 t3.medium 노드를 생성하도록 설정되어 있습니다.

아래의 내용을 parameter.json 파일로 작성해 놓겠습니다. <환경 변수 이름> 으로 되어 있는 부분을 여러분의 값에 맞게 교체할것입니다.

[
    {
        "ParameterKey": "KeyName",
        "ParameterValue": "<KEY_NAME>"
    },
    {
        "ParameterKey": "NodeImageId",
        "ParameterValue": "<AMI_ID>"
    },
    {
        "ParameterKey": "Subnets",
        "ParameterValue": "<SUBNET_IDS>"
    },
    {
        "ParameterKey": "NodeVolumeSize",
        "ParameterValue": "20"
    },
    {
        "ParameterKey": "NodeGroupName",
        "ParameterValue": "my-eks-worker-group"
    },
    {
        "ParameterKey": "ClusterControlPlaneSecurityGroup",
        "ParameterValue": "<CONTROLLPLANE_SG_ID>"
    },
    {
        "ParameterKey": "VpcId",
        "ParameterValue": "<VPC_ID>"
    },
    {
        "ParameterKey": "ClusterName",
        "ParameterValue": "alicek106-eks-cluster"
    }
]

view raw post-eks-16 hosted with ❤ by GitHub

아래의 명령어들을 입력해 적절한 환경 변수를 설정합니다. KEY_NAME의 값은 여러분이 기존에 생성해놓은 SSH 키 쌍의 이름을 적절하게 입력하면 됩니다. 저는 기존에 tf-kube라는 이름의 SSH 키 쌍을 만들어놓았기 때문에 이 키의 이름을 입력하였습니다.

root@aws-cli:/# export KEY_NAME=tf-kube
root@aws-cli:/# export AMI_ID=ami-0d87105164496b94b
root@aws-cli:/# export VPC_ID=$(aws cloudformation describe-stacks --region ap-northeast-2 \
  --stack-name eks-vpc-stack | \
  jq -r '.Stacks[].Outputs[] | select(.OutputKey == "VpcId")' | \
  jq -r '.OutputValue')

view raw post-eks-16 hosted with ❤ by GitHub

보안 그룹과 Subnet ID는 위에서 사용했던 환경 변수를 재활용하겠습니다.

root@aws-cli:/# echo $VPC_ID
vpc-01de6f0539d2c720a
root@aws-cli:/# echo $CONTROLLPLANE_SG_ID
sg-06607725be0b75ec3
root@aws-cli:/# echo $SUBNET_IDS
subnet-0884eab9dd736ec08,subnet-083752641b7329c9a

view raw post-eks-17 hosted with ❤ by GitHub

아래의 명령어를 입력해 parameter.json에 값이 입력된 stack_parameter.json 파일을 생성합니다.

root@aws-cli:/# cat parameter.json | sed "s/<KEY_NAME>/$KEY_NAME/g; \
   s/<AMI_ID>/$AMI_ID/g; s/<SUBNET_IDS>/$SUBNET_IDS/g; \
   s/<CONTROLLPLANE_SG_ID>/$CONTROLLPLANE_SG_ID/g; \
   s/<VPC_ID>/$VPC_ID/g;" > stack_parameter.json

view raw stack-parameter.json hosted with ❤ by GitHub

생성된 stack_parameter.json 파일을 이용해 Worker 노드 그룹을 Cloudformation에서 생성하겠습니다. 5~10분 정도가 소요됩니다.

root@aws-cli:/# aws cloudformation create-stack --region ap-northeast-2 \
 --stack-name eks-worker-group-stack \
 --template-body=https://amazon-eks.s3-us-west-2.amazonaws.com/cloudformation/2019-02-11/amazon-eks-nodegroup.yaml \
 --parameters=file://stack_parameter.json  \
 --capabilities CAPABILITY_IAM

view raw post-eks-18 hosted with ❤ by GitHub

아래의 명령어를 입력해 NodeInstanceRole 값을 환경 변수에 저장해놓습니다. 이 값은 kubectl로 쿠버네티스에 접근하기 위한 권한 (kubeconfig) 을 aws-iam-authenticator를 통해 얻을 때 사용됩니다.

root@aws-cli:/# export NODE_INSTANCE_ROLE=$(aws cloudformation describe-stacks --region ap-northeast-2 \
  --stack-name eks-worker-group-stack | \
  jq -r '.Stacks[].Outputs[] | select(.OutputKey == "NodeInstanceRole")' | \
  jq -r '.OutputValue')

view raw post-eks-19 hosted with ❤ by GitHub

2.8 EKS 클러스터에 kubectl으로 접근하기

Worker 노드 그룹까지 생성이 완료됬다면 다음은 kubectl을 통해 쿠버네티스 클러스터에 접근할 차례입니다. 쿠버네티스 클러스터에 접근하기 위해서는 인증 정보 (Credential) 이 필요한데, 이는 aws-iam-authenticator를 통해 얻을 수 있습니다.

먼저, Master에 연결하기 위한 kubeconfig 파일을 설정합니다. 아래의 명령어를 입력하면 ~/.kube/config 파일이 생성됩니다. --name 에는 위에서 생성한 EKS 클러스터의 이름을 입력합니다.

root@aws-cli:/# aws eks --region ap-northeast-2 update-kubeconfig --name alicek106-eks-cluster
Added new context <ARN> to /root/.kube/config

view raw gistfile1.txt hosted with ❤ by GitHub

서비스와 같은 쿠버네티스 리소스는 제대로 출력이 되지만, Worker 노드는 아직 출력되지 않는 것을 알 수 있습니다.

root@aws-cli:/# kubectl get svc
NAME         TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGE
kubernetes   ClusterIP   10.100.0.1   <none>        443/TCP   1h
root@aws-cli:/# kubectl get no
No resources found.

view raw post-eks-14 hosted with ❤ by GitHub

드디어 설정의 마지막 단계입니다. 아래의 명령어를 입력해 Auth 샘플 파일을 내려받습니다.

root@aws-cli:/# curl -O https://amazon-eks.s3-us-west-2.amazonaws.com/cloudformation/2019-02-11/aws-auth-cm.yaml

view raw post-eks-13 hosted with ❤ by GitHub

내려 받은 파일의 내용 중, rolearn 이라는 항목이 존재합니다. 위에서 복사했던 NodeInstanceRole의 값을 해당 항목에 입력합니다. AWS CLI를 통해 노드 그룹을 생성했다면 $NODE_INSTANCE_ROLE 환경 변수에 이 값이 존재할 것이니, echo $NODE_INSTANCE_ROLE 명령어로 값을 확인할 수 있습니다.

아래의 명령어를 입력하면 설정은 끝이 납니다.

root@aws-cli:/# kubectl apply -f aws-auth-cm.yaml
configmap/aws-auth created

view raw gistfile1.txt hosted with ❤ by GitHub

쿠버네티스 Worker 노드가 정상적으로 잡혔는지를 확인해보겠습니다. 처음에는 상태가 Not Ready로 출력될 수 있으나, 어느 정도 시간이 지나면 Ready 상태로 바뀝니다. AWS CLI를 통해 Worker 노드 그룹을 생성했다면 3개의 노드가 출력될 것입니다.

NAME                                                 STATUS    ROLES     AGE       VERSION
ip-192-168-108-185.ap-northeast-2.compute.internal   Ready     <none>    1m        v1.11.5
ip-192-168-130-68.ap-northeast-2.compute.internal    Ready     <none>    1m        v1.11.5

view raw post-eks-15 hosted with ❤ by GitHub

aws eks2

Trending Articles

일반화학 7판 솔루션(맥머리 자유아카데미 )

1515+ 사용자분들 어떻게 사용하고 계시나요

포럼 게시물: 오피스365 엑셀 심각한 오류: 업로드 잘 안되고, 업로드 실패후 셀서식이 변함.

그 모 09 카페 사건을 보니 옛날 근프라갤 생각나네

[크로스핏 치우 죽전] 크로스핏 치우 2호점(죽전점) 드디어 시작합니다. :)

서강대 로스쿨,중국 시안서 학술대회

태닝하러 간 황지희 선수

[도착보장] 7/24일주차 네이버 플래시딜 특가 상품 제안 (※ ~7/2(일) 마감)

하노이 3대 마사지 내돈내산 재방문 가성비 마사지 가격 팁

도라에몽의 퀄리티는 시대와 함께 성장한다

P-Diagram (Parameter Diagram)이란 무엇인가?

2011년에 사라진 인물들 - 시대의 초상

[Blender]블랜더 속성 강좌 Vol.07 - 리깅 기초, Bone, Mirror, IK 설정하기, 애니메이션 까지!

[트랜센던스 후기] 트랜센던스 볼 만한가요?

회심록 1 (근친소설)

타카오카 사키의 누드 사진집

[리디북스 서점]'네이버 페이' 결제 수단 추가

머슬걸즈 콜로세움

컴맹 영어로? Computer blind 아니랍니다.

[검은사막] 가모스 심장. 이제 퀘스트로 얻어보자.