docs(operate): 릴리스 secret 셋을 만드는 법을 적는다
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 통과.
This commit is contained in:
@@ -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 파생 서비스에 템플릿 변경 넘기기
|
||||
|
||||
|
||||
Reference in New Issue
Block a user