05. 릴리즈 엔지니어링 & 배포 체계 (Release & Deployment to git.chanpaca.net)

이 문서는 Everything2Everything의 무결점 배포를 위한 릴리즈 엔지니어링, 시맨틱 버전 태깅, 그리고 Forgejo(git.chanpaca.net) 배포 파이프라인 규약을 정의한다.

1. 배포 인프라 및 아키텍처 개요

1.1 대상 저장소 (Target Remote)

플랫폼: Forgejo (자체 호스팅 Git 서버)
도메인: https://git.chanpaca.net
원격 저장소 경로: https://git.chanpaca.net/yunchan/Everything2Everything.git
SSH 경로: ssh://git@git.chanpaca.net:2222/yunchan/Everything2Everything.git
인증 방식: Windows Credential Manager에 등록된 yunchan 계정 자격증명 및 API 토큰.

1.2 배포 산출물 (Dual Binary Deliverables)

Portable EXE (publish/Everything2Everything.exe):
- .NET 9 프레임워크 의존형 x64 단일 실행 파일.
- 우클릭 컨텍스트 메뉴 자체 등록/해제 (.\Everything2Everything.exe register) 지원.
- 무설치 초경량 배포용.
MSIX 패키지 (packaging/dist/Everything2Everything-x64.msix):
- Windows 11 Fluent 2 메인 메뉴(Shift 없이 바로 노출) 지원용 IExplorerCommand DLL 동봉 패키지.
- 개발자 인증서 서명 패키지.

2. 릴리즈 게이트 (Release Gates)

배포 스크립트 실행 시 다음 4단계 게이트를 하나라도 통과하지 못하면 릴리즈는 즉각 중단(Aborted)된다:

[ Gate 1: Test Suite 100% Pass ]
   │  dotnet test Everything2Everything.Tests.csproj (실패 0개, 경고 0개)
   ▼
[ Gate 2: Version Synchronization ]
   │  Package.appxmanifest, App.csproj, Git Tag 버전 일치 확인 (예: 1.0.6.0 <-> v1.0.6)
   ▼
[ Gate 3: Release Build & Artifacts ]
   │  dotnet publish (Release win-x64) + BuildMsix.ps1 산출물 생성 확인
   ▼
[ Gate 4: Git Tag & Forgejo Release ]
   │  git tag 생성 -> git.chanpaca.net 푸시 -> Forgejo API 릴리즈 등록 및 바이너리 첨부

3. 시맨틱 버저닝 (Semantic Versioning 2.0.0)

모든 릴리즈 태그는 vMAJOR.MINOR.PATCH 형식을 엄격히 준수한다:

MAJOR: 아키텍처 전면 개편 또는 호환되지 않는 CLI/매트릭스 변경.
MINOR: 신규 변환 프로바이더 추가, 새로운 GUI 기능 추가.
PATCH: 버그 수정, 디자인/정렬 결함 패치, 성능 최적화.

버전 동기화 대상 파일

packaging/Package.appxmanifest: <Identity Version="1.0.6.0" ... />
src/Everything2Everything.App/Everything2Everything.App.csproj: <Version>1.0.6</Version>
docs/ssot/_data/meta.json 또는 릴리즈 노트

4. 자동화 배포 스크립트 (`tools/Publish-Release.ps1`)

릴리즈 엔지니어링은 단 1줄의 PowerShell 스크립트로 전자동 수행된다:

# 사용법 예시: 버전 1.0.6 릴리즈 배포
pwsh tools/Publish-Release.ps1 -Version "1.0.6" -ReleaseNotes "디자인 감사 TDD 적용 및 UI 수직 정렬/패딩 결함 수정"

스크립트의 동작 절차:

git status 작업 디렉터리 청결 상태 확인.
dotnet test 전체 테스트 스위트 실행.
버전 번호 자동 동기화 (1.0.6.0 / 1.0.6).
Portable EXE 빌드 및 MSIX 패키징.
로컬 커밋 및 Git 태그 v1.0.6 생성.
origin(GitHub) 및 forgejo(https://git.chanpaca.net/yunchan/Everything2Everything.git) 양방향 푸시.
Forgejo REST API를 호출하여 태그 기반 정식 릴리즈 생성 및 바이너리 업로드.

5. Forgejo Actions 워크플로 (`.forgejo/workflows/release.yaml`)

원격 서버 자체 CI/CD를 위한 워크플로를 구성하여, 태그 푸시(v*) 시 원격 러너에서도 자동으로 빌드와 검증이 수행되도록 보장한다.

3.8 KiB Raw Blame History