🚀 Multi-Region Infrastructure Quick Start

📋 개요

DTA-Wide Multi-Region Infrastructure를 5분 안에 이해하고 시작할 수 있는 빠른 가이드입니다.

🎯 구조 한눈에 보기

🌍 DTA-Wide Infrastructure
├── 🇪🇺 Europe (독일): dta-cloud-de-* @ europe-west3
└── 🇰🇷 Asia (한국): dta-cloud-* @ asia-northeast3

Project 매핑

Environment	🇪🇺 Europe	🇰🇷 Asia
Dev	`dta-cloud-de-dev`	`dta-cloud-dev`
Stage	`dta-cloud-de-stage`	`dta-cloud-stage`
Prod	`dta-cloud-de-prod`	`dta-cloud-prod`

⚡ 5분 배포 가이드

1단계: 환경 준비 (1분)

# 프로젝트 디렉토리로 이동
cd infrastructure/terragrunt

# 환경 선택
export ENVIRONMENT=dev  # 또는 stage, prod

2단계: Global 서비스 배포 (2분)

# Global 서비스 한번에 배포
terragrunt run-all apply --terragrunt-working-dir $ENVIRONMENT/global/

3단계: Region별 배포 (2분)

# Europe region (기존)
terragrunt run-all apply --terragrunt-working-dir $ENVIRONMENT/regions/europe-west3/

# Asia region (신규)  
terragrunt run-all apply --terragrunt-working-dir $ENVIRONMENT/regions/asia-northeast3/

4단계: 검증 (30초)

# 서비스 상태 확인
curl https://dta-wide-api-dev-eu-xxxxxxxx-ey.a.run.app/health
curl https://dta-wide-api-dev-asia-xxxxxxxx-an.a.run.app/health

🎯 일반적인 작업들

특정 Region만 배포

# 🇪🇺 EU만 배포
terragrunt run-all apply --terragrunt-working-dir dev/regions/europe-west3/

# 🇰🇷 Asia만 배포
terragrunt run-all apply --terragrunt-working-dir dev/regions/asia-northeast3/

특정 서비스만 업데이트

# CloudSQL 업데이트 (모든 region)
terragrunt apply --terragrunt-working-dir dev/regions/europe-west3/cloudsql/
terragrunt apply --terragrunt-working-dir dev/regions/asia-northeast3/cloudsql/

# Cloud Scheduler 업데이트 (Asia only)
terragrunt apply --terragrunt-working-dir dev/regions/asia-northeast3/cloud-scheduler/

설정 검증

# 전체 설정 검증
terragrunt validate --terragrunt-working-dir dev/

# 특정 region 검증
terragrunt validate --terragrunt-working-dir dev/regions/asia-northeast3/

🔧 자주 하는 작업

새로운 Region 추가

Step 1: Region 정의

# shared/regions.hcl에 추가
"us-central1" = {
  region      = "us-central1"
  zone        = "us-central1-a"
  timezone    = "America/Chicago"
  url_suffix  = "us"
}

Step 2: Project 매핑

# dev/env.hcl에 추가
projects = {
  europe = { ... }  # 기존
  asia   = { ... }  # 기존
  
  us = {
    project_id = "dta-cloud-us-dev"
    region     = "us-central1"
  }
}

Step 3: 배포

# 기존 region 복사
cp -r dev/regions/europe-west3 dev/regions/us-central1

# region.hcl 수정 후 배포
terragrunt run-all apply --terragrunt-working-dir dev/regions/us-central1/

환경별 배포

# Dev → Stage → Prod 순차 배포
for env in dev stage prod; do
  echo "🚀 Deploying $env environment..."
  terragrunt run-all apply --terragrunt-working-dir $env/
done

롤백

# 특정 서비스 롤백
git checkout HEAD~1 -- infrastructure/terragrunt/dev/regions/asia-northeast3/cloudsql/
terragrunt apply --terragrunt-working-dir dev/regions/asia-northeast3/cloudsql/

# 전체 환경 롤백
git checkout HEAD~1 -- infrastructure/terragrunt/dev/
terragrunt run-all apply --terragrunt-working-dir dev/

🔍 모니터링 빠른 확인

상태 체크

# 모든 region 상태 한번에 확인
./scripts/health-check-all.sh dev

