데브옵스
[사례연구] Harbor와 Gitea를 멀티 AZ Active-Active로 바꾸기
두줄요약
Harbor와 Gitea를 멀티 AZ Active-Active 구조로 전환하며 상태 불일치 문제를 해결했습니다. 토큰 키 공유, 세션·볼륨 분리, zone-aware 장애 전환 전략을 정리했습니다.
문제 상황
- 단일 AZ 진입 구조로 레지스트리·Git 장애 시 CI 파이프라인 전체 중단 위험
- AZ별 독립 인스턴스의 토큰 서명 키, 로그인 세션, 파일 볼륨 상태 불일치
구조와 흐름
- 공통 externalURL과 두 AZ 파드를 묶는 스패닝 Service 기반 단일 진입점
- Harbor 양쪽 인스턴스의 core 시크릿 공유를 통한 토큰 발급·검증 일관성
- Gitea OIDC 로그인 흐름의 sticky 처리 또는 세션 저장소 공유, AZ별 독립 볼륨 소유
트레이드오프
- 평시 AZ 간 지연·대역폭 비용 절감을 위한 무거운 이미지 pull 트래픽의 preferLocal 적용
- 헬스체크 실패 시 반대 AZ 전환으로 가용성 확보
- 모든 상태의 일괄 공유 대신 토큰 키 공유, 세션 고정·공유, 볼륨 분리로 상태별 처리
성능/운영 포인트
- PKCS#1 PEM 형식의 Harbor 토큰 서명 키와 양방향 토큰 검증 확인
- backendRef를 단계적으로 전환하는 무중단 컷오버와 롤백 경로 유지
- Vault의 Raft quorum, ArgoCD의 AZ 분산 replica·HA 상태 점검

