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)」. 앞 커밋의 시험 다섯은 그대로 통과한다.
문서 지도
1. 어디에 무엇이 있나
| 폴더 | 종류 | 고치는 법 |
|---|---|---|
work/ |
작업 방법(고치기, 게이트, 릴리스) | 살아 있는 문서. 동작이 바뀌면 같은 변경에서 고친다 |
compatibility/ |
지원 매트릭스(무엇을 인증했나) | 살아 있는 문서 |
runbooks/ |
운영 대응 | 살아 있는 문서 |
adr/ |
결정 기록(ADR-GRPC-*) | 기록. 본문은 고치지 않는다 |
design/ |
설계서 | 기록. 본문은 고치지 않는다 |
ledger/ |
예측·실측 장부 | 줄을 더하기만 한다 |
vision.md, problem-statement.md |
방향, 풀 문제 | vision.md는 소유자만 쓴다 |
2. 기록 문서의 머리 블록
adr/와 design/의 문서는 맨 위에 머리 블록을 둔다. 본문은 쓴 때의 원문이고, 지금도 맞는지는 머리 블록이 말한다.
<!-- 머리 블록: 이 블록을 빼면 원문이다. 형식은 docs/README.md 「기록 문서의 머리 블록」 -->
> **결정 기록** 본문은 결정한 때의 내용이다. 지금도 유효한지는 「상태」를, 지금 동작은 「현재 정본」을 읽는다.
- 상태: 채택 | 대체됨(무엇으로) | 폐기
- 작성일: YYYY-MM-DD
- 요약: 한 문장
- 현재 정본: 지금 동작을 설명하는 살아 있는 문서 경로
<!-- 머리 블록 끝 -->
지난 결정이 바뀌면 본문은 두고 「상태」와 「현재 정본」만 고친다. 템플릿에서 옮겨 온 기록의 본문 경로(src/platforms/…, .github/workflows/…)는 그 결정 때의 템플릿 경로다.