fix(release): SIGNING_KEY에 지문이 들어간 경우를 이름 대고 넣는 법을 적는다
pr / ci (pull_request) Successful in 3m42s

signing-check(run 10)로 v1.0.0 서명 실패의 원인을 찾았다. SIGNING_KEY
secret은 40글자 한 줄이었고 BEGIN·END 줄이 없었다. base64로 읽으면 30바이트,
첫 패킷 tag 55(0x37)였다. 16진수 40글자 지문 `92…`를 base64로 읽으면
첫 바이트가 0xF7, 곧 tag 0x37이다. 비밀 키 대신 키 지문이 들어갔다.

- check-signing-key.sh: 값이 16진수 8·16·40글자(키 ID·지문)면 그렇다고
  말한다. 릴리스 키 지문과 같으면 그것도 말한다(공개 정보만 비교한다).
- release.md 1절: SIGNING_KEY에 넣을 것(export 파일 전체, 줄바꿈 그대로),
  넣는 곳, signing-check로 확인하는 법. 3절: 비밀 값을 바꾼 뒤 첫 태그 전에
  signing-check. 5절: 서명 실패 행. 아무것도 게시되지 않았으면 태그를 고친
  커밋으로 옮겨 같은 버전을 쓴다는 규칙(총괄 결정과 같게).

검증: 지문 40글자를 넣은 경우 rc=1과 「key ID or fingerprint (the release
key's fingerprint)」. 앞 커밋의 시험 다섯은 그대로 통과한다.
This commit is contained in:
DongHyeonka
2026-11-08 15:07:06 +09:00
parent 5e0c89dab4
commit 732cb26eb5
2 changed files with 23 additions and 3 deletions
+14 -2
View File
@@ -27,6 +27,17 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel
- 서명 키: RSA 4096, 지문 `92646CEAFE816CF8B9C249F0A1C936D7F791F8AB`, 2028-11-07 만료. 공개 키는 README 「서명」이다.
- 첫 태그는 `v1.0.0`이다(3절).
**`SIGNING_KEY`에 넣는 것**은 키 지문이나 키 ID(16진수 40·16·8글자)가 아니라 비밀 키 파일 전체다.
```bash
gpg --armor --export-secret-keys 92646CEAFE816CF8B9C249F0A1C936D7F791F8AB > signing-key.asc
```
1. `signing-key.asc`를 열어 첫 줄 `-----BEGIN PGP PRIVATE KEY BLOCK-----`부터 끝 줄 `-----END PGP PRIVATE KEY BLOCK-----`까지 줄바꿈 그대로 복사한다. RSA 4096 키면 100줄 남짓이다.
2. Gitea → 그 repo(grpc-library, messaging-library 둘 다) → 설정 → Actions → Secrets → `SIGNING_KEY`를 고쳐 붙여 넣는다.
3. Actions → `signing-check` → Run workflow(main). 로그에 `PROBLEM` 줄이 없고 `gpg import: ok, secret key fingerprint 92646CEA…F791F8AB`, `signing with SIGNING_PASSWORD: ok`가 나오면 된다. 이 workflow는 값을 출력하지 않는다(`scripts/release/check-signing-key.sh`).
4. `signing-key.asc`를 지운다(`shred -u signing-key.asc`).
## 2. 버전 규칙
- SemVer, repo 하나에 버전 하나. 모든 모듈이 같은 버전으로 나간다. 태그는 `vMAJOR.MINOR.PATCH`이고 접미사(`-rc.1` 등)는 없다. 다른 모양의 태그는 `ca.java-conventions`가 빌드 전에 거부한다.
@@ -39,7 +50,7 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel
1. main이 초록인지 본다(main.yml 마지막 실행).
2. `CHANGELOG.md`에 그 버전 절을 쓰고 PR로 병합한다.
3. 올리기 전까지를 desktop에서 미리 돌려 본다(비밀 값 없이, 4절).
3. 올리기 전까지를 desktop에서 미리 돌려 본다(비밀 값 없이, 4절). 비밀 값을 넣거나 바꾼 뒤 첫 태그라면 `signing-check` workflow도 한 번 돌린다(1절).
4. 태그를 단다.
```bash
@@ -65,7 +76,8 @@ scripts/verify.sh release --on desktop
| 어디서 | 뜻 | 할 일 |
| --- | --- | --- |
| 1~4단계 | 아무것도 올라가지 않았다 | 고쳐서 main에 병합하고 같은 태그 이름을 새 커밋에 다시 달지 않는다. 다음 PATCH 태그를 쓴다 |
| 1~4단계, 서명 | 아무것도 올라가지 않았다 | 고쳐서 main에 병합한다. 그 버전의 파일이 Packages에 하나도 없으면(`maven-metadata.xml`에 없음) 태그를 지우고 고친 main 커밋에 같은 태그를 다시 단다. 하나라도 올라갔으면 다음 PATCH를 쓴다 |
| 서명 직전 `verifySigningKey`, 또는 `Could not read PGP secret key` | 서명 비밀 값이 키로 읽히지 않는다 | `signing-check` workflow의 `PROBLEM` 줄이 원인이다(지문을 넣음, 줄바꿈 잃음, BEGIN·END 줄 빠짐, base64 손상, 다른 키, 틀린 암호). 1절대로 다시 넣는다 |
| 5단계 중간 | 일부 모듈만 올라갔을 수 있다 | 그 버전은 버린다(지우지 않는다). 원인을 고치고 다음 PATCH를 낸다. `CHANGELOG.md`에 버린 버전을 적는다 |
| 6단계 | 올라갔지만 익명으로 안 읽힌다 | owner 공개 설정을 확인한다. 템플릿 이미지 빌드가 토큰 없이 읽는다는 전제(설계 8.3절 R1)가 깨진 것이다 |