In-cluster Kaniko tip → GHCR (vs Actions build-ghcr)
공유 클러스터에서 test tip 이미지(test-<sha>)를 자주 돌릴 때, hosted runner build-ghcr-images만 두면 Actions 비용·대기·main-auto 압력이 커진다. tip 공급의 1차 경로는 in-cluster Kaniko Job → GHCR, Actions는 workflow_dispatch fallback.
축 분리
| 경로 | 용도 | 금지 |
|---|---|---|
| Kaniko tip | test-<sha> overlay/재스모크 | tip 태그를 Prod package/publish-releases로 쓰지 않음 |
build-ghcr-images | semver/Prod 패키지·(옵션) multi-arch | tip 전용 자동 push:main을 기본으로 두지 말 것(비용) |
publish-releases | Release asset/README | test-* 태그 즉시 fail; Docker 재빌드 없이 사전 GHCR 검증 |
Prod package ≠ 공유 클러스터 apply — Test-Overlay-vs-Release-Package-Deploy-Paths.md. Feature Done 증거에 prod_* = N/A (package out of scope)가 정상일 수 있다.
클러스터 전제
# 개념
# Secret: github-token + Docker config.json → /kaniko/.docker/
# SA: batch/jobs create·delete in app NS
./build-tip-images-kaniko.sh <test-sha> <ref>- Executor 핀 예:
gcr.io/kaniko-project/executor:v1.23.2(upstream archive → Chainguard/self-build 기술부채). - context는
dir://등 tar extract 면이 좁은 방식 선호. - GHCR: PAT Contents OK ≠ Packages Write; Actions
packages:write≠ 패키지 Manage ACL — GHCR-Actions-Package-Write-ACL.md, GitHub-Fine-Grained-PAT-Contents-Write-Probe.md.
Multi-arch
Prod/Apple Silicon용 backend amd64+arm64는 opt-in (backend_multi_arch=true → linux/amd64,linux/arm64, QEMU on ubuntu-latest). tip 기본은 linux/amd64. sidecar/MCP 이미지는 multi-arch 비목표(amd64). 증거: docker buildx imagetools inspect ghcr.io/<owner>/<img>:<tag>.
build-ghcr-images fallback 함정
build-ghcr-images.yml에 environment workflow input이 없다. inputs.environment를 넣으면 GitHub API HTTP 422다. metadata-only 델타는 tip 이미지 재빌드 없이 FS PUT만으로 충분할 수 있다. backend-only tip이 필요하면:
gh workflow run build-ghcr-images.yml \
-f tag=test-<shortsha> \
-f backend_multi_arch=false이후 kubectl set image tip roll — mcp Deployment 핀은 유지한다.
SHA ref 체크아웃
스톡 스크립트가 git clone --branch <ref>이면 커밋 SHA를 --branch에 넣으면 Init:Error다. tip Job의 git-ref는 브랜치명(예: main)을 쓰고, 태그만 test-<short_sha>로 맞춘다. one-shot이 특정 커밋을 강제해야 하면 git fetch origin <sha> && git checkout <sha>. backend-only 델타면 MCP Kaniko Job을 생략하고 퍼블리시 바이너리 핀은 유지 — Tip-Roll-Keep-Published-Binary.md.
Stale github-token → git-clone 403
Kaniko tip Job이 Init:Error이고 로그가 Write access to repository not granted / HTTP 403이면, GHCR Packages 권한보다 먼저 clone용 Contents를 의심한다. Secret(예: *-ghcr-build)의 github-token이 만료되었거나 private repo Contents:Read를 잃으면 clone 단계에서 죽는다. SETUP 절차로 github-token + ghcr.io config.json을 재생성한 뒤 tip 스크립트를 재실행한다. Packages Write ACL과는 별 축 — GHCR-Actions-Package-Write-ACL.md.
AA 스코프
quality.yaml에 security.command 없으면 mechanical skip + Kaniko/Secret 경로 수동 리뷰. ConfigMap에 API 키 잔여는 사전 존재 Forbidden 패턴으로 NF follow-up — tip 게이트 fail과 분리.
Backend tip_roll 배포 및 RBAC
테넌트 환경에서 백엔드 변경 사양을 클러스터에 반영할 때, Deployment 패치와 권한 분리에 관한 규칙.
- Kaniko 빌드 및 롤 권한:
- TA SA (
cursor-agent-test-ns-write등) 권한은nl2sql네임스페이스 내에서 Jobs를 생성/삭제하고 Deployments를 패치할 수 있는 RBAC 권한이 필요하다. - 동기화된 테넌트 체크아웃에서
./deploy/scripts/build-tip-images-kaniko.sh test-<short> main을 실행하여test-<short>이미지 빌드를 수행한다.
- TA SA (
tip_roll제한 (mcp 핀 보호):- 빌드가 완료되면 백엔드만 해당
ghcr.io/yoosungung/nl2sql-backend:test-<short>이미지로 롤링 업데이트를 수행한다. - mcp Deployment는
test-*이미지로 덮어쓰지 말 것 (Init:Error 위험 및 verify.md 오동작 방지). mcp는 이전의 안정적인 팁 핀(prior tip pin) 상태로 둔다.
- 빌드가 완료되면 백엔드만 해당
- 완료 게이트 (Done Gate):
- 해당 기능 구현(Done)의 배포 게이트 완료 조건은 제품의 팁 이미지 SHA가 병합 커밋(예: PR 115의
53a45e1)을 포함하는 상태여야 한다. (메타데이터 git head의 SHA와는 무관함) /api/ready가 200 성공 응답을 주어야 배포 완료로 판단한다.
- 해당 기능 구현(Done)의 배포 게이트 완료 조건은 제품의 팁 이미지 SHA가 병합 커밋(예: PR 115의