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
+2 -2
View File
@@ -4,7 +4,7 @@
# anonymously). Publishing starts only after releaseCheck has passed, so a red check leaves nothing
# half-published (Gitea refuses a second upload of a version).
#
# Secrets (repository settings, created by the owner): PACKAGES_TOKEN, a personal access token with
# Secrets (repository settings, created by the owner): PACKAGE_TOKEN, a personal access token with
# package read/write only (the job token cannot publish packages); SIGNING_KEY, an ASCII-armoured PGP
# secret key; SIGNING_PASSWORD, its passphrase.
name: release
@@ -36,7 +36,7 @@ jobs:
- run: ./gradlew releaseCheck release --stacktrace
env:
RELEASE_TAG: ${{ github.ref_name }}
PACKAGES_TOKEN: ${{ secrets.PACKAGES_TOKEN }}
PACKAGE_TOKEN: ${{ secrets.PACKAGE_TOKEN }}
SIGNING_KEY: ${{ secrets.SIGNING_KEY }}
SIGNING_PASSWORD: ${{ secrets.SIGNING_PASSWORD }}
TESTCONTAINERS_REUSE_ENABLE: "false"
+35 -1
View File
@@ -68,7 +68,41 @@ dependencies {
## 서명
배포 파일마다 PGP 서명(`.asc`)이 붙는다. 공개 키는 첫 릴리스 때 소유자가 여기에 붙인다(`docs/work/release.md` 1절).
배포 파일마다 PGP 서명(`.asc`)이 붙는다. 서명 키는 RSA 4096, 지문 `92646CEAFE816CF8B9C249F0A1C936D7F791F8AB`, 2028-11-07에 만료된다. 키를 바꾸는 법은 `docs/work/release.md` 1절이다.
```text
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBGrv1SYBEADGgq8CTE7wdDPIg0zNRXelPvlgyK04tpDTL0b9k1INxDwFEiS0
87bTL22Zjipp+2uDg012TALeLsDV12yh1IToNaYq7zR9bRvEua25+351zw91ojC+
z2/1Y7S98o813hu6qP6EFUHnsWPVLEt40mlGDn3kl8iXMLgjozVYbylomweh/Yvz
HLJd5lQGE76mIejIeGp3m1OA5M2RV4xspA8K8TZkXXSqe3nbfSjPXAOwysPmRRd9
IoLDwakSq4tRI9dlm08bzznsoaaTCRcJ0XAbJK7+ZrQkSwIrsi/gsBkCOJI6Wcs6
+R+9Wy7tYsyd59TdgIdjq3uHadSLWQ3dc0g0ux2krxSL0PHXrT9Upmcorj2+Ltkh
9J1I6hUv1O7e0Y8Es7Ov5WUPfdSdQ5ApwtwFX5aSwYokoW9wXMLg2zdQx0JEx1ix
/qTEvpSKfM0/zVbKJO9RDF/F7HZkDWSOhZe+4x7dak+xN6KOfEQVmcBneaGtPqgJ
eAsIBgRwp42G5llqnTcWAHLAKCDEE9wHK3+gJt5f5rO5e+r1GoYHLn0Iw3iiX6rC
NFot/5my/oePTeRur5tjv14kw1FMXHVNvLOxHeaiZzfVVjO/vbwAtGvZDiRdAgd6
kHyt9Ch/JccIa0ylA9Tttb0A33ZGTQl6sAC6jTSIhfnEAdlCX7MVAE8n4wARAQAB
tCNkb25naHllb24ua2FuZyA8ZG9uZzUxMjlAZ21haWwuY29tPokCVwQTAQoAQRYh
BJJkbOr+gWz4ucJJ8KHJNtf3kfirBQJq79UmAhsDBQkDwmcABQsJCAcCAiICBhUK
CQgLAgQWAgMBAh4HAheAAAoJEKHJNtf3kfir2j8P/RWRT0GTxBNQvm76iO6XnvFD
mDPGq37A5iuD4pJ624/BccKTGe8+WWqtlpAiN6AdHGNi/LGhuYaGL9ce6Gja5tTX
y/ZY8jthbEoi41g6cim8W8knd3v2Ne/qj3dKvphSiVsZBrumEzrZyw2UUD3IRqVx
r2WQZTcSa4UDd7+Qie0h8IrnmfMYIseDCWjDCATNJqr9PBGoKYehv8+Wo3QDVBRd
B0lWepudJjLTsPCXsgFnFJ2HmltRQr1JB+I4CPasfsBp3xqF23hywUuW6fOsHZvv
g5QU7qYfaoxG6E8krGpiibocF5EKXtpEYzDOBFoDS9uNVBAD/LzS7OGtTFr5x3qL
is3eccwNClQS1jeX8Guxam+TlO8XaqnQLCIpdau20/sge6PqXKXauKZiBTGCak1j
zVDQ/sro3VRPePusNHK1CdOi6wiruXw4ZLWO3aEHibi8LbgfwymxXHEtJO5zwFcD
qAnp7KEAkOG8y5LR0FfwWWYnqUZxWJ0ua2Acf8gL8o6DO5pVyJSYrdgCpWjwEWcp
Ms2iit9bCNIMaH6EVgLA2NWCuIL9xAFdXqw/VXrMVK3XXftzNvayvLJCH2eintRg
IKLO/ewISKIFQd3+II3/MM80eUvKGtfi8Y1mj1zyQtcPVykru5DEHjpaLs2SPxdI
Lp+HGQo/NvzwdpIV+8TQ
=eD8w
-----END PGP PUBLIC KEY BLOCK-----
```
받은 파일을 확인하는 법: 위 키를 `gpg --import`로 넣고 `gpg --verify <파일>.asc <파일>`. 배포 토큰 secret 이름은 설계 문서의 `PACKAGES_TOKEN`이 아니라 등록된 `PACKAGE_TOKEN`이다.
## 이력
@@ -23,7 +23,7 @@ import org.gradle.plugins.signing.SigningExtension;
*
* <ul>
* <li>{@code gitea}: {@code packagesUrl} from gradle.properties, authenticated with the {@code
* Authorization: token <PACKAGES_TOKEN>} header. Gitea's job token cannot publish packages,
* Authorization: token <PACKAGE_TOKEN>} header. Gitea's job token cannot publish packages,
* so the token is a package-scoped personal access token in a repository secret; it is read
* from the environment and never written to a file.
* <li>{@code staging}: {@code build/staging-repository} under the root project. {@code
@@ -78,7 +78,7 @@ public final class LibraryPublishingPlugin implements Plugin<Project> {
Provider<String> packagesUrl = project.getProviders().gradleProperty("packagesUrl");
Provider<String> repositoryUrl = project.getProviders().gradleProperty("repositoryUrl");
Provider<String> token = project.getProviders().environmentVariable("PACKAGES_TOKEN");
Provider<String> token = project.getProviders().environmentVariable("PACKAGE_TOKEN");
PublishingExtension publishing = project.getExtensions().getByType(PublishingExtension.class);
MavenPublication publication =
@@ -166,7 +166,7 @@ public final class LibraryPublishingPlugin implements Plugin<Project> {
}
if (token.getOrElse("").isBlank()) {
throw new GradleException(
"PACKAGES_TOKEN is not set; Gitea's job token cannot publish packages.");
"PACKAGE_TOKEN is not set; Gitea's job token cannot publish packages.");
}
});
}
+3 -3
View File
@@ -177,7 +177,7 @@ publishing {
url = providers.gradleProperty('packagesUrl')
credentials(HttpHeaderCredentials) {
name = 'Authorization'
value = "token ${providers.environmentVariable('PACKAGES_TOKEN').getOrElse('')}"
value = "token ${providers.environmentVariable('PACKAGE_TOKEN').getOrElse('')}"
}
authentication {
header(HttpHeaderAuthentication)
@@ -202,13 +202,13 @@ tasks.withType(PublishToMavenRepository).configureEach {
mustRunAfter tasks.named('releaseCheck')
if (name.endsWith('ToGiteaRepository')) {
def signed = !signingKey.isBlank()
def token = providers.environmentVariable('PACKAGES_TOKEN').getOrElse('')
def token = providers.environmentVariable('PACKAGE_TOKEN').getOrElse('')
doFirst {
if (!signed) {
throw new GradleException('SIGNING_KEY is not set; refusing to publish unsigned files to Gitea.')
}
if (token.isBlank()) {
throw new GradleException('PACKAGES_TOKEN is not set; Gitea\'s job token cannot publish packages.')
throw new GradleException('PACKAGE_TOKEN is not set; Gitea\'s job token cannot publish packages.')
}
}
}
+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. 버전 규칙