Files
clean-architecture-frontend…/docs/operations
DongHyeonka 2e12d2f0d1 fix(ci): 배포 슬롯이 승격 후보를 받게 하고 secret을 deploy 단계에만 준다
문제: (1) 배포 슬롯 계약은 단계 종류만 제한하고 "마지막이 deploy 하나"만
강제했다. checkout → setup-node → frozen-install → deploy(script)처럼
후보 archive를 받지 않고 다시 빌드하는 슬롯도 check:ci를 통과했고,
생성된 job 이름은 그대로 deploy-promoted-release였다(리뷰 실험 E-3).
(2) 생성기는 슬롯의 환경 바인딩을 job 수준 env:로 썼다. 그래서
secrets.* 배포 자격 증명이 checkout, setup-node, frozen-install과
제3자 download action에도 보였다.

고른 방법: (1) deploy 단계에 script가 있으면 promoted-release 전송 하나만
download하고, 그 경로의 release-candidate.tar.gz를 extract하고,
CANDIDATE_ARCHIVE_SHA256을 immutable_build의 digest로 바인딩해야 한다.
extract는 verify-ci-candidate-archive.ts가 digest로 확인한다. 빈 슬롯은
그대로 허용한다. (2) 배포 슬롯의 secrets.* 바인딩은 deploy 단계의 env:로만
렌더링한다. vars.*와 후보 digest는 job 수준에 남는다(extract가 digest를
쓴다).
버린 대안: 슬롯 단계를 템플릿이 통째로 고정하기. 다음 커밋의 제품
overlay가 채우는 모양을 고정하고, gates.json으로 채우는 길은 이 규칙으로
막는다.

위험·한계: 슬롯이 받은 파일을 deploy 스크립트가 실제로 올리는지는 계약이
볼 수 없다. 그것은 FE-GATE-019의 config.json·entry 대조(앞 커밋)가 결과로
본다. 템플릿 슬롯은 비어 있어 생성 workflow 바이트는 바뀌지 않는다.

검증: ci-workflow-generation.test.ts에 후보 없이 deploy하는 슬롯과
digest 없이 extract하는 슬롯의 거절, secret이 deploy 단계 env에만 한 번
나오는 것을 더했다(고치기 전 3건 실패). 425건 통과. check:ci PASS,
CI workflow bytes PASS.

Refs: docs/reviews/2026-11-03-maturity-review/13-build-release-supply-chain.md 13-01, 13-05
2026-11-04 20:43:19 +09:00
..