ci(gates): release job이 FE-GATE-028에 릴리스 태그를 넘긴다 #42

Merged
donghyeon.kang merged 1 commits from donghyeon.kang/ci/release-tag-for-a11y-review AGit into main 2026-11-13 04:13:26 +00:00
Owner

무엇을, 왜

서명된 수동 접근성 기록의 「Release ID」를 무엇과 대조할지 정해지지 않았다(round9 1112/05-01, R9-D7). 처음 정한 --release-root 안은 성립하지 않는다. FE-GATE-028은 후보를 만드는 immutable_build보다 앞의 release_gate에서 돌고, 후보의 releaseId는 run마다 다른 env RELEASE_ID(ref-run_id-attempt)에서 온다. r9-fe가 (가) 릴리스 태그로 정했다.

고른 방법과 버린 대안

  • release_gate job env에 RELEASE_TAG를 둔다: tag run이면 gitea.ref_name(예 v1.4.0), 아니면 빈 값.
  • FE-GATE-028이 그것을 requiresEnvironment로 요구한다. run-ci-gate.ts는 빈 필수 변수를 거절하므로, 브랜치에서 수동으로 돌린 release 단계에서는 028이 missing required environment: RELEASE_TAG로 실패한다(fail-closed, 의도한 동작).
  • 계약의 job env 고정(expectedEnvironmentBindings)과 docs/operations/ci-quality-gates.md를 같이 고친다.
  • 버린 대안: 명령 인자로 후보 root 넘기기(028 시점에 후보가 없음), releaseId를 tag 기준 결정값으로 바꾸기(빌드 식별 계약 변경), 028을 이전 run의 후보를 받는 흐름으로 옮기기(job 그래프 변경).

위험과 영향

  • 기록의 「Release ID」를 이 태그와 대조하는 일은 검사(scripts/verify-a11y-manual.ts)와 기록 양식 쪽(round9 그룹 A5)이 한다. 이 PR만으로는 값을 받기만 한다. 검사가 아직 env를 읽지 않아도 깨지지 않으므로 A5보다 먼저 들어가도 된다.
  • 다운스트림: release 단계를 브랜치에서 수동으로 돌리던 흐름은 028에서 멈춘다. tag(v*)로 돌린다.

