Skip to content

Release Management

wcorn edited this page Apr 5, 2026 · 1 revision

릴리즈·버전 관리

orino의 배포 단위·버전 관리·변경 이력 정책.

1. 배포 단위

단일 배포 단위 = orino 플랫폼 전체. 모듈(Auth/Planner/Tools)별로 별도 버저닝하지 않는다.

구분 배포 방식 빈도
BE (orino-app-api) 이미지 빌드 → GHCR → ArgoCD Image Updater 머지 시마다
FE 이미지 빌드 → GHCR → ArgoCD Image Updater 머지 시마다
Infra GitOps (ArgoCD Application) manifest 변경 시마다

2. 버전 정책

2.1 내부 버전 (이미지 digest)

  • BE/FE 이미지: GHCR에 커밋 SHA 기반 태그 + digest로 식별
  • ArgoCD Image Updater: digest 변경 감지 → Git 커밋 → ArgoCD 동기화
  • 태그만이 아닌 digest 기반 업데이트로 동일 태그의 이미지 변경도 감지
ghcr.io/wcorn/orino-be@sha256:abc123...

2.2 외부 버전 (Phase 기반)

Phase를 공식 릴리즈 이정표로 사용.

형식 예시 의미
{module}-phase{n} planner-phase1, planner-phase2 모듈별 Phase 완료
auth-v1 - 모듈 전체 완료
  • GitHub Release로 Phase 완료 시점 기록
  • Semantic Versioning 미사용: 단일 사용자 서비스라 API 호환성 관리 불필요

3. CHANGELOG

3.1 관리 방식

GitHub Release를 CHANGELOG로 사용. 별도 CHANGELOG.md 파일 없음.

이유:

  • PR·이슈와 자동 연결 (Release notes auto-generation)
  • 단일 사용자라 외부 공지 불필요
  • 파일 유지보수 부담 제거

3.2 Release 작성 시점

  • Phase 완료 시: 예) Planner Phase 1 완료 → planner-phase1 태그·Release 생성
  • 주요 인프라 변경 시: 예) LGTM 스택 도입 → infra-lgtm-v1 태그

일상 머지는 별도 Release 없이 커밋 로그로 충분.

3.3 Release 포맷

## 주요 변경사항
- 자동 스케줄링 엔진 구현 (#145, #146)
- 일간 캘린더 뷰 (#158)
- 목표·카테고리 CRUD (#148~#151)

## 관련 이슈
GitHub가 자동 생성한 목록

## 마이그레이션
- DB changeSet 001~014 적용 필요
- 신규 환경 변수: MYSQL_HOST, MYSQL_USERNAME, MYSQL_PASSWORD

## 알려진 문제
- (선택)

4. 배포 프로세스

4.1 일상 배포 (머지 → 자동 배포)

feature branch
  │  PR 생성
  ▼
GitHub PR (CI: 빌드/테스트/린트)
  │  머지
  ▼
main 브랜치
  │  be-cd.yml / fe-cd.yml 트리거
  ▼
GHCR 이미지 빌드·푸시
  │
  ▼
ArgoCD Image Updater (digest 감지)
  │  Git 커밋 (infra/argocd/applications/ 업데이트)
  ▼
ArgoCD Application 동기화
  │
  ▼
Kubernetes Pod rolling update

전 과정 자동화. 수동 개입 없음.

4.2 인프라 배포

infra/ 변경 → PR → 머지 → ArgoCD 감지 → 동기화

Helm values·manifest 변경은 ArgoCD가 자동 감지. helm install/kubectl apply 직접 실행 금지.

4.3 긴급 롤백

이미지 롤백 (BE/FE)

1. 이전 정상 이미지 digest 확인 (GitHub Actions 로그 또는 GHCR)
2. infra/argocd/applications/ 해당 파일에서 digest 수동 교체 → 커밋·푸시
3. ArgoCD 동기화 대기 (약 1분)

인프라 롤백

1. git revert <commit> → 커밋·푸시
2. ArgoCD 자동 동기화

DB 롤백: DB-Migration §6 참조. 일반적으로 forward fix 권장.

5. Phase 완료 체크리스트

각 모듈 Phase 완료 시 수행할 작업.

  • 해당 Phase의 모든 Issue 클로즈 확인
  • 로컬·prod 양쪽에서 end-to-end 동작 검증
  • 관련 Wiki 문서 업데이트 (기획 변경 사항 반영)
  • Grafana 대시보드·알림 규칙 보강 (해당 기능 관찰성)
  • GitHub Release 생성 ({module}-phase{n} 태그)
  • Release notes 작성

6. 브랜치·커밋 규칙

CLAUDE.md와 .gitmessage.txt 참조.

구분 규칙
브랜치 이름 feat/…, fix/…, chore/…, docs/…
base 브랜치 항상 main
커밋 메시지 <타입> : <제목> (50자 이내)
타입 feat / fix / docs / test / refactor / style / chore
PR 템플릿 .github/PULL_REQUEST_TEMPLATE.md
이슈 연결 closes #이슈번호

7. 관련 문서

Clone this wiki locally