From a2dfefb6ded31668fae9e5b7550eb998d2959b2a Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 8 Nov 2026 21:59:19 +0900 Subject: [PATCH] =?UTF-8?q?docs(operate):=20=EB=A6=B4=EB=A6=AC=EC=8A=A4=20?= =?UTF-8?q?secret=20=EC=85=8B=EC=9D=84=20=EB=A7=8C=EB=93=9C=EB=8A=94=20?= =?UTF-8?q?=EB=B2=95=EC=9D=84=20=EC=A0=81=EB=8A=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit release.yml이 태그에서 이미지를 올리고 서명하려면 repo secret PACKAGE_TOKEN·COSIGN_PRIVATE_KEY·COSIGN_PASSWORD가 필요하다. 이름만 있고 만드는 법이 없어 소유자가 첫 릴리스 전에 찾아야 했다. operate.md 4.3절에 각 값의 출처(개인 access token의 package 범위, cosign generate-key-pair의 cosign.key와 비밀번호)와 공개 키를 어디에 주는지 적는다. 검증: python3 scripts/check-docs.py, check-work-docs.py 통과. --- docs/work/operate.md | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/work/operate.md b/docs/work/operate.md index 78f08c7a..d6abc978 100644 --- a/docs/work/operate.md +++ b/docs/work/operate.md @@ -104,7 +104,10 @@ ssh desktop 'cd ~/workspace/<작업 이름> && git add -A && git write-tree' - 릴리스는 `v*` 태그 push로 시작한다(`.gitea/workflows/release.yml`). 태그와 push는 소유자가 한다. - 태그 전에 그 커밋에서 `scripts/verify.sh release`를 돌리고, `release.yml`을 손으로 실행(`workflow_dispatch`)해 리허설한다. 손으로 실행하면 모든 release lane, 이미지 빌드, SBOM, 이미지 검사까지 돌고 push·서명은 하지 않는다. - 태그는 PR 단계와 main 단계를 이미 통과한 main 커밋에서 자른다. 그래서 `releaseCheck`는 `ci`를 다시 돌리지 않는다. -- 이미지는 이 Gitea의 컨테이너 레지스트리(`<서버>/<소유자>/caskeleton`)에 올리고, digest를 cosign 키 쌍으로 서명한다(소유자 결정 2026-11-07: Gitea는 keyless 서명에 필요한 OIDC 토큰을 주지 않는다). repo secret `PACKAGE_TOKEN`·`COSIGN_PRIVATE_KEY`·`COSIGN_PASSWORD`는 소유자가 만든다. 서명 job은 확인에 쓴 공개 키를 로그에 남긴다. 배포 쪽 admission 정책은 그 공개 키로 확인한다. +- 이미지는 이 Gitea의 컨테이너 레지스트리(`<서버>/<소유자>/caskeleton`)에 올리고, digest를 cosign 키 쌍으로 서명한다(소유자 결정 2026-11-07: Gitea는 keyless 서명에 필요한 OIDC 토큰을 주지 않는다). repo secret 셋은 소유자가 만든다(repo 설정 → Actions → Secrets). + - `PACKAGE_TOKEN`: 소유자 계정의 개인 access token, 범위는 package 읽기·쓰기(사용자 설정 → Applications). job 토큰은 package를 올릴 수 없다. + - `COSIGN_PRIVATE_KEY`·`COSIGN_PASSWORD`: 노트북에서 `cosign generate-key-pair`로 만든 `cosign.key`의 내용 전체와 그때 넣은 비밀번호. `cosign.pub`는 배포 쪽 admission 정책에 준다. `cosign.key`는 secret에 넣은 뒤 지운다. + - 서명 job은 확인에 쓴 공개 키를 로그에 남긴다. 그것이 `cosign.pub`와 같은지 첫 릴리스에서 본다. ### 4.4 파생 서비스에 템플릿 변경 넘기기