# 성능 메트릭 확인
gcloud monitoring metrics list \
  --filter="metric.type=run.googleapis.com/request_latencies" \
  --project=dta-cloud-dev

비용 확인

# 월별 비용 확인
gcloud billing budgets list \
  --billing-account=01A3DE-04193F-06C496 \
  --filter="displayName:DTA-Wide"

# Region별 비용 비교
./scripts/cost-breakdown.sh

🚨 긴급 상황 대응

🔥 장애 대응 (3분 안에)

1분째: 문제 파악

# 빠른 상태 확인
./scripts/emergency-check.sh

2분째: 트래픽 우회

# 문제 region 트래픽 차단
gcloud compute backend-services update dta-wide-backend \
  --global \
  --remove-backends=<problem-region>-neg

3분째: 팀 알림

# Slack 알림
curl -X POST -H 'Content-type: application/json' \
  --data '{"text":"🚨 Multi-Region Infrastructure Alert: <region> is down"}' \
  $SLACK_WEBHOOK_URL

🔄 빠른 복구

# 자동 복구 스크립트
./scripts/auto-recovery.sh <environment> <region>

# 수동 복구 (자동 실패시)
terragrunt destroy --terragrunt-working-dir $ENV/regions/$REGION/$SERVICE/
terragrunt apply --terragrunt-working-dir $ENV/regions/$REGION/$SERVICE/

📚 학습 리소스

필수 읽기

Multi-Region 아키텍처 - 🌍 전체 구조 이해 (10분)
Multi-Region 관리 - 🔧 일상 운영 방법 (15분)

상황별 가이드

배포 중 문제: 배포 가이드
운영 중 문제: 트러블슈팅
성능 이슈: 성능 튜닝 섹션

실습 예제

기본 배포 실습

# 1. Dev 환경에 새로운 서비스 추가
mkdir infrastructure/terragrunt/dev/regions/europe-west3/new-service

# 2. 기본 terragrunt.hcl 생성
cat > infrastructure/terragrunt/dev/regions/europe-west3/new-service/terragrunt.hcl << EOF
include "root" {
  path = find_in_parent_folders("root.hcl")
  expose = true
}

terraform {
  source = "../../../../terraform/modules/new-service"
}

locals {
  region_vars = read_terragrunt_config("../region.hcl")
}

inputs = {
  project_id = local.region_vars.locals.project_id
  region     = local.region_vars.locals.region
}
EOF

# 3. 배포
terragrunt apply --terragrunt-working-dir dev/regions/europe-west3/new-service/

Cross-Region 설정 실습

# 1. Asia region에도 동일 서비스 배포
cp -r dev/regions/europe-west3/new-service dev/regions/asia-northeast3/

# 2. 양쪽 region에 배포
for region in europe-west3 asia-northeast3; do
  terragrunt apply --terragrunt-working-dir dev/regions/$region/new-service/
done

🎯 체크리스트

배포 전 체크리스트

Terragrunt/Terraform 최신 버전인가?
GCP 프로젝트가 생성되어 있는가?
Service Account 권한이 설정되어 있는가?
필요한 APIs가 활성화되어 있는가?
terragrunt validate 통과하는가?

배포 후 체크리스트

모든 서비스가 정상 동작하는가?
API 엔드포인트 응답하는가?
데이터베이스 연결되는가?
스케줄러가 정상 동작하는가?
모니터링 메트릭이 수집되는가?

문제 발생시 체크리스트

에러 메시지를 정확히 확인했는가?
로그를 확인해봤는가?
권한 문제는 아닌가?
네트워크 연결은 정상인가?
롤백이 필요한가?

🎉 성공 확인

배포 성공 지표

# ✅ 성공 체크
echo "🎉 Multi-Region Infrastructure Health Check"

# 1. 모든 API 엔드포인트 응답
curl -f https://dta-wide-api-dev-eu-xxxxxxxx-ey.a.run.app/health    # EU
curl -f https://dta-wide-api-dev-asia-xxxxxxxx-an.a.run.app/health  # Asia

# 2. 데이터베이스 연결
gcloud sql connect db-dta-wide-dev-eu --project=dta-cloud-de-dev    # EU DB
gcloud sql connect db-dta-wide-dev-asia --project=dta-cloud-dev     # Asia DB

# 3. 스케줄러 동작
gcloud scheduler jobs list --project=dta-cloud-de-dev --location=europe-west3
gcloud scheduler jobs list --project=dta-cloud-dev --location=asia-northeast3

