Repository navigation
Release Management
wcorn edited this page Apr 5, 2026
·
1 revision
orino의 배포 단위·버전 관리·변경 이력 정책.
단일 배포 단위 = orino 플랫폼 전체. 모듈(Auth/Planner/Tools)별로 별도 버저닝하지 않는다.
| 구분 | 배포 방식 | 빈도 |
|---|---|---|
| BE (orino-app-api) | 이미지 빌드 → GHCR → ArgoCD Image Updater | 머지 시마다 |
| FE | 이미지 빌드 → GHCR → ArgoCD Image Updater | 머지 시마다 |
| Infra | GitOps (ArgoCD Application) | manifest 변경 시마다 |
- BE/FE 이미지: GHCR에 커밋 SHA 기반 태그 + digest로 식별
- ArgoCD Image Updater: digest 변경 감지 → Git 커밋 → ArgoCD 동기화
- 태그만이 아닌 digest 기반 업데이트로 동일 태그의 이미지 변경도 감지
ghcr.io/wcorn/orino-be@sha256:abc123...
Phase를 공식 릴리즈 이정표로 사용.
| 형식 | 예시 | 의미 |
|---|---|---|
{module}-phase{n} |
planner-phase1, planner-phase2
|
모듈별 Phase 완료 |
auth-v1 |
- | 모듈 전체 완료 |
- GitHub Release로 Phase 완료 시점 기록
- Semantic Versioning 미사용: 단일 사용자 서비스라 API 호환성 관리 불필요
GitHub Release를 CHANGELOG로 사용. 별도 CHANGELOG.md 파일 없음.
이유:
- PR·이슈와 자동 연결 (Release notes auto-generation)
- 단일 사용자라 외부 공지 불필요
- 파일 유지보수 부담 제거
-
Phase 완료 시: 예) Planner Phase 1 완료 →
planner-phase1태그·Release 생성 -
주요 인프라 변경 시: 예) LGTM 스택 도입 →
infra-lgtm-v1태그
일상 머지는 별도 Release 없이 커밋 로그로 충분.
## 주요 변경사항
- 자동 스케줄링 엔진 구현 (#145, #146)
- 일간 캘린더 뷰 (#158)
- 목표·카테고리 CRUD (#148~#151)
## 관련 이슈
GitHub가 자동 생성한 목록
## 마이그레이션
- DB changeSet 001~014 적용 필요
- 신규 환경 변수: MYSQL_HOST, MYSQL_USERNAME, MYSQL_PASSWORD
## 알려진 문제
- (선택)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
전 과정 자동화. 수동 개입 없음.
infra/ 변경 → PR → 머지 → ArgoCD 감지 → 동기화
Helm values·manifest 변경은 ArgoCD가 자동 감지. helm install/kubectl apply 직접 실행 금지.
이미지 롤백 (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 권장.
각 모듈 Phase 완료 시 수행할 작업.
- 해당 Phase의 모든 Issue 클로즈 확인
- 로컬·prod 양쪽에서 end-to-end 동작 검증
- 관련 Wiki 문서 업데이트 (기획 변경 사항 반영)
- Grafana 대시보드·알림 규칙 보강 (해당 기능 관찰성)
- GitHub Release 생성 (
{module}-phase{n}태그) - Release notes 작성
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 #이슈번호 |
- 인프라 아키텍처 §6 CI/CD
- CI/CD 파이프라인
- DB 마이그레이션
- 백업·복구 전략