Kubernetes Engine으로 쿠버네티스 클러스터 구축

1) 사전 준비

1) 액세스 키 발급 및 관리

IAM 사용자 자격 증명인 액세스 키(Access Key)는 액세스 키 ID와 보안 액세스 키를 의미하며, API 인증 토큰 발급 시 필요한 정보입니다.
API 사용 준비 문서를 참고하여 액세스 키를 발급하시기 바랍니다.

액세스 키 발급 | 카카오클라우드 기술문서

 

2) 네트워크 환경 구축
카카오클라우드에서 컴퓨팅 환경을 구축하기 위해, 우선 네트워크 환경 설정이 필요합니다. 이를 위해, 다중 가용 영역에서 NAT 인스턴스를 이용한 네트워크 구축을 참조하여 쿠버네티스 클러스터 생성을 위한 네트워크 환경을 구축하세요. 이 문서는 private 서브넷에서도 인터넷에 안전하게 연결할 수 있도록 NAT 인스턴스 생성 방법을 설명합니다. 이 문서에서 설명하는 네트워크 설정은다중 가용 영역에서 NAT 인스턴스를 이용한 네트워크 구축 문서에서 정한 값에 기반합니다.

 

2) 쿠버네티스 클러스터 생성하기

Kubernetes Engine은 VPC 기반의 관리형 쿠버네티스 서비스입니다. 복잡한 수작업 클러스터 생성/관리 절차 없이 손쉽게 쿠버네티스 클러스터를 생성하고 관리할 수 있습니다. 이 단계에서는 카카오클라우드 콘솔에 로그인하여 서비스 구성에 필요한 리소스를 직접 생성합니다. 카카오클라우드에서는 콘솔을 통해 쉽게 쿠버네티스 클러스터를 생성하는 방법은 다음과 같습니다.

 

1) 카카오클라우드 콘솔 > Kubernetes Engine > 클러스터 목록 화면에서 [클러스터 만들기] 버튼을 클릭합니다.
2) 아래 내용을 참조하여 생성할 클러스터 정보와 VPC를 설정합니다.

구분	항목	설정/입력값
기본 설정	클러스터 이름	tutorial
	Kubernetes 버전	1.26
클러스터 Network 설정	VPC	tutorial
	Subnet	- main - {VPC_ID}_sn_1 - {VPC_ID}_sn_2 - {VPC_ID}_sn_6

 

3) 클러스터 목록 화면에서 [생성한 클러스터] > [노드 풀] 탭에서 [노드 풀 만들기] 버튼을 클릭합니다.

4) 아래 내용을 참조하여 노드 풀을 생성합니다.

노드 풀 타입	인스턴스 타입	Volume	노드 수
Virtual Machine	m2a.large	50	2

 

3) kubectl로 쿠버네티스 API 호출하기

쿠버네티스 커맨드 라인 도구인 kubectl으로 명령어를 실행하여 쿠버네티스 API를 호출합니다. 클러스터와의 모든 상호작용은 제어 영역에 있는 쿠버네티스 API 서버에 API 호출을 통해 수행됩니다.

 

1) kubectl 설치하기

kubectl을 사용하기 위해 먼저 설치를 진행합니다. 사용자 환경에 따라 설치를 진행해 주시기 바랍니다.

#Homebrew 이용
brew install kubectl

#curl 이용(Intel)
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl"

#curl 이용(Apple Silicon)
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl"

 

2) 설치가 정상적으로 되었는지 아래 명령어를 통해 확인합니다.

#버전 확인
kubectl version --client

 

3) kubeconfig 파일 다운로드 및 설정

3-1) 카카오클라우드 콘솔 > Kubernetes Engine에서 생성한 클러스터의 [kubectl] 버튼을 클릭합니다.

3-2) 생성한 쿠버네티스 클러스터의 kubeconfig 파일을 kubectl 제어 설정 팝업창에서 [kubeconfig 파일 다운로드] 버튼을 클릭해 다운로드합니다.

3-3) 클러스터에 대한 접근을 구성하기 위해 다운로드받은 kubeconfig 파일(.yaml)에서 users > user > exec > env 필드를 수정합니다. 액세스 키 ID와 보안 키 입력 필드에서 생성한 키 ID와 보안 키 값을 입력합니다.

users:
- name: ${클러스터 이름}-admin
user:
    exec:
    apiVersion: client.authentication.k8s.io/v1beta1
    args: null
    command: kic-iam-auth
    env:
    - name: "OS_AUTH_URL"
        value: "https://iam.kakaocloud.com/identity/v3"
    - name: "OS_AUTH_TYPE"
        value: "v3applicationcredential"
    - name: "OS_APPLICATION_CREDENTIAL_ID"
        value: "${액세스 키 ID 입력}"
    - name: "OS_APPLICATION_CREDENTIAL_SECRET"
        value: "${보안 액세스 키 입력}"
    - name: "OS_REGION_NAME"
        value: "kr-central-2"

 

