[yuyeol3]

변경점 👍

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 표. docs : 기획·구현 문서 추가 #38 문서(목록, 개발 가이드 CI 표, 아키텍처 스택, 인증 문서의 server 프로필 설명)에 연결했습니다.
• 보안 범위: 워크플로가 등록하는 SSH 키는 1시간 뒤 만료됩니다. 서비스 계정의 OS Login 관리자 권한은 배포 VM에만, IAP SSH 방화벽 규칙은 iap-ssh 태그가 붙은 VM에만 적용됩니다. GCP에는 SSM Run Command 같은 방식이 없어서 IAP 대역(35.235.240.0/20)에서 22번으로 들어오는 규칙 하나는 필요합니다.

테스트 💻

• 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 방화벽 설정, 고정 IP 전환 (deployment.md의 명령)
• Environment dev 변수·시크릿 등록
• Fin-BE-test의 배포 워크플로 비활성화
• VM OS Login 켜기, 기존 컨테이너와 DB 볼륨 삭제(docker compose down -v)
  • 지금 dev DB는 Fin-BE-test의 schema.sql로 만들어져 Flyway 이력과 수집기 테이블이 없습니다. 데이터도 매 배포마다 초기화되던 시드(상품 113, 유저 4)라, 한 번 비우고 Flyway가 V1부터 적용하게 합니다.
  • 상품은 Fin-API#18 머지 직후 수집을 수동 실행해 채웁니다. 그 전까지 dev 상품 목록은 비어 있습니다.
• 서비스 계정으로 IAP SSH 접속 확인
• 머지 → 첫 배포 확인(/api/categories, Swagger, OAuth 로그인)

비고

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

[yuyeol3]

머지는 서버 설정을 위해 제가 할테니 리뷰 후 approve까지만 부탁드립니다!!