문제
workflow는 모든 job에 CI=true와 CI 빌드 식별값을 준다. 메인 세션이 깨끗한
clone에서 그 env 그대로(CI=true 포함) merge 단계 14개를 돌리자 FE-GATE-005·
008·020이 실패했다.
- vitest 안의 fixture 빌드(tests/e2e/support/fixture-builds.ts →
build-frontend.ts)가 CI=true를 물려받아 release 빌드처럼 검사된다.
af312de가 vitest에서 VITE_COMMIT_SHA를 지워 "missing required CI build
environment: VITE_COMMIT_SHA"로 멈춘다(service-worker-build-output 7건이
돌지 않음, 제거 드릴 안에서도 같다).
- 시각 골든 build(9bddfa5)가 VITE_COMMIT_SHA="local"을 받는데 CI=true가
40·64자리 hex를 요구해 webServer가 뜨지 않는다.
내 X4가 CI=true 없이 돌아 놓쳤다. 1103/11-07과 같은 원인이다.
고른 방법
- scripts/lib/build-environment.ts에 둘을 둔다.
- localBuildEnvironment(env): spawn하는 로컬 빌드용. CI와 CI 빌드 식별값을
뺀 사본. fixture-builds.ts, service-worker-builds.ts가 쓴다.
- LOCAL_BUILD_IDENTITY: Playwright web server용. Playwright가 env를
process.env 위에 합치므로 CI를 지우지 않고 ""로 덮는다(검사는
CI === "true"일 때만). visual·capabilities·dev 설정이 쓴다.
- assertCiBuildEnvironment의 CI=true 검사는 그대로다. job 자신의 release
빌드(build:release-candidate 등)는 계속 검사된다.
- 버린 대안: 로컬 빌드에 유효한 가짜 커밋 id(0×40)를 주기. CI=true 검사의
다른 칸(CI_RUNNER_IMAGE, SOURCE_DATE_EPOCH)도 함께 맞춰야 하고, 로컬
빌드가 release 빌드인 척한다.
위험·한계
- 로컬 빌드 안에서 CI를 읽어 동작을 바꾸는 코드가 있으면 그 빌드는 이제
CI가 아닌 쪽으로 돈다(지금은 build-environment 검사뿐이다).
검증
- tests/unit/local-build-environment.test.ts 3건: 구현 전 2건 실패(RED),
CI job 자체 검사는 유지.
- CI=true·VITE_COMMIT_SHA·VITE_BUILD_ID=gitea-41-1·RELEASE_ID·
CI_RUNNER_IMAGE·SOURCE_DATE_EPOCH로: service-worker-build-output 7건,
test:visual 6/6, test:unit 2,883, test:component 270, test:integration 189
통과. 수정 전 service-worker-build-output은 7건 미실행.
- check:types, lint 통과.
Refs: docs/reviews/2026-11-03-maturity-review/README.md 13절 11-08
52 lines
1.9 KiB
TypeScript
52 lines
1.9 KiB
TypeScript
import { describe, expect, it } from "vitest";
|
|
|
|
import {
|
|
ciBuildEnvironmentFailures,
|
|
LOCAL_BUILD_IDENTITY,
|
|
localBuildEnvironment,
|
|
} from "../../scripts/lib/build-environment.ts";
|
|
import visualConfig from "../../playwright.visual.config.ts";
|
|
|
|
/**
|
|
* 1103/11-08. The workflow sets CI=true and the CI build identity for every
|
|
* job. A build a test makes of a copy is a local build: it used to inherit
|
|
* CI=true and be checked as a release build. Inside vitest, whose config
|
|
* drops VITE_COMMIT_SHA (11-07), that failed with "missing required CI build
|
|
* environment: VITE_COMMIT_SHA"; the visual goldens' build failed on its
|
|
* local commit id "local".
|
|
*/
|
|
const CI_JOB = Object.freeze({
|
|
CI: "true",
|
|
VITE_BUILD_ID: "gitea-41-1",
|
|
RELEASE_ID: "refs/heads/fix/example-41-1",
|
|
CI_RUNNER_IMAGE: `local/runner@sha256:${"a".repeat(64)}`,
|
|
SOURCE_DATE_EPOCH: "1793700000",
|
|
PATH: "/usr/bin",
|
|
});
|
|
|
|
describe("local build environment (1103/11-08)", () => {
|
|
it("is not checked as a CI build, whatever CI identity the job has", () => {
|
|
const local = localBuildEnvironment(CI_JOB);
|
|
|
|
expect(ciBuildEnvironmentFailures(local)).toEqual([]);
|
|
expect(local).not.toHaveProperty("CI");
|
|
expect(local).not.toHaveProperty("VITE_BUILD_ID");
|
|
expect(local["PATH"]).toBe("/usr/bin");
|
|
});
|
|
|
|
it("keeps a CI job's own release build checked", () => {
|
|
expect(ciBuildEnvironmentFailures(CI_JOB)).toContain(
|
|
"missing required CI build environment: VITE_COMMIT_SHA",
|
|
);
|
|
});
|
|
|
|
it("starts the visual goldens' build as a local build inside a CI job", () => {
|
|
const webServer = visualConfig.webServer;
|
|
const env = Array.isArray(webServer) ? undefined : webServer?.env;
|
|
|
|
// Playwright merges a web server's env over the runner's process.env.
|
|
expect(ciBuildEnvironmentFailures({ ...CI_JOB, ...env })).toEqual([]);
|
|
expect(env).toMatchObject(LOCAL_BUILD_IDENTITY);
|
|
});
|
|
});
|