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.
27 KiB
D3RO Voice 릴리스 가이드
기준일: 2026-10-17. 이 문서는 desktop 자동 업데이트(Forgejo feed)와 mobile store release의 경계를 분리한다. 태그 생성이나 HTTP 200 하나만으로 배포 완료를 선언하지 않는다.
현재 release identity
| 항목 | 정본 | 현재 판정 |
|---|---|---|
| 제품 버전 | release/product-version.json: 1.6.0 |
source SSOT 확정 |
| Android | versionCode 1030001 |
production AAB 미생성 |
| iOS | build 1030001 |
production archive 미검증 |
| 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 없음(한국 개인은 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 미러는 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 릴리스 = 한 줄 명령 (2026-10-17~)
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 # 빌드·게시·푸시 중 실패 후 이어 가기
전제: main, 깨끗한 작업 트리, 루트 .env 의 FORGEJO_TOKEN · D3RO_UPDATE_SIGNING_KEY.
사용자에게 보일 변경점은 미리 CHANGELOG.md ## [x.y.z] - 날짜 로 써 두는 게 좋다(없으면
커밋 제목으로 초안을 만든다). 모바일 Play '새 기능' 문구 파일이 없으면 일반 문구로 채운다.
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 밖이고 배포 산출물에 포함되지 않는다(추적 상태로 남아 있던 19개 설치본 ~568MiB는 2026-09-26 Wave 3,cd9d199에서 삭제됐고 그 뒤로는 추적 자산이 없다).apps/api-server/wwwroot/는 정적 파일 서빙 자체와 함께 통째로 삭제됐다(같은 커밋) — API는 더 이상 다운로드/릴리스 자산을 서빙하지 않는다. 사이트·웹 다운로드 센터는 로컬 경로가 아니라 feed URL을 링크한다. -
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가 유일한 게시 경로다. 버전별 패키지를 먼저 올리고,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 variableWIN_CSC_PFX_FILE로, 암호와 exact certificate subject를 protectedWIN_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의 AuthenticodeValid, exact signer subject, non-self-signed code-signing EKU, PE version,latest.ymlpath/size/SHA-512를 검증한다. 로컬 self-signedEverything2EverythingDev는 production 신뢰 인증서가 아니며 gate에서 명시적으로 거부한다. -
현재 GitLab Linux runner는 Shell executor이므로 job의
image:를 툴체인 근거로 간주하지 않는다..gitlab-ci.yml은scripts/ci/bootstrap-linux-toolchain.sh를 source해 .NET 10.0.302, Deno 2.8.1, Microsoft OpenJDK 17.0.20.1, Android command-line tools 15859902를 고정 해시로 검증·캐시한 뒤 실행한다.
자동 업데이트 계약
apps/desktop/src/main/update-feed.ts와 apps/desktop/electron-builder.yml은
버전 없는 같은 canonical Forgejo URL을 가리켜야 한다.
https://git.chanpaca.net/api/packages/yunchan/generic/d3ro-voice/latest
legacy mirror(제거 예정, 런타임 참조 금지):
https://gitlab.twentyoz.kr:8443/api/v4/projects/1172/packages/generic/d3ro-voice/latest
아래 면이 하나라도 깨지면 release를 중단한다.
- Forgejo Generic Registry의 무인증 public pull이 허용됐다 (
FORGEJO_TOKEN으로 게시, 익명으로 읽기). latest.yml의version이 태그와 일치한다.latest.ymlURL/path가 같은latest경로의 실제 installer를 참조한다.- installer 파일명에 공백이 없다:
D3RO-Voice-Setup-<version>-x64.exe. - metadata SHA-512와 다운로드한 installer가 일치한다.
- installer와
win-unpacked/D3RO Voice.exe모두 external public-trust certificate의 AuthenticodeValid이고, signer subject가 protected CI identity와 정확히 일치한다. - 이전 실제 설치본이 feed를 탐지하고, 다운로드·재시작·버전 상승을 끝까지 완료한다.
2026-09-16 live canonical latest.yml은 1.1.0을 보고한다(2026-09-15 hand-publish).
그 installer는 Authenticode 서명이 없으므로 정책상 정상 게시본이 아니다. 1.2.0은
서명 gate를 통과한 CI build로 이 값을 대체하는 forward-fix다. legacy GitLab feed는
여전히 0.2.1-alpha다.
업데이트 채널과 메이저/증분 정책
정책 정본은 release/update-policy.json이고, 런타임 로직은
apps/desktop/src/main/update-policy.ts다. publisher가 이 파일을 feed 루트에
게시하면 실행 중 앱이 내려받아 적용한다.
| 필드 | 의미 |
|---|---|
defaultChannel / channels |
latest(stable) · beta · alpha. allowPrerelease가 false면 stable 고객은 prerelease를 받지 않는다 |
minimumSupportedVersion |
이 미만 설치본은 업데이트가 필수(연기·건너뛰기 불가) |
forceInstallBelow |
이 미만은 다이얼로그 없이 즉시 설치. null이면 비활성 |
fullInstallOnMajorChange |
major 승격 시 blockmap 차분 대신 전체 설치자 |
fullInstallVersionGap |
같은 major에서 minor 갭이 이 값 이상이면 전체 설치자 |
stagingPercentage |
stable 업데이트를 노출할 사용자 비율(0~100). 강제 업데이트는 무시 |
killSwitch |
true면 업데이트 확인 자체를 중단 |
- 증분(delta): 기본.
.blockmap으로 변경 블록만 받는다. 첫 업데이트는 항상 full이다. - 전체(full): 현재 버전을 신뢰할 수 없거나, major 승격이거나, minor 갭이 임계 이상일 때
disableDifferentialDownload를 켠다. - 회수(rollback):
stagingPercentage를 낮추거나killSwitch를 켠다. 이미 배포된 버전은 되돌리지 않고 더 높은 patch로 forward-fix한다.
1.6.0 릴리스 기록 (2026-09-24)
1.5.0과 같은 무서명 로컬 게시 경로.
release/product-version.json→1.6.0(android/iOS1060000, 2026-09-24),CHANGELOG.md## [1.6.0], Play 변경 기록1060000.txt(ko-KR/en-US).version:sync→version:checkGREEN.- 게이트 GREEN:
version:check,release:metadata,security:secrets,check:design(0),lint, 전 워크스페이스typecheck, 데스크톱 빌드,check:desktop-renderer(7 pages). 데스크톱 테스트(Node ABI 구성) 1,504 pass / 2 fail — 실패 2건은 환경 의존 기존 항목(RAG 임베딩, 캡션 타임아웃;test_env_traps). 코어 131/131. - 커밋
2fe20fa→npm run release:tag→ annotatedv1.6.0→chanpaca·originmain+tag push. - 런타임/포터블:
sidecar:build(새 PyInstaller 빌드,apps/desktop/sidecar-dist) →release:portable:build→release:portable.runtime-latest/runtime.json·portable-latest/portable.json=1.6.0. - 업데이터:
release:updater -- --build --ack-unsigned.D3RO-Voice-Setup-1.6.0-x64.exe95,628,392 bytes,latest.yml1.6.0, sha512 로컬 일치, 익명 206. - 사이트: 로컬 wrangler 배포,
release-identity.json= commit2fe20fa/ 1.6.0. - 런타임 호환: 앱은 사이드카 최소 버전 1.5.0(
RUNTIME_MIN_VERSION)만 요구한다. 이미 1.5.0 이상 엔진을 가진 설치는 1.6.0 업데이트 때 엔진을 다시 받지 않고, 1.5.0 이전 엔진(마커 없음)만 한 번 다시 받는다. - 로컬 설치 파일 함정:
better-sqlite3가 Node ABI인 상태로 포장하면 설치본이 DB 없이 뜬다. 포장 전에 Electron ABI(130)인지new Database(':memory:')로 확인한다(test_env_traps). - 남은 게이트: 실제 설치본 자동 업데이트 E2E(1.5.0 → 1.6.0), 스트리밍 자막(1.7.0 예정).
1.5.0 릴리스 기록 (2026-09-23)
서명 인증서가 없는 상태라 CI 서명 파이프라인 대신 무서명 로컬 게시로 내보냈다.
release/product-version.json을1.5.0(android/iOS1050000, 2026-09-23)으로 올리고npm run version:sync→npm run version:checkGREEN.CHANGELOG.md## [1.5.0] - 2026-09-23확정.site/src/release.ts와apps/web/src/lib/desktop-release.ts는sync-version이 자동 반영.- 게이트 GREEN:
version:check,release:metadata,security:secrets,check:design,lint,typecheck, 데스크톱 빌드,check:desktop-renderer. - 커밋 후
npm run release:tag→ annotatedv1.5.0→git push chanpaca main+git push chanpaca v1.5.0(legacy mirrororigin에도 함께). - 런타임을 먼저 게시:
npm run sidecar:build(UIA 포함) →npm run release:portable:build→npm run release:portable.runtime-latest/runtime.json과portable-latest/portable.json이1.5.0을 보고하고, 로컬 해시와 원격 sha256이 일치함을 확인했다. - 업데이터 게시:
npm run release:updater -- --build --ack-unsigned. 설치본D3RO-Voice-Setup-1.5.0-x64.exe= 91.2MiB(95,612,108 bytes),latest.yml버전1.5.0, sha512가 로컬과 일치하며 canonical feed에서 익명 206을 반환한다. - 사이트: CI
deploy워크플로는CF_API_TOKEN시크릿이 없어 여전히 실패한다(GAP-REL-09b). 대신 인증된 로컬 wrangler로npm run build --prefix site→ release-identity 작성 →npx wrangler pages deploy site/dist --project-name d3ro --branch main을 실행했고,https://d3ro.chanpaca.net/release-identity.json이 commit5c11ee2, version1.5.0을 보고한다. 라이브 번들이D3RO-Voice-Setup-1.5.0-x64.exe를 계산한다. - 게시 중 발견:
publish-portable-release.mjs의 "동일 파일 건너뛰기"가 1MiB 초과 파일을 크기만으로 비교해, 크기가 우연히 같은runtime-latest볼륨 일부를 낡은 바이트로 남겼다. 파일 목록 API의 sha256으로 정확히 비교하고, 내용이 다르면 별칭 버전 전체를 지우고 다시 올리도록 수정했다(GAP-REL-11). - 남은 게이트: 실제 설치본에서 자동 업데이트 E2E, Electron GUI에서 제안 오버레이·수락 삽입·비밀번호 차단 검증(GAP-INPUT-07), 모바일 production은 별개.
1.3.0 릴리스 절차 (canonical = Forgejo Actions)
선행 조건 — Forgejo 저장소 시크릿. .forgejo/workflows/release.yml은 아래 4개가
없으면 fail-closed로 중단한다. 실측(2026-09-18): 저장소 시크릿이 0건이라 v1.2.0과
v1.3.0 태그 파이프라인이 서명 가드에서 실패했고, 그래서 설치본·업데이트가 게시되지
않았다. 현재 상태 점검과 등록은 다음 한 줄로 한다.
node scripts/ci/set-forgejo-secrets.mjs --check
node --env-file-if-exists=.env scripts/ci/set-forgejo-secrets.mjs --write
| 시크릿 | 의미 |
|---|---|
WIN_CSC_LINK |
public-trust Authenticode PFX (base64). 개발용 Everything2EverythingDev는 거부된다 |
WIN_CSC_KEY_PASSWORD |
PFX password |
WIN_CSC_EXPECTED_SIGNER_SUBJECT |
인증서의 정확한 subject. verify-windows-release-artifact.ps1이 이 identity를 요구한다 |
FORGEJO_TOKEN |
write:package + write:repository (릴리스 게시 단계) |
release/product-version.json의 version/build 값과 모든 버전 면을npm run version:check로 대조한다.CHANGELOG.md## [1.3.0] - 2026-09-18섹션을 사용자 변경점 중심으로 확정한다. publisher는 이 섹션과 그에 대응하는 Play changelog(apps/mobile-rn/metadata/android/*/changelogs/<versionCode>.txt)가 없으면 실패한다.- dirty/untracked 작업을 임의로 reset·clean하지 말고, release 범위만 검토 가능한 authoritative commit으로 보존한다.
- 같은 commit에서 lint, typecheck, test, build, release metadata·security·artifact gate를 전부 GREEN으로 만든다.
- 로컬 전사 엔진 검증: 파이프라인은
sidecar:setup→sidecar:build→verify-sidecar-bundle.mjs를 패키징 전에 실행한다. 이 게이트가 없으면 설치본에 엔진이 빠진 채 게시된다(과거 실제 사고). 로컬에서electron-builder --dir만 볼 때는 서명 실패로 extraResources 복사가 중간에 끊기므로-c.win.forceCodeSigning=false로 확인한다. - desktop offline license를 제공한다면 external private key를 admin의
ADMIN_LICENSE_PRIVATE_KEYsecret로 주입하고, 저장소 public key와 sign/verify roundtrip 및 발급 감사 로그를 확인한다. - 이미 게시된 버전보다 높은 annotated 태그
v1.3.0을 생성해 push한다.npm run release:tag -- --dry-run으로 검증한 뒤npm run release:tag(GPG 사용 시-- --sign)와git push chanpaca v1.3.0를 실행한다. 태그는 불변이며 게이트를 시작하는 후속 단계지 검증을 대체하지 않는다. 이미 게시된 버전을 재게시하지 않는다: canonical publisher는 버전별 자산이 다른 바이트를 가지면 fail-closed로 중단한다. - 시크릿을 나중에 채웠다면 태그를 새로 만들 필요가 없다 —
release.yml은workflow_dispatch를 지원하므로 Forgejo UI에서 해당 태그 ref로 수동 실행한다. - Forgejo Actions run(
/actions/tasksAPI 또는 UI)에서 단계별 결과를 확인한다. pending/stuck/skipped를 GREEN으로 기록하지 않는다. - Forgejo Release note/asset,
latest.yml,update-policy.json, installer hash를 외부 public URL에서 다시 검증한다. - 이전 설치본에서 자동 업데이트 E2E를 실행하고 실행 중 버전·프로세스·사용자 데이터 보존, 그리고 업데이트 후 로컬 받아쓰기 1회 성공을 확인한다.
설치본 크기와 네이티브 ABI
설치본은 90MiB대를 유지해야 한다. 로컬 AI 런타임(사이드카 엔진/ffmpeg)을 설치본에 넣으면
Cloudflare 업로드 한도(100MiB)를 넘어 게시할 수 없다 — build-desktop-installer.mjs 가 넘으면 실패한다.
- 네이티브 ABI 게이트 필수: 패키징 후
node scripts/ci/verify-native-abi.mjs로 확인한다. 개발 PC에서npm install을 돌리면better-sqlite3가 Node ABI로 재빌드되어 설치본이 시작조차 못 한다(실측: 1.3.2). 로컬에서 실행 중인 Electron이 모듈을 잠그면node scripts/ci/fix-native-abi.mjs --dir <win-unpacked>로 Electron ABI를 주입한 뒤--prepackaged로 설치본을 만든다(검증된 트리에서만 패키징). - 런타임은
runtime-latest/runtime.json이 정본이고 앱이 처음 필요할 때 내려받는다. 런타임을 바꾸면 반드시release:portable로 먼저 게시한 뒤 설치본을 게시한다.
서명 없이 내놓기 (portable 채널)
인증서가 없어도 사용자가 설치할 수 있어야 할 때 사용한다. 자세한 조사·비교·제약은
unsigned-distribution.md에 있다.
npm run release:portable:build # 7z 분할 볼륨 + Scoop 매니페스트 생성
npm run release:portable:check # 게시 예정 목록 확인(실제 업로드 없음)
npm run release:portable # Forgejo portable 채널 게시
- 자동 업데이트 피드(
latest.yml)는 건드리지 않는다 — 서명된 릴리스 전용이다. - 볼륨은 불변이다: 같은 버전 경로에 다른 바이트가 있으면 게시가 중단된다.
- 태그/수동 실행 워크플로:
.forgejo/workflows/portable.yml(필요 시크릿:FORGEJO_TOKEN). - 산출물은 7z 분할 볼륨(Scoop용, 162MiB)과 zip 분할 부품(수동 설치용, 243MiB) 두 가지다.
수동 설치 스크립트는 Windows 내장
Expand-Archive만 쓰므로 7-Zip이 필요 없다. - 사용자 설치: Scoop 버킷(
bucket/) 또는install-d3ro-voice.ps1. - 한 버전의 산출물은 한 번의 빌드에서만 나온다(볼륨은 불변). CI 태그 파이프라인이 최초 게시자가 되게 하고, 이미 게시된 버전을 같은 번호로 다시 게시하지 않는다 — 필요하면 버전을 올린다.
- 로컬에서 게시할 때는
npm run release:portable:build가 out/와 sidecar-dist/를 먼저 요구한다 (npm run build --workspace=@d3ro/desktop,npm run sidecar:build --workspace=@d3ro/desktop).
1.2.0 릴리스 절차 (기록)
release/product-version.json의 version/build 값과 모든 버전 면을npm run version:check로 대조한다.CHANGELOG.md## [1.2.0] - 2026-09-16섹션을 사용자 변경점 중심으로 확정한다. publisher는 이 섹션이 없으면 실패해야 한다.- dirty/untracked 작업을 임의로 reset·clean하지 말고, release 범위만 검토 가능한 authoritative commit으로 보존한다.
- 같은 commit에서 lint, typecheck, test, build, release metadata·security·artifact gate를 전부 GREEN으로 만든다. Windows는 production Authenticode PFX를 주입한 CI build와
verify-windows-release-artifact.ps1GREEN이 필수다. - desktop offline license를 제공한다면 external private key를 admin의
ADMIN_LICENSE_PRIVATE_KEYsecret로 주입하고, 저장소 public key와 sign/verify roundtrip 및 발급 감사 로그를 확인한다. - 이미 게시된 버전보다 높은 annotated 태그
v1.2.0을 생성해 push한다.npm run release:tag -- --dry-run으로 검증한 뒤npm run release:tag(GPG 사용 시-- --sign)와git push origin v1.2.0를 실행한다. 태그는 불변이며 게이트를 시작하는 후속 단계지 검증을 대체하지 않는다. 이미 게시된 버전을 재게시하지 않는다: canonical publisher는 버전별 자산이 다른 바이트를 가지면 fail-closed로 중단한다. - GitLab에서 package-windows, package-macos, publish-release와 의도한 mobile job 상태를 모두 확인한다. publish-release가 Forgejo와 GitLab 양쪽에 게시했는지 로그로 확인한다. pending/stuck/skipped를 GREEN으로 기록하지 않는다.
- Forgejo Release note/asset,
latest.yml,update-policy.json, installer hash를 외부 public URL에서 다시 검증한다. - 이전 설치본에서 자동 업데이트 E2E를 실행하고 실행 중 버전·프로세스·사용자 데이터 보존을 확인한다.
mobile release와의 경계
Desktop release를 게시해도 Android production 출시가 자동으로 완료되지 않는다. Android는 다음을 별도로 증명한다.
- 준비된 local upload/evidence key와 AdMob identity를 protected CI secret에 주입하고, 사용자 승인 후 생성한 production Firebase config와 함께 version
1.2.0, versionCode1020001AAB 생성 - package/config/upload signer/ABI/16 KB page size/signed provenance GREEN
- public APK 게시 없이 Play internal track에 제한 업로드
- Play-signed 실기기 E2E, 12명·연속 14일 closed test, production access 승인
- Data safety/App content/production 선언은 사용자의 action-time 검토·승인 후에만 제출
현재 local upload/evidence key는 존재하지만 CI secret 주입·복구 백업·production Firebase·AAB가 없고 Play production access도 disabled이므로 Android production 출시는 RED다.
rollback
- Desktop: 게시 전이면
latestmetadata를 바꾸지 않는다. 이미 업데이트된 클라이언트는 downgrade하지 말고 더 높은 patch 버전으로 forward-fix한다. - Play: staged rollout을 중단하고 더 높은 versionCode의 수정 AAB를 새로 검증·배포한다.
- 복구 작업도 release record에 artifact hash, 시각, 판단자, 영향 범위를 남긴다.
참고 파일
release/product-version.json— 제품 version/build SSOTrelease/android-release-identity.json— Play app/package/certificate identityrelease/mobile-release-evidence-public.pem— release evidence public keyapps/desktop/resources/license/production-public.pem— desktop offline license public key SSOTscripts/ci/sync-version.mjs— 버전 면 동기화·검증scripts/ci/build-portable.mjs— 서명 없는 portable 산출물(7z 분할 볼륨 + Scoop 매니페스트)scripts/ci/publish-portable-release.mjs— portable 채널 게시(불변 가드)scripts/install/install-d3ro-voice.ps1— 수동 설치 스크립트(해시 검증 + 결합 + 해제)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 gatescripts/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 SSOTrelease/update-policy.json— 채널·최소 지원 버전·강제 업데이트·full/delta·staged rollout·킬 스위치 SSOTapps/desktop/src/main/update-policy.ts— 정책 파싱·결정 순수 로직scripts/ci/publish-forgejo-release.mjs— canonical Forgejo registry·Release·feed publisherapps/desktop/electron-builder.yml— builder publish URL·artifact contractdocs/deployment/update-system-assessment.md— 평가·2026 방법론·ADRdocs/v3/play/04-release-checklist.md— Play Console·AAB·closed test·production gate