diff --git a/.gitea/workflows/release.yml b/.gitea/workflows/release.yml
index bfb5bb4..37a4b98 100644
--- a/.gitea/workflows/release.yml
+++ b/.gitea/workflows/release.yml
@@ -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"
diff --git a/README.md b/README.md
index 993d461..52b54ac 100644
--- a/README.md
+++ b/README.md
@@ -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`이다.
## 이력
diff --git a/build-logic/src/main/java/dev/caskeleton/buildlogic/publishing/LibraryPublishingPlugin.java b/build-logic/src/main/java/dev/caskeleton/buildlogic/publishing/LibraryPublishingPlugin.java
index 9b32f94..2f42a9e 100644
--- a/build-logic/src/main/java/dev/caskeleton/buildlogic/publishing/LibraryPublishingPlugin.java
+++ b/build-logic/src/main/java/dev/caskeleton/buildlogic/publishing/LibraryPublishingPlugin.java
@@ -23,7 +23,7 @@ import org.gradle.plugins.signing.SigningExtension;
*
*
* - {@code gitea}: {@code packagesUrl} from gradle.properties, authenticated with the {@code
- * Authorization: token } header. Gitea's job token cannot publish packages,
+ * Authorization: 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.
*
- {@code staging}: {@code build/staging-repository} under the root project. {@code
@@ -78,7 +78,7 @@ public final class LibraryPublishingPlugin implements Plugin {
Provider packagesUrl = project.getProviders().gradleProperty("packagesUrl");
Provider repositoryUrl = project.getProviders().gradleProperty("repositoryUrl");
- Provider token = project.getProviders().environmentVariable("PACKAGES_TOKEN");
+ Provider 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 {
}
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.");
}
});
}
diff --git a/build.gradle b/build.gradle
index c4951d1..fd71d64 100644
--- a/build.gradle
+++ b/build.gradle
@@ -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.')
}
}
}
diff --git a/docs/work/release.md b/docs/work/release.md
index 959547e..fc5a9b3 100644
--- a/docs/work/release.md
+++ b/docs/work/release.md
@@ -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 " 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. 버전 규칙