Apple Silicon CI 처리량을 망치는 가장 빠른 방법은 캐시를 Git 브랜치 이름으로 짓는 것이다. 브랜치 키는 Package.resolved, Podfile.lock, Gemfile.lock이 조용히 바뀐 커밋 사이에서도 그래프를 재사용해 “무작위” 빨강과 더 나쁜 팬텀 그린을 만든다. 2026년에는 의존성 캐시를 콘텐츠 주소 저장소처럼 다루라: lockfile을 해시하고 툴체인 빌드 번호를 고정하며, 캐시 미스가 건강한 이유를 정책으로 공유하라.
운영 맥락: 디스크 및 아티팩트 보존, worktree 대 클린 클론, Runner 어피니티. 홍콩, 일본, 한국, 싱가포르, 미국에서 더 격리된 Mac mini M4가 필요하면 가격을 비교하고 SSH/VNC 패턴은 도움말을 따르라.
lockfile 해시가 브랜치 라벨을 이기는 이유
브랜치 라벨은 “이 개발선상의 모든 것이 상태를 공유한다”고 암시한다. 의존성 그래프는 선을 따르지 않고 정확한 해석 결과를 따른다. 한 번의 머지가 애플리케이션 소스를 건드리지 않고도 전이 버전을 올려 바이너리를 무효화할 수 있으나 브랜치 이름은 그대로다. lockfile을 해시하면 캐시 히트는 증명 의무가 된다: 해시가 일치하면 툴체인을 제외하고 리졸버 출력이 동일하다는 증거가 있다.
- 재현성: 감사인은 초록 빌드를 특정 lockfile 다이제스트와 연관지을 수 있다.
- 병렬 PR: 같은 브랜치 이름의 두 PR(fork 워크플로)이 조용히 충돌하지 않는다.
- 디스크 경제: 해시 위 LRU가 “브랜치 폴더 전체 삭제”보다 성장을 더 잘 캡한다.
매트릭스 A: 생태계별 키잉 레시피
| 생태계 | 잠금 입력 | 권장 경로 접미사 |
|---|---|---|
| SwiftPM + Xcode | Package.resolved + Xcode build |
spm/<sha256(resolved)>/xc<build> |
| CocoaPods | Podfile.lock + Ruby 버전 파일 |
pods/<sha256(lock)>/ruby<ver> |
| Bundler | Gemfile.lock |
bundle/<sha256(lock)> |
| npm / pnpm | package-lock.json 또는 pnpm-lock.yaml |
js/<sha256(lock)>/node<major> |
매트릭스 B: 공유 캐시가 여전히 안전하지 않은 경우
lockfile 해싱이 완벽해도 복원 중 post-install 스크립트가 실행되면 구할 수 없다. 스크립트 실행을 샌드박스하고 복원 아티팩트를 검증하지 않는 한 이런 작업은 콜드 경로로 취급하라.
| 신호 | 정책 | 완화 |
|---|---|---|
post_install 훅이 Pods 변경 |
작업 간 복원 공유 금지 | 매 빌드 훅 실행; 다운로드 blob만 캐시 |
| 체크섬 없는 바이너리 Pod | 비신뢰 입력으로 취급 | 저장소에서 콘텐츠 해시로 vendor 고정 |
| Fork PR 빌드 | 별도 캐시 네임스페이스 | 내부 모노레포 캐시 경로 재사용 금지 |
감사를 견디는 수치 기본값
- 해시 알고리즘: 정규화한 lockfile 바이트의 SHA-256(CI에서 CR/LF 차이 제거).
- LRU 폭: 호스트·생태계당 마지막 12개 해시 유지.
- 최대 연령: LRU와 무관하게 14일 히트 없으면 제거.
- 알림: 캐시 볼륨이 전용 CI 디스크의 70%를 넘으면 페이지.
보안 참고: 캐시는 공급망의 일부다. 손상된 lockfile이 공유 tarball 캐시를 오염시킬 수 있다면 맹목적 재사용보다 일시 다운로드+검증을 선호하라.
여덟 롤아웃 단계
- 목록화: 커밋된 lockfile이 없는 저장소—존재할 때까지 캐시 금지.
- 다이제스트 방출: 모든 빌드에 나중 상관을 위한 CI 아티팩트로.
- 캐시 마운트: SPM 해석에는 빠른 APFS 볼륨. 네트워크 공유는 아니다.
- 메트릭 배선: 히트율, 복원 초, 제거 횟수.
- 문서화: CONTRIBUTING.md에 콜드 캐시 기대치.
- Fork 워크플로 명시 테스트—신뢰 등급별 네임스페이스.
- 체크아웃 정책과 짝(worktree 가이드)로 이중 공유 방지.
- 하드웨어 확장: 제거 스래싱 시 NodeMac이 지역별 전용 M4 추가—조달 지연 없음.
FAQ
브랜치 이름 캐시가 팬텀 그린을 일으키는 이유?
lockfile 변경 사이에서 바이너리를 재사용한다. lockfile을 해시해 히트가 리졸버 출력 일치를 의미하게 하라.
SPM과 DerivedData 같은 키?
아니오—관심사 분리. SPM은 해석, DerivedData는 컴파일 인덱스이며 작업 또는 툴체인 차원을 포함한다.
얼마나 자주 정리?
캡 내 LRU와 최대 연령 제거. 항상 디스크 알람과 연동.