fix(release): 배포 토큰 secret 이름을 등록된 PACKAGE_TOKEN에 맞춘다
pr / ci (pull_request) Successful in 3m54s

소유자가 repo secret 셋을 등록했다(2026-11-08): PACKAGE_TOKEN,
SIGNING_KEY, SIGNING_PASSWORD. workflow·빌드·문서는 설계 05 7절의
PACKAGES_TOKEN(S 있음)을 읽고 있어서, 태그를 달면 release가 「token is
not set」으로 멈췄을 것이다. 소유자에게 다시 등록을 부탁하지 않고 등록된
이름에 맞춘다.

- release.yml env와 secret 참조, root build.gradle과
  LibraryPublishingPlugin의 환경 변수 이름을 PACKAGE_TOKEN으로.
- docs/work/release.md 1절을 「소유자가 둔 비밀 값」 표로 바꿨다(무엇,
  바꾸는 법, 설계와 이름이 다른 이유, 서명 키 지문·만료).
- README 「서명」에 공개 키(RSA 4096, 지문 92646CEA…F791F8AB, 2028-11-07
  만료)와 확인 명령을 넣었다.

검증: scripts/verify.sh docs rc=0. 빌드 쪽은 이 PR의 pr.yml 실행.
This commit is contained in:
DongHyeonka
2026-11-08 13:06:14 +09:00
parent ce83f4d550
commit 39d4b6d2a7
5 changed files with 53 additions and 24 deletions
+10 -15
View File
@@ -13,24 +13,19 @@ main 병합 ──> 소유자가 태그 vX.Y.Z push ──> .gitea/workflows/rel
6. 익명으로 maven-metadata.xml을 읽어 새 버전 확인
```
## 1. 처음 한 번 — 소유자가 할 일
## 1. 비밀 값 — 소유자가 둔다
에이전트는 토큰·키를 만들거나 secret에 넣지 않는다. 아래는 소유자가 한다.
에이전트는 토큰·키를 만들거나 secret에 넣지 않는다. 소유자가 2026-11-08에 repo secret 셋을 등록했다.
1. **배포 토큰 `PACKAGES_TOKEN`**: Gitea 웹 → 설정 → 애플리케이션 → 새 토큰. 권한은 `package` 읽기·쓰기만 준다(repository·user 권한은 주지 않는다). Gitea job 토큰(`GITEA_TOKEN`)은 패키지를 올릴 수 없어서 사람 토큰이 필요하다.
2. **서명 키 `SIGNING_KEY`·`SIGNING_PASSWORD`**: PGP 키 쌍 하나를 두 라이브러리(grpc, messaging)가 함께 쓴다.
| secret | 무엇 | 바꿀 때 |
| --- | --- | --- |
| `PACKAGE_TOKEN` | Gitea 개인 토큰. 권한은 `package` 읽기·쓰기만(repository·user 권한 없음). Gitea job 토큰(`GITEA_TOKEN`)은 패키지를 올릴 수 없어서 사람 토큰이 필요하다 | Gitea 웹 → 설정 → 애플리케이션에서 새로 만들어 secret을 덮어쓰고 옛 토큰을 지운다 |
| `SIGNING_KEY` | 서명용 PGP 비밀 키(ASCII armor 전체). 두 라이브러리(grpc, messaging)가 같은 키를 쓴다 | 새 키 쌍을 만들고 README 「서명」의 공개 키와 지문을 같은 PR에서 바꾼다. 만료(2028-11-07) 전에 한다 |
| `SIGNING_PASSWORD` | 그 키의 암호 | 키와 함께 |
```bash
gpg --quick-generate-key "hyeonworks release <admin@hyeonworks.com>" ed25519 sign 2y
```
```bash
gpg --armor --export-secret-keys <키 ID> > signing-key.asc
```
`signing-key.asc` 내용 전체가 `SIGNING_KEY`, 키를 만들 때 넣은 암호가 `SIGNING_PASSWORD`다. 넣은 뒤 `signing-key.asc`는 지운다. 공개 키(`gpg --armor --export <키 ID>`)는 README 「서명」 절에 붙인다.
3. **repo secret 셋**: grpc-library → 설정 → Actions → Secrets에 `PACKAGES_TOKEN`, `SIGNING_KEY`, `SIGNING_PASSWORD`.
4. **첫 태그 `v1.0.0`**: 아래 3절을 따른다.
- 이름: 설계(design-docs `repo-structure/05-library-repos.md` 7절)는 `PACKAGES_TOKEN`이라고 적었지만, 등록된 이름 `PACKAGE_TOKEN`에 workflow와 빌드를 맞췄다. 소유자에게 다시 등록을 부탁하지 않는다.
- 서명 키: RSA 4096, 지문 `92646CEAFE816CF8B9C249F0A1C936D7F791F8AB`, 2028-11-07 만료. 공개 키는 README 「서명」이다.
- 첫 태그는 `v1.0.0`이다(3절).
## 2. 버전 규칙