#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 안 제외, 로그 줄).
#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`).
문제: #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.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
무엇을, 왜
#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과 다른 파일시스템일 가능성이 크다.고른 방법과 버린 대안
scripts/ci/dependency-cache-root.sh "$RUNNER_TEMP" "$(dirname "$GITHUB_WORKSPACE")"를 돈다. 후보 중 checkout과stat -c %d가 같고 checkout 밖인 첫 폴더를 고르고, 없으면 첫 후보를 쓴다./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은 복원만 한다.git status, repo 배치 검사, 산출물에 잡히지 않게)..tmp아래(배치 검사·산출물에 걸림), workspace 부모를 고정 경로로(같은 파일시스템인지 runner마다 다를 수 있다).위험과 영향
no).검증
tests/unit/dependency-cache-root.test.ts: 가짜stat으로 장치를 정해, 같은 파일시스템의 첫 후보 고르기, checkout 안 후보 건너뛰기, 맞는 후보가 없을 때 첫 후보로 떨어지기를 본다(desktop 최대 47ms).CI=true scripts/verify.sh gate: FE-GATE-010 rc=0, FE-GATE-005 rc=0(main9068faf2기준 트리). main 94e9401a(#42) 위로 올린 뒤 다시 생성해도 바뀐 파일 없음, 생성·캐시 폴더·timeout 시험 450개와 check:ci 통과.리뷰어가 볼 곳
scripts/ci/dependency-cache-root.sh(후보 거르기, checkout 안 제외, 로그 줄).scripts/contracts/ci-gates.ts의DEPENDENCY_CACHE(rootCandidates,paths,environmentNames),scripts/generate-ci-workflow.ts의dependency-cache렌더링.관련
w2-fe2-takeover.md).