2.4 KiB
2.4 KiB
| name | description |
|---|---|
| release | VideoDownloader 배포 절차. Windows 설치자(x64/arm64) 생성과 macOS/Linux 원격 빌드머신 빌드를 수행한다. "배포", "설치자 만들어", "릴리스", "publish" 요청에 사용. |
배포
배포는 되돌리기 어렵다. 각 단계 전에 사용자 확인을 받는다. 요청받지 않은 배포를 임의로 하지 않는다.
0. 사전 점검 (필수)
dotnet test VideoDownloader.Tests
git status --short
- 테스트 실패가 있으면 배포하지 않는다.
- 커밋되지 않은 변경이 있으면 사용자에게 알린다. 원격 빌드는
git archive HEAD로 소스를 보내므로 커밋되지 않은 변경은 원격 빌드에 반영되지 않는다.
1. Windows 설치자
./build/publish.ps1 -Config Release -Version <버전>
- 하는 일:
VideoDownloader.App을win-x64/win-arm64self-contained 로 publish (publish/<arch>/) → Inno Setup 으로 설치자 컴파일 →out/MediaBrowser-Setup-<arch>.exe - 필요: Inno Setup 6 (
winget install --id JRSoftware.InnoSetup -e). 없으면 스크립트가 명시적으로 throw 한다. - 특정 아키텍처만:
-Archs x64 - arm64 첫 빌드는 yt-dlp/WebView2 런타임 관련으로 실패할 수 있다. 실패 메시지를 그대로 사용자에게 전달한다.
- 완료 시 스크립트가 산출물 크기를 출력한다. 그 출력을 인용해 보고한다.
2. macOS / Linux 원격 빌드
bash build/remote/build-remote.sh all # 또는 linux | mac
- 하는 일:
git archive HEAD로 현재 커밋 소스를 빌드머신에 SSH 전송 →Cli+Avalonia를 RID별 self-contained publish →out/remote/<rid>/artifacts-<rid>.tar.gz수집 - 자격 증명은
.env의MAC_OS_HOST/LINUX_OS_HOST등을 쓴다..env내용을 읽어서 출력하거나 로그에 남기지 않는다. - 빌드머신이 절전이면 SSH 가 끊긴다. 재연결 후 재시도한다.
- Avalonia 12.1 은 빌드머신에 .NET 10 SDK 가 있어야 한다. 8만 있으면 CS0103 으로 실패한다.
3. 배포 후
- 산출물 경로와 크기를 보고한다.
out/,publish/는 gitignore 대상이다. 커밋하지 않는다.- 릴리스 배포처(GitHub Releases 등)에 올리는 것은 별도 승인 사항이다. 임의로 업로드하지 않는다.
- 배포 체계 전반은
docs/DEPLOYMENT_PLAN.md참고.