Azure Kubernetes Service에 Node app 배포해보기
1. Azure Kubernetes Service(AKS) 란
완전 관리형 서비스로써 컨테이너화된 어플리케이션의 배포와 관리를 더욱 용이하게 해주는 서비스입니다.
AKS는 여러 사례를 친절하게 안내해주고 있습니다.
그 중에서도 저는 간편하게 기존 애플리케이션 마이그레이션로 진행해보려고 합니다.
https://azure.microsoft.com/ko-kr/solutions/architecture/migrate-existing-applications-with-aks/
2. Dockerizing
먼저 kubernetes에 올리기전에 dockerizing부터 진행하여야 합니다.
2-1. Dockerfile 생성
만약 docker가 설치되어있지 않은 상태라면 docker를 설치해주셔야 합니다. https://docs.docker.com/install/
mac의 경우 homebrew로 아래와 같이 설치 가능합니다.
brew cask install docker먼저 제가 만든 NodeJS 어플리케이션의 Dockerfile을 생성해줍니다.
FROM node:lts
WORKDIR /app
ADD . /app/
RUN npm i -g npm
RUN npm i && npm run build
ENV HOST 0.0.0.0
EXPOSE 4000
CMD ["npm", "run", "start"]Ddockerfile은 해당 NodeJS 어플리케이션마다 다르기 때문에 구성하신 scripts나 설정마다 다르게 해주어야합니다.
docker에서 pm2 설정 하실 경우에는 pm2의 공식 홈페이지에 더욱 자세히 나와있으므로 참고하시길 바랍니다.
https://pm2.keymetrics.io/docs/usage/docker-pm2-nodejs/
Dockerfile을 만드셨다면 .dockerignore 파일도 생성해줍니다.
node_modules
package-lock.json
yarn.lock저는 node_modules만 넣었지만 컨테이너에 포함되지 말아야할 것들이 있다면 추가해주시면 됩니다.
2-2. Docker image 생성 및 테스트
다음으로 Docker 컨테이너 이미지를 생성해줍니다.
docker build -t [이미지 이름]:[태그 이름] .
# 예시
docker build -t jintube:0.1.0 .여기서 jintube 부분이 이미지의 이름이 되게 되는데요. 이부분은 여러분들이 하시고 싶은 이름으로 진행하셔야 합니다.
이 후에 테스트로 이 Docker 이미지를 실행해보도록 하겠습니다.
docker run -it -p 4000:4000 [이미지 이름]:[태그 이름]
# 예시
docker run -it -p 4000:4000 jintube:0.1.0포트와 이미지 이름은 생성하신 것에 따라 다를 수 있으니 조정해서 사용하시면 됩니다.
3. Azure Container Registry 이용하기
Dockerizing을 완료하였다면 이제 Azure Container Registry에 만들어진 컨테이너 이미지를 올립니다.
진행하시기 전에 Azure에 접속할 계정을 만들어주셔야 합니다. 기존의 마이크로소프트 계정이 있으시다면 그 계정으로 접속해주시면 됩니다. 또한 깃허브 계정으로도 로그인이 됩니다. 만약 깃허브 계정을 연결하시기 싫으시다면 마이크로소프트 계정을 새로 만드시면 됩니다.
3-1. Azure CLI 설치
각 운영체제 마다 다르게 설치 가능합니다. 아래의 링크를 참조하시면 됩니다.
https://docs.microsoft.com/ko-kr/cli/azure/install-azure-cli?view=azure-cli-latest
mac의 경우에는 homebrew로 설치 가능합니다.
# 설치
$ brew install azure-cli
# 설치 확인
$ az --version설치 후 로그인을 해주어야합니다.
$ az login3-2. Azure Container Registry 만들기
먼저 리소스 그룹을 생성해줍니다.
$ az group create --name [리소스 그룹 이름] --location [지역 이름]
# 예시
$ az group create --name jintube-resource --location koreacentral지역이름은 아래의 링크에서 참조하시면 됩니다. https://azure.microsoft.com/en-us/global-infrastructure/locations/
다음으로 Azure Container Registry 인스턴스를 생성해줍니다.
$ az acr create --resource-group [리소스 그룹 이름] --name [acrName] --sku Basic
# 예시
$ az acr create --resource-group jintube-resource --name jintubearc --sku Basic다음으로 Container Registry에 로그인하여야 합니다.
$ az acr login --name [acrName]
$ az acr login --name jintubearc3-3. 컨테이너 이미지 푸시
먼저 컨테이너 이미지를 푸시하기 위해 로그인 서버 주소를 가지고 옵니다.
$ az acr list --resource-group [리소스 그룹 이름] --query "[].{acrLoginServer:loginServer}" --output table
# 예시
$ az acr list --resource-group jintube-resource --query "[].{acrLoginServer:loginServer}" --output table다음으로 이미지 태그를 지정해줍니다.
$ docker tag [태그 이름] [이미지 서버 주소]/[컨테이너 이름]:[버전]
# 예시
$ docker tag jintube:0.1.0 jintubearc.azurecr.io/jintube:v1태그가 제대로 적용되었는지는 docker images 명령으로 확인해주시면 됩니다.
이제 레지스트리에 이미지를 푸시해보겠습니다.
$ docker push [이미지 서버 주소]/[컨테이너 이름]:[버전]
# 예시
$ docker push jintubearc.azurecr.io/jintube:v1푸시가 완료되었으면 제대로 ACR에 올라갔는지 한 번 확인해봅니다.
$ az acr repository list --name [acrName] --output table
# 예시
$ az acr repository list --name jintubearc --output table4. Kubernetes 클러스터 만들기
$ az aks create \
--resource-group [리소스 그룹 이름] \
--name [클러스터 이름] \
--node-count [노드 갯수] \
--generate-ssh-keys \
--attach-acr [acrName]
# 예시
$ az aks create \
--resource-group jintube-resource \
--name jintubeakscluster \
--node-count 2 \
--generate-ssh-keys \
--attach-acr jintubearc다음으로 로컬 컴퓨터에서 Kubernetes 클러스터를 연결하기 위해서 kubectl를 사용하여야 합니다.
아래 명령어로 설치가 가능합니다.
$ az aks install-cli다음으로 kubectl를 사용하여 클러스터에 연결해줍니다.
$ az aks get-credentials --resource-group [리소스 그룹 이름] --name [클러스터 이름]
# 예시
$ az aks get-credentials --resource-group jintube-resource --name jintubeakscluster클러스터가 제대로 연결되었는지 node를 조회해봅니다.
$ kubectl get nodes5. 어플리케이션 실행
어플리케이션을 생성한 Kubernetes 클러스터에 배포해보도록 하겠습니다.
먼저 yaml파일로 Deployment와 Service를 정의해줍니다.
apiVersion: apps/v1
kind: Deployment
metadata:
name: jintube-app
spec:
replicas: 1
strategy:
rollingUpdate:
maxSurge: 1
maxUnavailable: 1
minReadySeconds: 5
template:
metadata:
labels:
app: jintube-app
spec:
nodeSelector:
'beta.kubernetes.io/os': linux
containers:
- name: jintube
image: jintubearc.azurecr.io/jintube:v1
resources: {}
env:
- name: PORT
value: '4000'
---
apiVersion: v1
kind: Service
metadata:
labels:
app: jintube-app
name: jintube-app-service
spec:
type: LoadBalancer
ports:
- port: 80
protocol: TCP
targetPort: 4000
selector:
app: jintube-app위에는 예시입니다. 각자의 어플리케이션 마다 다르게 설정해주셔야 합니다.
kubectl apply 명령어로 배포하여줍니다.
$ kubectl apply -f [파일 이름].yaml
# 예시
$ kubectl apply -f jintube.yaml제대로 배포되었는지 아래의 명령어로 확인해봅니다.
$ kubectl get service [서비스 이름] --watch
# 예시
$ kubectl get service jintube-app-service --watch위의 명령어를 실행하고 EXTERNAL-IP가 나오면 해당 ip로 접속시 어플리케이션이 작동함을 확인하시면 됩니다.
