소유자가 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:
@@ -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"
|
||||
|
||||
@@ -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`이다.
|
||||
|
||||
## 이력
|
||||
|
||||
|
||||
+3
-3
@@ -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
@@ -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
@@ -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. 버전 규칙
|
||||
|
||||
|
||||
Reference in New Issue
Block a user