4) 기본적으로 kubectl은 $HOME/.kube/config 파일에 저장된 정보를 통해 클러스터에 접근합니다. 설정한 kubeconfig 파일을 $HOME/.kube/config 경로에 복사합니다.

mkdir $HOME/.kube
cp ${KUBECONFIG_FILE_PATH} $HOME/.kube/config
# 예시) cp ~/Downloads/kubeconfig-cluster.yaml ~/.kube/config

 

5) 카카오클라우드 인증 클라이언트 다운로드 및 설정

카카오클라우드 인증 클라이언트를 다운로드한 뒤, 카카오클라우드 인증 클라이언트에 실행 권한을 부여합니다. 그 다음, 인증 클라이언트가 실행되는 경로로 이동합니다.

sudo chmod +x ${IAM_FILE_PATH}
mv ${IAM_FILE_PATH} /usr/local/bin

 

이름	설명
IAM_FILE_PATH	설치한 인증 클라이언트 파일 경로

 

6) 쿠버네티스 API 호출

kubectl을 통해 쿠버네티스 API를 호출할 수 있습니다. 다음 명령어를 입력하면 클러스터 내 생성된 노드 목록을 조회할 수 있습니다.

kubectl get nodes

 

4) 쿠버네티스에 서비스 배포하기

1) 비공개 Container Registry에서 이미지를 pull하기 위해서는 인증이 필요합니다. 인증을 위한 Secret 키를 생성합니다.

# Container Registry 인증 시크릿 생성
kubectl create secret docker-registry kc-cr-secret \
--docker-server={PROJECT_NAME}.kr-central-2.kcr.dev \
--docker-username={ACCESS_KEY} \
--docker-password={ACCESS_SECRET_KEY}

 

이름	설명
PROJECT_NAME	카카오클라우드 콘솔의 프로젝트 이름
ACCESS_KEY	액세스 키
ACCESS_SECRET_KEY	보안 액세스 키

 

2) 예제 프로젝트의 서버를 배포합니다.

# 서버 deployment 배포
cat <<EOF | kubectl create -f-
apiVersion: apps/v1
kind: Deployment
metadata:
  name: server-deployment
spec:
  replicas: 2
  selector:
    matchLabels:
      app: server
  template:
    metadata:
      labels:
        app: server
    spec:
      containers:
      - name: server
        image: {PROJECT_NAME}.kr-central-2.kcr.dev/tutorial/kakaocloud-library-server:latest
        env:
        - name: PROFILE
          value: "local"
        ports:
        - containerPort: 8080
      imagePullSecrets:
      - name: kc-cr-secret
EOF

이름	정보
PROJECT_NAME	Container Registry를 생성한 카카오클라우드 콘솔의 프로젝트 이름

 

3) 예제 프로젝트 서버에 접속하기 위한 service를 배포합니다.

# 서버 service 배포
cat <<EOF | kubectl create -f-
apiVersion: v1
kind: Service
metadata:
  name: server-service
spec:
  type: ClusterIP
  selector:
    app: server
  ports:
  - protocol: TCP
    port: 8080
    targetPort: 8080
EOF

 

4) 예제 프로젝트의 클라이언트를 배포합니다.

# 클라이언트 deployment 배포
cat <<EOF | kubectl create -f-
apiVersion: apps/v1
kind: Deployment
metadata:
  name: client-deployment
spec:
  replicas: 2
  selector:
    matchLabels:
      app: client
  template:
    metadata:
      labels:
        app: client
    spec:
      containers:
      - name: client
        image: {PROJECT_NAME}.kr-central-2.kcr.dev/tutorial/kakaocloud-library-client:latest
        env:
        - name: SERVER_ENDPOINT
          value: "http://server-service.default.svc.cluster.local:8080"
        ports:
        - containerPort: 80
      imagePullSecrets:
      - name: kc-cr-secret
EOF

이름	정보
PROJECT_NAME	Container Registry를 생성한 카카오클라우드 콘솔의 프로젝트 이름

 

5) 예제 프로젝트 클라이언트에 접속하기 위한 service를 배포합니다. 서비스는 LoadBalancer 타입으로 생성합니다.

# 클라이언트 service 배포
cat <<EOF | kubectl create -f-
apiVersion: v1
kind: Service
metadata:
  name: client-service
spec:
  type: LoadBalancer
  selector:
    app: client
  ports:
  - protocol: TCP
    port: 80
    targetPort: 80
EOF

 

6) 콘솔에서 로드밸런서 설정

예제 프로젝트 클라이언트의 service를 LoadBalancer 타입으로 배포하면서, 카카오클라우드 콘솔에서 Load Balancer 서비스의 로드밸런서 목록에도 추가된 것을 확인할 수 있습니다. 로드밸런서 목록 > [더 보기] 아이콘 > Public IP 연결을 클릭해 외부에서 서비스에 접근할 수 있게 만들 수 있습니다.

 

5) 서비스 접속 확인하기

브라우저에서 등록한 Public IP로 접속하여 서비스를 확인합니다. 정상적으로 연결된 경우, '카카오클라우드 도서관' 서비스 화면을 볼 수 있습니다.