ci(gates): 의존성 캐시를 checkout과 같은 파일시스템의 폴더에 둔다 #45

Merged
donghyeon.kang merged 1 commits from donghyeon.kang/ci/dependency-cache-same-filesystem AGit into main 2026-11-13 07:03:39 +00:00
Owner

무엇을, 왜

#41의 merge job 의존성 캐시는 hit해도 설치가 빨라지지 않았다. PR run 230에서 세 job 모두 main이 저장한 항목을 복원했지만(222MB, 4.8초), pnpm 설치는 16.9·26.4·22.4초로 캐시 없는 run(13.8~22.8초)과 같았다. reused 404, downloaded 0 뒤 node_modules에 넣는 데만 15초 넘게 걸렸다.

desktop 재현(같은 lockfile): 같은 파일시스템 2.1초, tar 왕복 뒤 7.6초, store가 다른 파일시스템이면 58.8초(하드링크 대신 복사). store가 job의 /tmp에 있어 checkout과 다른 파일시스템일 가능성이 크다.

고른 방법과 버린 대안

  • merge job의 첫 캐시 단계가 scripts/ci/dependency-cache-root.sh "$RUNNER_TEMP" "$(dirname "$GITHUB_WORKSPACE")"를 돈다. 후보 중 checkout과 stat -c %d가 같고 checkout 밖인 첫 폴더를 고르고, 없으면 첫 후보를 쓴다.
  • 고른 폴더, 견준 장치 번호, job 시작 때의 부하(/proc/loadavg)를 job 로그에 한 줄 남긴다. 예: dependency cache: /…/fe-dependency-cache (on the checkout's filesystem: yes; devices: checkout=… …; load average at job start: …).
  • COREPACK_HOME·PNPM_CONFIG_STORE_DIR·PNPM_CONFIG_CACHE_DIR는 $GITHUB_ENV로 넘긴다(job env 고정값을 뺌). 캐시 경로는 그 단계 출력을 쓴다. 저장은 여전히 main만, PR은 복원만 한다.
  • checkout 안은 후보가 아니다(git status, repo 배치 검사, 산출물에 잡히지 않게).
  • 버린 대안: checkout 안 .tmp 아래(배치 검사·산출물에 걸림), workspace 부모를 고정 경로로(같은 파일시스템인지 runner마다 다를 수 있다).

위험과 영향

  • 고른 폴더가 run마다 다르면 캐시 항목의 경로가 달라 hit하지 않는다(같은 runner 구성에서는 같다). 같은 파일시스템인 후보가 없으면 지금과 같다(로그에 no).
  • 경로가 바뀌어 첫 main run은 새 항목을 저장한다.
  • 다운스트림이 따라 할 일: 없다.

검증

  • 새 시험 tests/unit/dependency-cache-root.test.ts: 가짜 stat으로 장치를 정해, 같은 파일시스템의 첫 후보 고르기, checkout 안 후보 건너뛰기, 맞는 후보가 없을 때 첫 후보로 떨어지기를 본다(desktop 최대 47ms).
  • RED: 생성 시험의 새 기대가 바꾸기 전 생성기에서 실패. GREEN: ci-workflow-generation·dependency-cache-root·test-timeout-declarations·repository-layout 460개 통과(올리기 전). check:ci·check:types·eslint·verify:documentation rc=0.
  • desktop CI=true scripts/verify.sh gate: FE-GATE-010 rc=0, FE-GATE-005 rc=0(main 9068faf2 기준 트리). main 94e9401a(#42) 위로 올린 뒤 다시 생성해도 바뀐 파일 없음, 생성·캐시 폴더·timeout 시험 450개와 check:ci 통과.
  • runner: 병합 뒤 main push run(새 경로로 저장) → 다음 PR run(복원)의 설치 시간과 로그의 장치·부하 줄로 확인한다.

리뷰어가 볼 곳

  • scripts/ci/dependency-cache-root.sh(후보 거르기, checkout 안 제외, 로그 줄).
  • scripts/contracts/ci-gates.ts의 DEPENDENCY_CACHE(rootCandidates, paths, environmentNames), scripts/generate-ci-workflow.ts의 dependency-cache 렌더링.

관련

  • #41(의존성 캐시), run 230 실측(공유 노트 w2-fe2-takeover.md).
## 무엇을, 왜 #41의 merge job 의존성 캐시는 hit해도 설치가 빨라지지 않았다. PR run 230에서 세 job 모두 main이 저장한 항목을 복원했지만(222MB, 4.8초), pnpm 설치는 16.9·26.4·22.4초로 캐시 없는 run(13.8~22.8초)과 같았다. `reused 404, downloaded 0` 뒤 node_modules에 넣는 데만 15초 넘게 걸렸다. desktop 재현(같은 lockfile): 같은 파일시스템 2.1초, tar 왕복 뒤 7.6초, store가 다른 파일시스템이면 58.8초(하드링크 대신 복사). store가 job의 `/tmp`에 있어 checkout과 다른 파일시스템일 가능성이 크다. ## 고른 방법과 버린 대안 - merge job의 첫 캐시 단계가 `scripts/ci/dependency-cache-root.sh "$RUNNER_TEMP" "$(dirname "$GITHUB_WORKSPACE")"`를 돈다. 후보 중 checkout과 `stat -c %d`가 같고 checkout 밖인 첫 폴더를 고르고, 없으면 첫 후보를 쓴다. - 고른 폴더, 견준 장치 번호, job 시작 때의 부하(`/proc/loadavg`)를 job 로그에 한 줄 남긴다. 예: `dependency cache: /…/fe-dependency-cache (on the checkout's filesystem: yes; devices: checkout=… …; load average at job start: …)`. - `COREPACK_HOME`·`PNPM_CONFIG_STORE_DIR`·`PNPM_CONFIG_CACHE_DIR`는 `$GITHUB_ENV`로 넘긴다(job env 고정값을 뺌). 캐시 경로는 그 단계 출력을 쓴다. 저장은 여전히 main만, PR은 복원만 한다. - checkout 안은 후보가 아니다(`git status`, repo 배치 검사, 산출물에 잡히지 않게). - 버린 대안: checkout 안 `.tmp` 아래(배치 검사·산출물에 걸림), workspace 부모를 고정 경로로(같은 파일시스템인지 runner마다 다를 수 있다). ## 위험과 영향 - 고른 폴더가 run마다 다르면 캐시 항목의 경로가 달라 hit하지 않는다(같은 runner 구성에서는 같다). 같은 파일시스템인 후보가 없으면 지금과 같다(로그에 `no`). - 경로가 바뀌어 첫 main run은 새 항목을 저장한다. - 다운스트림이 따라 할 일: 없다. ## 검증 - 새 시험 `tests/unit/dependency-cache-root.test.ts`: 가짜 `stat`으로 장치를 정해, 같은 파일시스템의 첫 후보 고르기, checkout 안 후보 건너뛰기, 맞는 후보가 없을 때 첫 후보로 떨어지기를 본다(desktop 최대 47ms). - RED: 생성 시험의 새 기대가 바꾸기 전 생성기에서 실패. GREEN: ci-workflow-generation·dependency-cache-root·test-timeout-declarations·repository-layout 460개 통과(올리기 전). check:ci·check:types·eslint·verify:documentation rc=0. - desktop `CI=true scripts/verify.sh gate`: FE-GATE-010 rc=0, FE-GATE-005 rc=0(main 9068faf2 기준 트리). main 94e9401a(#42) 위로 올린 뒤 다시 생성해도 바뀐 파일 없음, 생성·캐시 폴더·timeout 시험 450개와 check:ci 통과. - runner: 병합 뒤 main push run(새 경로로 저장) → 다음 PR run(복원)의 설치 시간과 로그의 장치·부하 줄로 확인한다. ## 리뷰어가 볼 곳 - `scripts/ci/dependency-cache-root.sh`(후보 거르기, checkout 안 제외, 로그 줄). - `scripts/contracts/ci-gates.ts`의 `DEPENDENCY_CACHE`(`rootCandidates`, `paths`, `environmentNames`), `scripts/generate-ci-workflow.ts`의 `dependency-cache` 렌더링. ## 관련 - #41(의존성 캐시), run 230 실측(공유 노트 `w2-fe2-takeover.md`).
donghyeon.kang added 1 commit 2026-11-13 05:06:19 +00:00
ci(gates): 의존성 캐시를 checkout과 같은 파일시스템의 폴더에 둔다
frontend-quality-gates / merge / static checks (pull_request) Successful in 1m56s
frontend-quality-gates / merge / tests (pull_request) Successful in 15m58s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 6m15s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (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 / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (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-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
f21ea48911
문제: #41의 merge job 캐시는 hit해도 설치가 빨라지지 않았다. PR run
230에서 세 job 모두 복원했지만(222MB, 4.8초) pnpm 설치는 16.9·26.4·22.4초로
캐시 없는 run(13.8~22.8초)과 같았다. `reused 404, downloaded 0` 뒤 node_modules에
넣는 데만 15초 넘게 걸렸다. desktop 재현: 같은 파일시스템 2.1초, tar 왕복 뒤
7.6초, store가 다른 파일시스템이면 58.8초(하드링크 대신 복사). store가 job의
`/tmp`에 있어 checkout과 다른 파일시스템일 가능성이 크다.

고친 것(권하는 안으로 정함, 총괄): merge job의 첫 캐시 단계가
`scripts/ci/dependency-cache-root.sh "$RUNNER_TEMP" "$(dirname "$GITHUB_WORKSPACE")"`
를 돈다. 후보 중 checkout과 `stat -c %d`가 같고 checkout 밖인 첫 폴더를 고르고,
없으면 첫 후보를 쓴다. 고른 폴더, 견준 장치 번호, job 시작 때의 부하를 한
줄로 로그에 남기고, `COREPACK_HOME`·`PNPM_CONFIG_STORE_DIR`·
`PNPM_CONFIG_CACHE_DIR`를 `$GITHUB_ENV`로 넘긴다(job env 고정값을 뺌). 캐시
경로는 그 단계 출력을 쓴다. checkout 안은 후보가 아니다(`git status`, repo
배치 검사, 산출물에 잡히지 않게).

버린 대안: checkout 안 `.tmp` 아래(배치 검사·산출물에 걸림), workspace 부모를
고정 경로로(파일시스템이 같은지 runner마다 다를 수 있다).

위험·한계: 고른 폴더가 run마다 다르면 캐시 항목의 경로가 달라 hit하지 않는다
(같은 runner에서는 같다). 같은 파일시스템이 없으면 지금과 같다. runner에서의
효과는 main 저장 → 다음 PR 복원으로 잰다.

검증(desktop): 새 시험 `tests/unit/dependency-cache-root.test.ts`(가짜
`stat`으로 같은 파일시스템 고르기·checkout 안 제외·대체 경로) 통과, 최대
47ms. 생성 시험은 바꾸기 전 생성기에서 실패(RED), 고친 뒤
ci-workflow-generation·test-timeout-declarations·repository-layout 등 460개
통과. check:ci·check:types·eslint·verify:documentation rc=0.
donghyeon.kang merged commit b5932514c0 into main 2026-11-13 07:03:39 +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#45