영어학원 사이트 GKE로 나눠 배포하기

이름 대응

원문 저장소 폴더 이름(orders, products 등)과 .env의 REACT_APP_ORDERS_URL / REACT_APP_PRODUCTS_URL 키는 그대로 둡니다. 스토리만 수강신청·강의목록으로 읽습니다.

Task 1 · 소개·환경

Cloud Shell · 프로젝트

콘솔에서 Cloud Shell을 연 뒤 계정·프로젝트를 확인합니다.

gcloud auth list
gcloud config list project
echo $GOOGLE_CLOUD_PROJECT

프로젝트가 비어 있으면 본인 프로젝트로 맞춥니다.

gcloud config set project ${GOOGLE_CLOUD_PROJECT}

기본 존 예시는 랩에서 자주 쓰는 europe-west1-b입니다. 다른 존을 써도 됩니다.

gcloud config set compute/zone europe-west1-b

Task 2 · 클론·setup

저장소 · Node 의존성

cd ~
git clone https://github.com/googlecodelabs/monolith-to-microservices.git
cd ~/monolith-to-microservices
./setup.sh

setup.sh는 의존성 설치까지 포함하며 수 분이 걸릴 수 있습니다. Node가 오래되면 Cloud Shell에서 nvm install --lts를 먼저 실행하는 것이 원문 README 권장입니다.

Task 3 · GKE 클러스터 academy-prod

API · 클러스터 3노드

gcloud services enable container.googleapis.com cloudbuild.googleapis.com

gcloud container clusters create academy-prod \
  --num-nodes 3 \
  --zone europe-west1-b

생성이 끝나면 자격 증명을 받고 노드를 확인합니다. (gcloud container clusters create로 방금 만든 경우 get-credentials는 보통 자동이지만, 콘솔에서 만든 클러스터면 반드시 실행합니다.)

gcloud container clusters get-credentials academy-prod --zone europe-west1-b
gcloud compute instances list

Task 4 · 통합 사이트(모놀리스) 배포

Cloud Build · LoadBalancer 80→8080

원문 랩은 ./deploy-monolith.sh로 고정 이름 monolith를 올립니다. 이 가이드는 학원 이미지 이름에 맞춰 같은 단계를 명시적으로 적습니다.

cd ~/monolith-to-microservices/monolith
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-monolith:1.0.0 .

kubectl create deployment academy-monolith \
  --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-monolith:1.0.0

kubectl expose deployment academy-monolith \
  --type=LoadBalancer \
  --port 80 \
  --target-port 8080

kubectl get service academy-monolith

Task 5 · 수강신청(enrollments) API 분리

orders 폴더 → academy-enrollments · 80→8081

이미지 빌드·배포·노출

cd ~/monolith-to-microservices/microservices/src/orders
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-enrollments:1.0.0 .

kubectl create deployment academy-enrollments \
  --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-enrollments:1.0.0

kubectl expose deployment academy-enrollments \
  --type=LoadBalancer \
  --port 80 \
  --target-port 8081

kubectl get service academy-enrollments

EXTERNAL-IP를 메모합니다. (스토리: 수강신청 API. 원문 경로·JSON은 여전히 /api/orders.)

.env 수정 (REACT_APP_*)

cd ~/monolith-to-microservices/react-app
nano .env.monolith

수강신청 IP로 바꿉니다. 강의목록은 아직 상대 경로로 둡니다.

REACT_APP_ORDERS_URL=http://<ENROLLMENTS_IP>/api/orders
REACT_APP_PRODUCTS_URL=/service/products

nano: Ctrl+O → Enter → Ctrl+X.

통합 사이트 재빌드·롤아웃

npm run build:monolith
cd ~/monolith-to-microservices/monolith
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-monolith:2.0.0 .
kubectl set image deployment/academy-monolith \
  academy-monolith=gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-monolith:2.0.0

Task 6 · 커리큘럼(courses) API 분리

products 폴더 → academy-courses · 80→8082

cd ~/monolith-to-microservices/microservices/src/products
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-courses:1.0.0 .

kubectl create deployment academy-courses \
  --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-courses:1.0.0

kubectl expose deployment academy-courses \
  --type=LoadBalancer \
  --port 80 \
  --target-port 8082

kubectl get service academy-courses

.env에 강의목록 URL

cd ~/monolith-to-microservices/react-app
nano .env.monolith

REACT_APP_ORDERS_URL=http://<ENROLLMENTS_IP>/api/orders
REACT_APP_PRODUCTS_URL=http://<COURSES_IP>/api/products

npm run build:monolith
cd ~/monolith-to-microservices/monolith
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-monolith:3.0.0 .
kubectl set image deployment/academy-monolith \
  academy-monolith=gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-monolith:3.0.0

Task 7 · 프론트 분리·모놀리스 삭제

academy-frontend · 80→8080 · 정리

모놀리스용으로 맞춰 둔 URL 설정을 프론트 빌드에 복사합니다.

cd ~/monolith-to-microservices/react-app
cp .env.monolith .env
npm run build

cd ~/monolith-to-microservices/microservices/src/frontend
gcloud builds submit --tag gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-frontend:1.0.0 .

kubectl create deployment academy-frontend \
  --image=gcr.io/${GOOGLE_CLOUD_PROJECT}/academy-frontend:1.0.0

kubectl expose deployment academy-frontend \
  --type=LoadBalancer \
  --port 80 \
  --target-port 8080

세 마이크로서비스가 준비되면 통합 배포를 제거합니다.

kubectl delete deployment academy-monolith
kubectl delete service academy-monolith

kubectl get services

포트 맵 요약

비용 정리 (선택)

실습이 끝나면 클러스터·로드밸런서 요금이 나오지 않게 프로젝트를 삭제하거나 리소스를 직접 지웁니다.

gcloud container clusters delete academy-prod --zone europe-west1-b
# 또는 실습 전용 프로젝트 전체 삭제:
# gcloud projects delete ${GOOGLE_CLOUD_PROJECT}