feat(release): one-command desktop release with Ed25519-signed update metadata
The installer is unsigned, so latest.yml is now signed with an Ed25519 key and the app verifies the downloaded installer against it before installing. npm run release -- patch|minor bumps, gates, tags, builds, signs, publishes, re-verifies the public feed and pushes; --resume continues after a failure. The retired GitLab registry publisher is removed.
This commit is contained in:
parent
f5ae4c8c04
commit
fd9c97b7cc
21 changed files with 986 additions and 144 deletions
|
|
@ -1,6 +1,6 @@
|
|||
# D3RO Voice 릴리스 가이드
|
||||
|
||||
기준일: 2026-09-18. 이 문서는 desktop GitLab 패키지·자동 업데이트와 mobile store release의 경계를 분리한다. 태그 생성이나 HTTP 200 하나만으로 배포 완료를 선언하지 않는다.
|
||||
기준일: 2026-10-17. 이 문서는 desktop 자동 업데이트(Forgejo feed)와 mobile store release의 경계를 분리한다. 태그 생성이나 HTTP 200 하나만으로 배포 완료를 선언하지 않는다.
|
||||
|
||||
## 현재 release identity
|
||||
|
||||
|
|
@ -12,38 +12,62 @@
|
|||
| Android upload key | alias `d3ro-upload-20260821`, cert SHA-256 `4F:AC:69:24:...:15:2B:54` | external PKCS12·user-only ACL·Credential Manager·private-key readback GREEN; CI secret·복구 백업·AAB signer 대조 대기 |
|
||||
| release evidence | Ed25519 public `release/mobile-release-evidence-public.pem`, keyId `2797d3e6...4a890b7f` | external private key ACL·roundtrip GREEN; CI private-key secret·복구 백업 대기 |
|
||||
| desktop offline license | Ed25519 public `apps/desktop/resources/license/production-public.pem`, keyId `5c52b765...81a887f` | 새 전용 keypair·external private ACL·roundtrip·desktop production build GREEN; admin `ADMIN_LICENSE_PRIVATE_KEY` secret 주입 대기 |
|
||||
| Windows Authenticode | external public-trust code-signing certificate | production PFX 없음. Forgejo 저장소 시크릿 4종(`WIN_CSC_LINK`/`WIN_CSC_KEY_PASSWORD`/`WIN_CSC_EXPECTED_SIGNER_SUBJECT`/`FORGEJO_TOKEN`)이 0건이라 릴리스 파이프라인이 fail-closed. `scripts/ci/set-forgejo-secrets.mjs --check`로 확인한다. GREEN 전까지 게시 금지 |
|
||||
| Windows Authenticode | external public-trust code-signing certificate | production PFX 없음(한국 개인은 Azure Artifact Signing 불가, 사업자면 가능). 2026-10-17부터 **선택 사항** — 없으면 무서명 설치본 + Ed25519 서명 `latest.yml` 로 게시하고 앱이 검증한다 |
|
||||
| 업데이트 서명 키 | Ed25519 public `release/desktop-update-public.pem` (== `apps/desktop/src/main/update-signature.ts`), private = `.env` `D3RO_UPDATE_SIGNING_KEY` | 2026-10-17 생성. **교체·분실 금지** — 이 공개키를 내장한 설치본은 다른 키로 서명된 릴리스를 거부한다. `.env` 백업 필수 |
|
||||
| Firebase | Console `u/0`, `u/1` 모두 D3RO project 없음 | 사용자 승인 후 project·Android app 생성 필요 |
|
||||
| AdMob | app `ca-app-pub-1039714767792854~6427959892`; banner `/9840591290`; rewarded `/2255790918` | SSOT 확정. `검토 필요`·`광고 게재 제한`·store 미연결·결제 프로필 미완료 |
|
||||
| updater feed (canonical) | `https://git.chanpaca.net/api/packages/yunchan/generic/d3ro-voice/latest` | Forgejo Generic Registry. GitLab project 1172은 legacy mirror |
|
||||
| updater feed (canonical) | `https://git.chanpaca.net/api/packages/yunchan/generic/d3ro-voice/latest` | Forgejo Generic Registry. GitLab 미러는 2026-10-17 폐기 |
|
||||
| release notes | `CHANGELOG.md` `## [1.5.0]` + Play changelog `1050000.txt` (ko/en) | 태그 전 확정·검증 필수 |
|
||||
| 직전 게시본 | Forgejo Generic Registry `1.6.0` (2026-09-24 게시, unsigned installer + runtime/portable) | `v1.2.0`·`v1.3.0` 파이프라인은 서명/사이드카 선행 조건에서 실패했고 `v1.4.0`은 게시되지 않았다. `1.3.2`·`1.3.7`·`1.5.0`·`1.6.0`은 무서명 로컬 게시 경로(GAP-REL-06)를 사용했다 |
|
||||
|
||||
live canonical feed(`git.chanpaca.net/.../d3ro-voice/latest`)의 `latest.yml`은 현재 `1.6.0`을 보고한다(2026-09-24 무서명 로컬 게시). `runtime-latest/runtime.json`과 `portable-latest/portable.json`도 `1.6.0`이다. 서명 인증서를 확보하면 이보다 높은 버전을 서명 게시해 대체한다.
|
||||
|
||||
## desktop 릴리스 파이프라인
|
||||
## desktop 릴리스 = 한 줄 명령 (2026-10-17~)
|
||||
|
||||
```text
|
||||
authoritative release commit
|
||||
→ version/check/test/build GREEN
|
||||
→ annotated tag v1.3.0
|
||||
→ package-windows (build-win-x64)
|
||||
→ package-macos (build-mac-arm64)
|
||||
→ publish-release (build-linux-x64)
|
||||
├─ publish-forgejo-release.mjs ← canonical
|
||||
│ ├─ Forgejo Generic Registry /d3ro-voice/1.3.0/ (버전별 보존)
|
||||
│ ├─ Forgejo Generic Registry /d3ro-voice/latest/ (updater feed + update-policy.json)
|
||||
│ └─ Forgejo Release + CHANGELOG notes + 자산 첨부
|
||||
└─ publish-gitlab-release.mjs ← legacy mirror (pre-Forgejo 설치본)
|
||||
├─ GitLab Generic Registry /d3ro-voice/1.3.0/
|
||||
├─ GitLab Generic Registry /d3ro-voice/latest/
|
||||
└─ GitLab Release
|
||||
```bash
|
||||
npm run release -- patch # fix 1.9.0 → 1.9.1
|
||||
npm run release -- minor # feat 1.9.0 → 1.10.0
|
||||
npm run release -- minor --dry-run # 할 일만 출력
|
||||
npm run release -- --resume # 빌드·게시·푸시 중 실패 후 이어 가기
|
||||
```
|
||||
|
||||
- Forgejo·GitHub Actions도 동일한 `publish-forgejo-release.mjs`로 수렴한다. 어느
|
||||
빌더가 성공해도 canonical feed는 하나다.
|
||||
- `publish-forgejo-release.mjs`는 설치 자산을 먼저, `latest.yml`을 마지막에
|
||||
게시하고, 공개 URL에서 재검증한 뒤 Release 자산을 첨부한다.
|
||||
전제: `main`, 깨끗한 작업 트리, 루트 `.env` 의 `FORGEJO_TOKEN` · `D3RO_UPDATE_SIGNING_KEY`.
|
||||
사용자에게 보일 변경점은 미리 `CHANGELOG.md` `## [x.y.z] - 날짜` 로 써 두는 게 좋다(없으면
|
||||
커밋 제목으로 초안을 만든다). 모바일 Play '새 기능' 문구 파일이 없으면 일반 문구로 채운다.
|
||||
|
||||
```text
|
||||
scripts/ci/release-desktop.mjs
|
||||
1. 점검 main · 깨끗한 트리 · 토큰 · 서명 키가 저장소 공개키와 짝 · 태그/피드 미사용
|
||||
2. 버전 product-version.json + sync-version --write + CHANGELOG + Play 문구
|
||||
3. 게이트 version:check · release:metadata · typecheck
|
||||
4. 커밋 chore(release): vX.Y.Z + annotated 태그 (로컬)
|
||||
5. 빌드 build-desktop-installer.mjs (electron-vite → unpacked → ABI 보정·검증 → app-update.yml → NSIS, 100MiB 한도)
|
||||
6. 게시 publish-forgejo-release.mjs
|
||||
├─ latest.yml → latest.yml.sig (Ed25519)
|
||||
├─ /d3ro-voice/<version>/ 불변, 다른 바이트면 중단
|
||||
├─ /d3ro-voice/latest/ 설치 자산 먼저, 메타데이터·정책 마지막
|
||||
├─ 공개 URL 의 <version>/latest.yml + .sig 를 다시 받아 서명·설치본 sha512 검증
|
||||
└─ Forgejo Release + CHANGELOG 노트
|
||||
7. 푸시 chanpaca main + 태그 (origin 미러는 실패해도 경고)
|
||||
```
|
||||
|
||||
- CI(`.forgejo/workflows/release.yml`)는 같은 빌드·게시 스크립트를 쓰는 **예비 경로**다. 태그가
|
||||
푸시되면 돌지만 피드에 이미 그 버전이 있으면(보통) 건너뛴다. 시크릿: `FORGEJO_TOKEN`,
|
||||
`D3RO_UPDATE_SIGNING_KEY`(필수), `WIN_CSC_*`(선택) — `npm run release:secrets` 로 `.env` 에서 동기화.
|
||||
- 런타임(사이드카/ffmpeg)을 바꿨으면 먼저 `npm run release:portable:build` → `npm run release:portable`.
|
||||
게시 스크립트는 `runtime-latest` 가 이 빌드의 최소 런타임을 만족하지 않으면 아무것도 올리지 않는다.
|
||||
|
||||
### 앱 쪽 검증 (무서명 설치본 보호)
|
||||
|
||||
electron-updater 는 Authenticode 서명이 없으면 자체 검증을 건너뛴다. 그래서
|
||||
`update-adapters.ts` 가 NsisUpdater 의 `verifySignature` 단계를 `verifyDownloadedUpdate`
|
||||
(`update-signature.ts`)로 바꿔 끼운다: 불변 경로 `<version>/latest.yml` + `.sig` 를 받아 내장
|
||||
공개키로 서명을 확인하고, 그 version·sha512 가 받은 설치 파일과 같아야 설치한다. 하나라도
|
||||
어긋나면 electron-updater 가 파일을 지우고 `ERR_UPDATER_INVALID_SIGNATURE` 로 실패한다.
|
||||
1.9.0 이하 설치본은 이 검증이 없지만 새 릴리스를 그대로 받는다(서명 파일이 추가될 뿐).
|
||||
|
||||
### 공통 규칙
|
||||
|
||||
- 설치 바이너리는 저장소에 커밋하지 않는다. 배포 정본은 Forgejo feed이며,
|
||||
`site/public/releases/*/`, `apps/web/public/releases/*/`는 `.gitignore`로
|
||||
막혀 있어 build graph 밖이고 배포 산출물에 포함되지 않는다(추적 상태로 남아
|
||||
|
|
@ -55,7 +79,7 @@ authoritative release commit
|
|||
- `scripts/ci/sync-version.mjs --check --tag v1.3.0`는 태그, `release/product-version.json`, package/lockfile, Android/iOS 버전 면의 일치를 fail-closed로 검증한다.
|
||||
- `scripts/ci/verify-release-metadata.mjs`는 배포 메타데이터와 CI/publisher 계약을 검증한다.
|
||||
- 같은 gate는 desktop license public key가 Ed25519이고 `release/product-version.json`의 `desktopLicensePublicKeyId`와 일치하는지 검증한다. `electron.vite.config.ts`는 이 파일을 직접 읽으므로 누락·손상된 키로는 build가 시작되지 않는다.
|
||||
- `scripts/ci/publish-forgejo-release.mjs`는 canonical이다. 버전별 패키지를 먼저 올리고, `latest`에서 설치 자산 참조를 검증한 뒤 `latest.yml`과 `update-policy.json`을 마지막에 게시하고 공개 URL에서 재검증한다. `scripts/ci/publish-gitlab-release.mjs`는 legacy mirror로 동일 자산을 GitLab에도 올린다.
|
||||
- `scripts/ci/publish-forgejo-release.mjs`가 유일한 게시 경로다. 버전별 패키지를 먼저 올리고, `latest`에서 설치 자산 참조를 검증한 뒤 `latest.yml`(+`.sig`)과 `update-policy.json`을 마지막에 게시하고 공개 URL에서 서명까지 재검증한다.
|
||||
- Windows installer와 `latest.yml`은 필수다. macOS 산출물이 없는 Windows-only release를 의도했다면 그 판단을 release record에 남긴다.
|
||||
- `package-windows`는 external public-trust code-signing PFX를 protected file variable `WIN_CSC_PFX_FILE`로, 암호와 exact certificate subject를 protected `WIN_CSC_KEY_PASSWORD`, `WIN_CSC_EXPECTED_SIGNER_SUBJECT`로 받아야 한다. GitHub Release도 `WIN_CSC_LINK`, `WIN_CSC_KEY_PASSWORD`, `WIN_CSC_EXPECTED_SIGNER_SUBJECT`가 모두 없으면 실패한다.
|
||||
- `scripts/ci/verify-windows-release-artifact.ps1`는 installer와 unpacked app의 Authenticode `Valid`, exact signer subject, non-self-signed code-signing EKU, PE version, `latest.yml` path/size/SHA-512를 검증한다. 로컬 self-signed `Everything2EverythingDev`는 production 신뢰 인증서가 아니며 gate에서 명시적으로 거부한다.
|
||||
|
|
@ -174,21 +198,11 @@ node --env-file-if-exists=.env scripts/ci/set-forgejo-secrets.mjs --write
|
|||
10. Forgejo Release note/asset, `latest.yml`, `update-policy.json`, installer hash를 외부 public URL에서 다시 검증한다.
|
||||
11. 이전 설치본에서 자동 업데이트 E2E를 실행하고 실행 중 버전·프로세스·사용자 데이터 보존, 그리고 **업데이트 후 로컬 받아쓰기 1회 성공**을 확인한다.
|
||||
|
||||
## 자동 업데이트 게시 (런타임 분리 전제)
|
||||
## 설치본 크기와 네이티브 ABI
|
||||
|
||||
설치본은 **90MiB대**를 유지해야 한다. 로컬 AI 런타임(사이드카 엔진/ffmpeg)을 설치본에 넣으면
|
||||
Cloudflare 업로드 한도(100MiB)를 넘어 `latest.yml`을 게시할 수 없다.
|
||||
Cloudflare 업로드 한도(100MiB)를 넘어 게시할 수 없다 — `build-desktop-installer.mjs` 가 넘으면 실패한다.
|
||||
|
||||
```bash
|
||||
npm run build --workspace=@d3ro/desktop # 렌더러/메인 번들
|
||||
npm run release:portable:build # 런타임 번들 생성(엔진/ffmpeg)
|
||||
npm run release:portable # portable + runtime 채널 게시
|
||||
npm run release:updater:check # 업데이터 게시 예정 확인
|
||||
npm run release:updater -- --ack-unsigned # (인증서 없을 때만) 무서명 게시
|
||||
```
|
||||
|
||||
- 서명 인증서가 있으면 `--ack-unsigned` 없이 게시한다(권장). 무서명 게시는 명시적 예외이며
|
||||
스크립트가 플래그 없이는 즉시 실패한다(GAP-REL-06에 기록).
|
||||
- **네이티브 ABI 게이트 필수**: 패키징 후 `node scripts/ci/verify-native-abi.mjs`로 확인한다.
|
||||
개발 PC에서 `npm install`을 돌리면 `better-sqlite3`가 Node ABI로 재빌드되어 설치본이
|
||||
시작조차 못 한다(실측: 1.3.2). 로컬에서 실행 중인 Electron이 모듈을 잠그면
|
||||
|
|
@ -262,8 +276,10 @@ Desktop release를 게시해도 Android production 출시가 자동으로 완료
|
|||
- `scripts/ci/create-release-tag.mjs` — 릴리스 태그 게이트 (annotated/서명, 불변)
|
||||
- `scripts/ci/verify-release-metadata.mjs` — release metadata 자가 검증
|
||||
- `scripts/ci/verify-windows-release-artifact.ps1` — Windows version·updater metadata·Authenticode gate
|
||||
- `scripts/ci/publish-gitlab-release.mjs` — legacy GitLab registry·Release mirror publisher
|
||||
- `apps/desktop/src/main/update-feed.ts` — runtime updater URL SSOT (canonical Forgejo + legacy mirror 상수)
|
||||
- `scripts/ci/release-desktop.mjs` — 한 줄 릴리스 명령 (`npm run release`)
|
||||
- `scripts/ci/build-desktop-installer.mjs` — 설치본 빌드 (로컬·CI 공용)
|
||||
- `scripts/ci/lib/update-manifest-signature.mjs` · `apps/desktop/src/main/update-signature.ts` — latest.yml Ed25519 서명·검증
|
||||
- `apps/desktop/src/main/update-feed.ts` — runtime updater URL SSOT
|
||||
- `release/update-policy.json` — 채널·최소 지원 버전·강제 업데이트·full/delta·staged rollout·킬 스위치 SSOT
|
||||
- `apps/desktop/src/main/update-policy.ts` — 정책 파싱·결정 순수 로직
|
||||
- `scripts/ci/publish-forgejo-release.mjs` — canonical Forgejo registry·Release·feed publisher
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue