Skip to content

[chore] 서버 실행 구성: compose 운영 파일·Caddy·배포 스크립트(상태 확인·되돌리기) #92

Open

Description

@chjpooh2002

작업 내용

서버에서 앱을 띄우고 교체하는 파일을 저장소 deploy/에 둔다. 워크플로가 이 파일을 S3 배포 버킷으로 올리고 서버가 받아 실행한다(#93).

  • deploy/compose.prod.yaml
    • caddy: 80·443, 인증서 저장 볼륨
    • app: 이미지 ghcr.io/sniptext-developer/backend:${APP_TAG}, 포트는 127.0.0.1:8080만, mem_limit ~1.2GB, JAVA_TOOL_OPTIONS=-XX:MaxRAMPercentage=75, 재시작 정책, 로그 크기 제한
    • app의 stop_grace_period를 스프링 종료 대기 시간(spring.lifecycle.timeout-per-shutdown-phase, 기본 30초)보다 길게 (예: 40초). compose 기본값 10초면 교체 때 진행 중인 AI 톤 교정(최대 20초)이 강제 종료되고 사용량 반환도 실행되지 않는다
  • deploy/Caddyfile: api.sniptext.kr(환경 변수) → app:8080, 자동 인증서
  • deploy/deploy.sh <태그>
    • /sniptext/prod/* 파라미터 → /opt/sniptext/.env(권한 600). CHANGE_ME가 남아 있으면 중단. DB_MASTER_PASSWORD는 옮기지 않음
    • 현재 태그를 previous_tag로 기록 → pull → up -d app
    • 127.0.0.1:8080/actuator/health를 최대 180초 확인
    • 실패하면 previous_tag로 다시 띄우고 실패 코드로 끝냄
    • 비밀값·토큰을 출력하지 않음 (set -x 금지)
  • application.yml에 server.forward-headers-strategy 추가 (Caddy 뒤에서 https 판단, 이후 Secure 쿠키에 필요)
  • 스크립트 정적 검사(shellcheck)

출처 허용·쿠키 (코드가 아직 없음)

  • 출처 허용(CORS)·재발급 토큰 쿠키 코드는 아직 없다. global 수정이라 이 이슈에서 만들지 않는다
  • 해당 코드가 들어올 때 프로필별 설정값으로 받게 한다 (설계 문서 4-10 표): dev = https://sniptext.kr + http://localhost:5173, SameSite=None; prod = https://sniptext.kr, SameSite=Lax
  • 그때 새 환경 변수가 생기면 #91의 파라미터에 추가한다

완료 조건

  • 서버에서 손으로 deploy.sh <태그> 실행 → https://api.sniptext.kr/actuator/health UP, 인증서 정상
  • 일부러 뜨지 않는 태그로 실행하면 이전 태그로 돌아가고 실패 코드로 끝남
  • .env가 600, DB_MASTER_PASSWORD 없음, 명령 출력에 비밀값 없음
  • 앱이 sniptext_app 계정으로 접속
  • 교체할 때 이전 컨테이너가 강제 종료(종료 코드 137)되지 않고 정상 종료됨
  • ./gradlew build 통과

선행 이슈

#88, #91

손으로 할 일

없음 (#91의 비밀값 입력이 끝나 있어야 함)

참고

이유

배포 워크플로는 서버에서 "태그 하나 받아 교체하고 확인, 실패하면 되돌림"만 부르면 되게 한다. 설정을 user_data에 넣으면 바꿀 때마다 인스턴스를 교체해야 해서 저장소 파일로 관리한다.

Activity

  1. added
    chore설정·빌드·의존성
    infraAWS, 테라폼, 배포, CI
    on Nov 11, 2026
  2. changed the title [-][chore] ?쒕쾭 ?ㅽ뻾 援ъ꽦: compose ?댁쁺 ?뚯씪쨌Caddy쨌諛고룷 ?ㅽ겕由쏀듃(?곹깭 ?뺤씤쨌?섎룎由ш린)[/-] [+][chore] 서버 실행 구성: compose 운영 파일·Caddy·배포 스크립트(상태 확인·되돌리기)[/+] on Nov 11, 2026
  3. self-assigned this
    on Nov 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

Labels

chore설정·빌드·의존성infraAWS, 테라폼, 배포, CI

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions