[yuyeol3]

⚠️ 머지하면 바로 dev 서버 배포가 나갑니다. 아래 "머지 전 체크리스트"를 끝낸 뒤 머지해 주세요. #39(server 프로필) 위에 쌓은 PR이라 #39가 먼저 머지돼야 합니다.

변경점 👍

Fin-BE-test 포크에서 하던 dev 서버 배포를 이 레포로 옮겼습니다. main push는 dev 서버로, release push는 운영 서버로 배포합니다(release 브랜치와 운영 서버는 이후에 준비).

• deploy.yml (신규)
  • ci: 기존 backend-ci.yml을 호출합니다. 테스트를 통과해야 다음 단계로 넘어갑니다.
  • build: bootJar → ghcr.io/apptivedev/fin-be:<SHA>로 푸시합니다. Docker Hub 대신 GHCR이라 별도 계정·시크릿이 없습니다.
  • deploy: GCP에 OIDC(Workload Identity Federation) 로 인증합니다. SSH 키를 GitHub에 두지 않고, IAP 터널과 OS Login으로 VM에 접속합니다. 서버에 deploy/ 파일과 .env를 복사한 뒤 remote-deploy.sh를 실행합니다.
  • 배포 파일을 바꾸는 PR에서는 이미지 빌드까지만 돕니다. 문서만 바뀐 push는 배포하지 않습니다.
• deploy/
  • docker-compose.yml: Fin-BE-test의 compose를 옮겼습니다. 바뀐 점은 다음과 같습니다.
    • compose 프로젝트 이름을 fin-be로 고정해 기존 DB 볼륨을 그대로 씁니다.
    • DB 비밀번호를 시크릿으로 받습니다.
    • DB 포트를 서버 로컬(127.0.0.1)에만 엽니다. 수집기는 SSH 터널로 접근합니다.
  • nginx/templates/default.conf.template: 도메인(SERVER_NAME)을 환경마다 치환하도록 템플릿으로 바꿨습니다.
  • remote-deploy.sh: 이미지 pull → up -d → nginx 재시작(backend IP 갱신) → nginx를 거친 /api/categories 헬스체크. 실패하면 job이 실패하고 backend 로그를 남깁니다.
• 배포 때 DB 초기화(reset.jar)를 뺐습니다. 이제 dev도 Flyway 마이그레이션만 적용하고 데이터를 유지합니다. 상품 데이터는 Fin-API 수집 워크플로가 채웁니다.
• backend-ci.yml: 모든 PR에서 돌도록 paths 필터를 뺐고(나중에 필수 체크로 걸기 위해), main push 트리거 대신 deploy.yml이 호출하도록 바꿨습니다.
• 문서: docs/implementation/deployment.md(GCP 설정 명령, Environment 변수, 운영 서버 준비, 롤백), README CI 표.

테스트 💻

• actionlint(shellcheck 포함) 통과
• 로컬에서 배포 compose를 그대로 띄워 확인(자체서명 인증서, SPRING_PROFILES_ACTIVE=dev,server)
  • Flyway 7개 적용 후 기동, nginx 경유 /api/categories 200, Swagger 200
  • OAuth redirect_uri가 https://<도메인>/...으로 생성
  • 헬스체크: 기동 중 502 → 성공, backend를 내리면 실패(종료 코드 1)
• 실제 GCP 배포는 구조상 머지 후 첫 실행에서 확인됩니다.

머지 전 체크리스트

• chore : 서버 배포용 server 프로필 추가와 공통 설정 분리 #39 머지 후 이 PR을 main 기준으로 정리
• GCP OIDC·서비스 계정·IAP 방화벽 설정 (deployment.md의 명령)
• Environment dev 변수·시크릿 등록
• Fin-BE-test의 배포 워크플로 비활성화
• VM OS Login 켜기, 기존 컨테이너 docker compose down(볼륨 유지)
• 서비스 계정으로 IAP SSH 접속 확인
• 머지 → 첫 배포 확인(/api/categories, Swagger, OAuth 로그인)

비고

• 실패하면 Fin-BE-test 워크플로를 다시 켜고 OS Login을 끄면 이전 방식으로 돌아갑니다(DB 볼륨은 그대로).
• 배포 파일을 건드리는 PR에서는 backend-ci가 두 번 돕니다(PR 트리거와 deploy.yml 호출).