인프라 전체 이전 가이드

!전체 흐름

2026-04-27 초판 대비: DB 서버 이전 신규 / "시크릿 분실" 전제 폐기(age 볼트로 복구) / 유령 시크릿(STRIPE·OMISE·JWT_REFRESH) 정리 / flight-poller 실구성 반영 / KV 복제키 3종 / DLQ·SHARE_TOKENS 누락 위험 명시.

1현재 인프라 (2026-05-31 검증)

Cloudflare 자원 (계정 이전 대상)

자체 DB (이번엔 이전 대상)

외부 자원: 도메인 kecosystem.com(NS/DNS) · Google Maps(서버+브라우저키 2종) · AviationStack · Push(VAPID 동일 유지 시 영향 0).

2시크릿 — age 볼트 기반

실제 사용 시크릿 (값 원천 = workers/api/.dev.vars):

ADB 서버 이전

A0. 새 서버 준비 (D-7)

• Docker + Compose 설치, 공인 IP 확보, 인바운드 포트(예 35432) 개방
• Hyperdrive 경유 접속이라 IP 화이트리스트 불필요 / 외부노출엔 TLS·방화벽 권장

A1. 새 서버에 컨테이너 기동

bash scripts/vault-pull.sh          # infra/.env(DB비번) 복원
cd infra
docker compose -f docker-compose.prod.yml up -d
# 최초 부팅 시 init.sql이 postgis/uuid-ossp + ktaxi_test 생성
docker exec ktaxi-postgres pg_isready -U ktaxi -d ktaxi

새 infra/.env의 POSTGRES_PASSWORD를 구 비번과 동일하게 두면 .dev.vars·Hyperdrive 문자열 재사용이 쉬움.

A2. 데이터 이관 (pg_dump → pg_restore)

# D-1 풀백업 (구 서버)
PGPASSWORD=$PW pg_dump -h 42.127.251.21 -p 35432 -U ktaxi -d ktaxi \
  --format=custom --no-owner --no-acl --file=/tmp/ktaxi.dump

# D-Day 컷오버: 쓰기 잠깐 정지 → 최종 덤프 → 새 서버로 복원
PGPASSWORD=$NEWPW pg_restore -h $NEW_DB_HOST -p 35432 -U ktaxi -d ktaxi \
  --no-owner --no-acl --clean --if-exists /tmp/ktaxi-final.dump

확장은 init.sql이 이미 생성. --no-owner --no-acl로 소유자 회피. PostGIS geometry·spatial_ref_sys는 custom 덤프에 포함됨.

A3. 검증

psql -h $NEW_DB_HOST -p 35432 -U ktaxi -d ktaxi -c "
  SELECT count(*) FROM users; SELECT count(*) FROM bookings WHERE status='pending';
  SELECT count(*) FROM payments; SELECT PostGIS_full_version();"

DB만 이전(CF 유지) 시나리오: 여기서 Hyperdrive connection-string만 새 호스트로 갱신 후 api·flight-poller redeploy 하면 끝 — Part B 생략.

BCloudflare 계정 이전

B1. 새 계정 리소스 생성

wrangler logout && wrangler login   # 새 계정
wrangler kv namespace create CACHE          # → NEW_KV_CACHE_ID
wrangler kv namespace create SHARE_TOKENS   # ⚠️ 코드가 참조 → 함께 생성
wrangler r2 bucket create ktaxi-storage
wrangler hyperdrive create ktaxi-db \
  --connection-string="postgres://ktaxi:$PW@$NEW_DB_HOST:35432/ktaxi"
wrangler queues create ktaxi-notifications     && wrangler queues create ktaxi-notifications-dlq
wrangler queues create ktaxi-settlements       && wrangler queues create ktaxi-settlements-dlq

B2. toml ID 갱신 + 시크릿 + Worker deploy

⚠️ ID 변경은 main 커밋 금지(별도 브랜치 또는 직후 revert). 갱신 대상: api(hyperdrive·CACHE id + SHARE_TOKENS 블록 추가), realtime(CACHE id), flight-poller(hyperdrive·CACHE id).

cd workers/api
for k in JWT_SECRET INTERNAL_SECRET VAPID_PUBLIC_KEY VAPID_PRIVATE_KEY VAPID_SUBJECT \
         GOOGLE_MAPS_API_KEY AVIATIONSTACK_API_KEY; do
  grep "^$k=" .dev.vars | cut -d= -f2- | wrangler secret put "$k"; done
echo "https://ktaxi-realtime..workers.dev" | wrangler secret put REALTIME_BASE_URL

cd ../realtime   # api와 동일 JWT/INTERNAL
grep '^JWT_SECRET='      ../api/.dev.vars | cut -d= -f2- | wrangler secret put JWT_SECRET
grep '^INTERNAL_SECRET=' ../api/.dev.vars | cut -d= -f2- | wrangler secret put INTERNAL_SECRET

cd ../consumers/flight-poller   # 자체 시크릿
for k in AVIATIONSTACK_API_KEY VAPID_PUBLIC_KEY VAPID_PRIVATE_KEY VAPID_SUBJECT; do
  grep "^$k=" ../../api/.dev.vars | cut -d= -f2- | wrangler secret put "$k"; done

# 5개 워커 deploy
cd ../../.. ; for w in api realtime consumers/notification consumers/settlement consumers/flight-poller; do
  (cd workers/$w && pnpm exec wrangler deploy); done

B3. Pages deploy ×3

for a in customer-web driver-web admin-web; do
  (cd apps/$a && pnpm exec next build && pnpm exec wrangler pages deploy out \
     --project-name=ktaxi-${a%-web} --branch=main --commit-dirty=true); done

B4. 데이터 복제 (KV 3키 + R2)

# KV — config 3종 (구→신)
for k in config:messenger-channels config:pricing config:points; do
  wrangler kv key get --namespace-id=$OLD "$k" > /tmp/${k//:/_}.json; done
# (새 계정 로그인 후)
for k in config:messenger-channels config:pricing config:points; do
  wrangler kv key put --namespace-id=$NEW "$k" @/tmp/${k//:/_}.json; done

# R2 — rclone (cf-old/cf-new remote 등록 후)
rclone copy cf-old:ktaxi-storage cf-new:ktaxi-storage --progress --transfers=8 --checkers=16
rclone size cf-old:ktaxi-storage; rclone size cf-new:ktaxi-storage   # 일치 확인

B5. DNS 컷오버 (다운타임 1~5분)

• 옵션 A: 도메인 전체를 새 CF로(NS 변경 → SSL 자동발급 → 레코드/커스텀도메인 연결). 깔끔, zone 이전 검증 필요.
• 옵션 B: 도메인은 구 CF, DNS만 새 워커/Pages로. 빠르나 분리 운영.

3검증 (30분)

curl https://api.taxi.kecosystem.com/health                  # {"status":"ok","db":true}
curl https://api.taxi.kecosystem.com/v1/public/messenger-channels
curl https://api.taxi.kecosystem.com/v1/public/pricing       # config:pricing 복제 확인
curl -I https://rt.taxi.kecosystem.com/admin/ws              # 401 정상
cd workers/api && pnpm exec wrangler tail --format pretty   # 매분 Ok + [cron] swept N

브라우저: 어드민 로그인+토스트 / 기사앱 온라인 토글 / 수동배차→기사앱 모달 / PWA 푸시 1회 / QR 승하차 1사이클 / flight-poller 5분 로그. DB 행수 재확인.

4롤백 · 정리

?FAQ