echo "✅ All systems operational!"

성능 검증

# 지연시간 측정
echo "⚡ Performance validation..."

# EU region
time curl -s https://dta-wide-api-dev-eu-xxxxxxxx-ey.a.run.app/health

# Asia region  
time curl -s https://dta-wide-api-dev-asia-xxxxxxxx-an.a.run.app/health

echo "📊 Performance targets:"
echo "  EU users: < 50ms ✅"
echo "  Asia users: < 100ms ✅"

🆘 도움 요청

문제 해결 순서

📖 문서 확인: 이 가이드 및 관련 문서
🔍 로그 확인: gcloud logging read ...
🧪 간단 테스트: terragrunt validate, curl 테스트
👥 팀 문의: Slack #devops 채널
🆘 긴급 상황: PagerDuty escalation

유용한 명령어 모음

# 빠른 상태 체크
alias check-eu="terragrunt validate --terragrunt-working-dir dev/regions/europe-west3/"
alias check-asia="terragrunt validate --terragrunt-working-dir dev/regions/asia-northeast3/" 
alias check-global="terragrunt validate --terragrunt-working-dir dev/global/"

# 빠른 배포
alias deploy-eu="terragrunt run-all apply --terragrunt-working-dir dev/regions/europe-west3/"
alias deploy-asia="terragrunt run-all apply --terragrunt-working-dir dev/regions/asia-northeast3/"
alias deploy-global="terragrunt run-all apply --terragrunt-working-dir dev/global/"

# 빠른 롤백
alias rollback-asia="git checkout HEAD~1 -- infrastructure/terragrunt/dev/regions/asia-northeast3/"

🎯 다음 단계

배포가 완료되었다면:

📋 개요​

🎯 구조 한눈에 보기​

Project 매핑​

⚡ 5분 배포 가이드​

1단계: 환경 준비 (1분)​

2단계: Global 서비스 배포 (2분)​

3단계: Region별 배포 (2분)​

4단계: 검증 (30초)​

🎯 일반적인 작업들​

특정 Region만 배포​

특정 서비스만 업데이트​

설정 검증​

🔧 자주 하는 작업​

새로운 Region 추가​

Step 1: Region 정의​

Step 2: Project 매핑​

Step 3: 배포​

환경별 배포​

롤백​

🔍 모니터링 빠른 확인​

상태 체크​

비용 확인​

🚨 긴급 상황 대응​

🔥 장애 대응 (3분 안에)​

1분째: 문제 파악​

2분째: 트래픽 우회​

3분째: 팀 알림​

🔄 빠른 복구​

📚 학습 리소스​

필수 읽기​

상황별 가이드​

실습 예제​

기본 배포 실습​

Cross-Region 설정 실습​

🎯 체크리스트​

배포 전 체크리스트​

배포 후 체크리스트​

문제 발생시 체크리스트​

🎉 성공 확인​

배포 성공 지표​

성능 검증​

🆘 도움 요청​

문제 해결 순서​

유용한 명령어 모음​

🎯 다음 단계​

📋 개요

🎯 구조 한눈에 보기

Project 매핑

⚡ 5분 배포 가이드

1단계: 환경 준비 (1분)

2단계: Global 서비스 배포 (2분)

3단계: Region별 배포 (2분)

4단계: 검증 (30초)

🎯 일반적인 작업들

특정 Region만 배포

특정 서비스만 업데이트

설정 검증

🔧 자주 하는 작업

새로운 Region 추가

Step 1: Region 정의

Step 2: Project 매핑

Step 3: 배포

환경별 배포

롤백

🔍 모니터링 빠른 확인

상태 체크

비용 확인

🚨 긴급 상황 대응

🔥 장애 대응 (3분 안에)

1분째: 문제 파악

2분째: 트래픽 우회

3분째: 팀 알림

🔄 빠른 복구

📚 학습 리소스

필수 읽기

상황별 가이드

실습 예제

기본 배포 실습

Cross-Region 설정 실습

🎯 체크리스트

배포 전 체크리스트

배포 후 체크리스트

문제 발생시 체크리스트

🎉 성공 확인

배포 성공 지표

성능 검증

🆘 도움 요청

문제 해결 순서

유용한 명령어 모음

🎯 다음 단계