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 파생 서비스에 템플릿 변경 넘기기