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:
+14
-2
@@ -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)가 깨진 것이다 |
|
||||
|
||||
|
||||
@@ -24,7 +24,7 @@ if [ -z "${SIGNING_KEY:-}" ]; then
|
||||
fi
|
||||
[ -n "${SIGNING_PASSWORD:-}" ] || echo "check-signing-key: SIGNING_PASSWORD is empty (only right for a key without a passphrase)"
|
||||
|
||||
python3 - <<'PY' || fail=1
|
||||
EXPECTED_FINGERPRINT=$expected python3 - <<'PY' || fail=1
|
||||
import base64, os, re, sys
|
||||
|
||||
key = os.environ["SIGNING_KEY"]
|
||||
@@ -39,6 +39,14 @@ print(f"shape: {len(key)} characters, {key.count(chr(10)) + 1} lines,"
|
||||
f" leading whitespace {'yes' if key[:1].isspace() else 'no'},"
|
||||
f" trailing whitespace {'yes' if key[-1:].isspace() else 'no'}")
|
||||
|
||||
stripped = key.strip()
|
||||
if re.fullmatch(r"(0x)?[0-9A-Fa-f]{8}|(0x)?[0-9A-Fa-f]{16}|[0-9A-Fa-f]{40}", stripped):
|
||||
expected = os.environ.get("EXPECTED_FINGERPRINT", "")
|
||||
same = " (the release key's fingerprint)" if expected and stripped.upper() == expected.upper() else ""
|
||||
print(f"PROBLEM: SIGNING_KEY holds a {len(stripped)}-hex-digit key ID or fingerprint{same}, not the key."
|
||||
" Put in the output of `gpg --armor --export-secret-keys <fingerprint>` instead, BEGIN to END lines.")
|
||||
sys.exit(1)
|
||||
|
||||
lines = key.replace("\r\n", "\n").replace("\r", "\n").split("\n")
|
||||
while lines and lines[-1].strip() == "":
|
||||
lines.pop()
|
||||
|
||||
Reference in New Issue
Block a user