Feat: 🎉 Staging서버 오픈 🎉

[lunarbae628]

🛰️ Issue Number

• Feat: staging 서버 오픈 #172

🪐 작업 내용

staging 서버

dev서버에 배포전 테스트(부하테스트, 기능테스트 등등)을 위해 staging서버 구축했습니다.
서버의 구조는 dev서버와 같습니다.(포트는 http: 8080, https: 8443)
Mailpit을 통해 이메일 인증 로직을 실제 SMTP 없이 테스트할 수 있도록 구성했습니다.

Docker Compose 및 인프라 구성

• docker-compose.stg.yml 추가 및 staging 네트워크(docsa_stg_net) 분리
• 서비스별 prefix(-stg)로 컨테이너명, 볼륨, 네트워크 구분
• deploy.sh 스크립트에 TARGET=stg 인자 추가 → staging용 compose 자동 선택
• --env-file .stg.env 기반으로 환경 변수 분리 관리

Mailpit 도입 (이메일 테스트 환경)

• axllent/mailpit 이미지 추가
• /mailpit/ 경로로 외부접속 가능
• application-stg.yml에 테스트용 메일 설정 추가:

mail:
  host: mailpit
  port: 1025
  username: ${MAIL_USERNAME:[email protected]}
  password: ${MAIL_PASSWORD:docsa!}
  smtp-auth: false
  starttls-enable: false

• 실제 메일 발송 없이 Mailpit UI (https://stg.api.docsa.o-r.kr:8443/mailpit/) 에서 확인 가능(부하테스트에서 활용도 가능할듯? local테스트에서도 사용가능할듯)

CI-CD

• dev와 staging브랜치에 push/pr 시 ci-cd가 작동
• push/pr된 브랜치 기준으로 도커이미지가 push 및 브랜치에 맞추어 각 서버에 배포됩니다. (staging에 push하면 stg서버에 배포됨)
• 도커이미지 태그가 변경. push/pr된 브랜치에 따라 dev, staging, dev-abc1234, staging-def5678 (SHORT_깃_SHA 7자리)

📚 Reference

• staging 서버: https://stg.api.docsa.o-r.kr:8443/

• staging 그라파나: https://stg.api.docsa.o-r.kr:8443/grafana/

• staging mailpit ui: https://stg.api.docsa.o-r.kr:8443/mailpit/

• 로컬에서 mailpit을 도커로 띄워 이메일 관련 테스트 가능하도록 수정 했습니다. (2025.10.25 수정 )

  • docker run --name mailpit-local --rm -p 1025:1025 -p 8025:8025 axllent/mailpit:latest
  • 위처럼 도커에 mailpit를 띄워 로컬호스트:8025로 mailpit ui접근 및 이메일 테스트가 가능합니다.
  • 기존처럼 smtp.gmail로 이메일을 받으려면 application-local.yml의 환경변수를 변경하시면 smtp로 작동합니다.

궁금하거나 설명이 필요하시면 언제든지 말씀해주세요. 저도 뇌를 놓고 만든거라 잘 찾아보고 답드리겠습니당.

✅ Check List

• 코드가 정상적으로 컴파일되나요?
• 테스트 코드를 통과했나요?
• merge할 브랜치의 위치를 확인했나요?
• Label을 지정했나요?

[ky1nonly]

수고하셨습니다!

[2ternal]

수고하셨습니다
그럼 앞으로 날리게될 pr은 dev가 아니라 staging 브랜치로 날리게 되나요?

[lunarbae628]

수고하셨습니다 그럼 앞으로 날리게될 pr은 dev가 아니라 staging 브랜치로 날리게 되나요?

넵 맞습니다! staging에서 pr후 머지되어 staging서버에 배포 후 각종 테스트진행 후 문제 없으면 dev에 pr날려 머지하면 될것 같습니다!

[sleepyhoon]

굉장합니다 ... 고생하셨습니다