검증

  • RED: 새 시험이 바꾸기 전 gates.json에서 실패. GREEN: ci-workflow-generation 446개 통과(main 9068faf2 위로 올린 뒤), check:ci·check:types·eslint·verify:documentation rc=0.
  • desktop ci:gate FE-GATE-028: RELEASE_TAG가 비면 missing required environment: RELEASE_TAG로 실패, v0.0.0이면 그 줄 없이 검사까지 간다(서명 없는 템플릿 기록이라 지금처럼 incomplete로 실패).
  • desktop scripts/verify.sh gate FE-GATE-010 rc=0, FE-GATE-005 rc=0(올리기 전 트리 281a4015, 바뀐 것은 이 커밋과 #41뿐).
  • 이 PR의 runner run은 #41 병합 뒤 main push run이 저장한 의존성 캐시를 읽는 첫 PR run이다(hit 실측).

리뷰어가 볼 곳

  • config/ci/gates.json의 release_gate.environment와 FE-GATE-028 requiresEnvironment.
  • scripts/contracts/ci-gates.ts의 expectedEnvironmentBindings.release_gate.

관련

  • round9 리뷰 이월 1112/05-01, 결정 R9-D7(docs/work/reference/decisions.md).
## 무엇을, 왜 서명된 수동 접근성 기록의 「Release ID」를 무엇과 대조할지 정해지지 않았다(round9 1112/05-01, R9-D7). 처음 정한 `--release-root` 안은 성립하지 않는다. FE-GATE-028은 후보를 만드는 `immutable_build`보다 앞의 `release_gate`에서 돌고, 후보의 `releaseId`는 run마다 다른 env `RELEASE_ID`(`ref-run_id-attempt`)에서 온다. r9-fe가 (가) 릴리스 태그로 정했다. ## 고른 방법과 버린 대안 - `release_gate` job env에 `RELEASE_TAG`를 둔다: tag run이면 `gitea.ref_name`(예 `v1.4.0`), 아니면 빈 값. - FE-GATE-028이 그것을 `requiresEnvironment`로 요구한다. `run-ci-gate.ts`는 빈 필수 변수를 거절하므로, 브랜치에서 수동으로 돌린 release 단계에서는 028이 `missing required environment: RELEASE_TAG`로 실패한다(fail-closed, 의도한 동작). - 계약의 job env 고정(`expectedEnvironmentBindings`)과 `docs/operations/ci-quality-gates.md`를 같이 고친다. - 버린 대안: 명령 인자로 후보 root 넘기기(028 시점에 후보가 없음), releaseId를 tag 기준 결정값으로 바꾸기(빌드 식별 계약 변경), 028을 이전 run의 후보를 받는 흐름으로 옮기기(job 그래프 변경). ## 위험과 영향 - 기록의 「Release ID」를 이 태그와 대조하는 일은 검사(`scripts/verify-a11y-manual.ts`)와 기록 양식 쪽(round9 그룹 A5)이 한다. 이 PR만으로는 값을 받기만 한다. 검사가 아직 env를 읽지 않아도 깨지지 않으므로 A5보다 먼저 들어가도 된다. - 다운스트림: release 단계를 브랜치에서 수동으로 돌리던 흐름은 028에서 멈춘다. tag(`v*`)로 돌린다. ## 검증 - RED: 새 시험이 바꾸기 전 gates.json에서 실패. GREEN: ci-workflow-generation 446개 통과(main 9068faf2 위로 올린 뒤), check:ci·check:types·eslint·verify:documentation rc=0. - desktop `ci:gate FE-GATE-028`: `RELEASE_TAG`가 비면 `missing required environment: RELEASE_TAG`로 실패, `v0.0.0`이면 그 줄 없이 검사까지 간다(서명 없는 템플릿 기록이라 지금처럼 incomplete로 실패). - desktop `scripts/verify.sh gate FE-GATE-010` rc=0, `FE-GATE-005` rc=0(올리기 전 트리 281a4015, 바뀐 것은 이 커밋과 #41뿐). - 이 PR의 runner run은 #41 병합 뒤 main push run이 저장한 의존성 캐시를 읽는 첫 PR run이다(hit 실측). ## 리뷰어가 볼 곳 - `config/ci/gates.json`의 `release_gate.environment`와 FE-GATE-028 `requiresEnvironment`. - `scripts/contracts/ci-gates.ts`의 `expectedEnvironmentBindings.release_gate`. ## 관련 - round9 리뷰 이월 1112/05-01, 결정 R9-D7(`docs/work/reference/decisions.md`).
donghyeon.kang added 1 commit 2026-11-13 02:03:42 +00:00
ci(gates): release job이 FE-GATE-028에 릴리스 태그를 넘긴다
frontend-quality-gates / merge / static checks (pull_request) Successful in 2m9s
frontend-quality-gates / merge / tests (pull_request) Successful in 18m3s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 7m39s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
000b5a35be
문제: 서명된 수동 접근성 기록의 「Release ID」를 무엇과 대조할지 정해지지
않았다(round9 1112/05-01, R9-D7). 처음 정한 `--release-root` 안은 성립하지
않는다. FE-GATE-028은 후보를 만드는 `immutable_build`보다 앞의 `release_gate`
에서 돌고, 후보의 `releaseId`는 run마다 다른 env `RELEASE_ID`에서 온다.
r9-fe가 (가) 릴리스 태그로 정했다.

고친 것: `release_gate` job env에 `RELEASE_TAG`(tag run이면 `gitea.ref_name`,
아니면 빈 값)를 두고, FE-GATE-028이 그것을 `requiresEnvironment`로 요구한다.
`run-ci-gate.ts`는 빈 필수 변수를 거절하므로, 브랜치에서 수동으로 돌린
release 단계에서는 028이 `missing required environment: RELEASE_TAG`로
실패한다(fail-closed, 의도한 동작). 계약의 job env 고정과
ci-quality-gates.md를 같이 고친다.

버린 대안: 명령 인자로 후보 root 넘기기(028 시점에 후보가 없음),
releaseId를 tag 기준 결정값으로 바꾸기(빌드 식별 계약 변경), 028을 이전
run의 후보를 받는 흐름으로 옮기기(job 그래프 변경).

위험·한계: 기록의 「Release ID」를 이 태그와 대조하는 일은 검사
(`scripts/verify-a11y-manual.ts`)와 기록 양식 쪽(그룹 A5)이 한다. 이 커밋만
으로는 값을 받기만 한다. 다운스트림이 release 단계를 브랜치에서 수동으로
돌리던 흐름은 028에서 멈춘다.

검증(desktop): 새 시험이 바꾸기 전 gates.json에서 실패(RED), 고친 뒤
ci-workflow-generation 439개 통과. check:ci·check:types·eslint·
verify:documentation rc=0. `ci:gate FE-GATE-028`: `RELEASE_TAG`가 비면
`missing required environment: RELEASE_TAG`로 실패, `v0.0.0`이면 그 줄 없이
검사까지 간다(서명 없는 템플릿 기록이라 지금처럼 incomplete로 실패).

Refs: 1112/05-01
donghyeon.kang merged commit 94e9401af7 into main 2026-11-13 04:13:26 +00:00
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: donghyeon.kang/clean-architecture-frontend-template#42