2026년 Xcode 26 원격 Mac CI: xcodebuild 컴파일 캐시·Derived Data 전략·동시 빌드 성능 저하 SSH 트리아지 의사결정 매트릭스
캐시 히트와 디스크 경합을 분리해서 보세요. 이 글은 원격 Mac CI에서 Xcode 26 / xcodebuild의 캐시 계층, Derived Data 배치 패턴 세 가지, 그리고 동시성이 붙으면 모두가 느려질 때 SSH로 바로 쓸 수 있는 의사결정 매트릭스를 정리합니다.
1. 원격 Xcode 빌드가 “임의로” 빠르거나 느린 이유
무인 SSH 세션에서 xcodebuild는 세 가지 힘이 동시에 작용합니다: 컴파일러 캐시를 재사용할 수 있는지, Derived Data를 어떻게 격리하는지, 한 대에서 동시에 돌아가는 잡이 디스크 대역폭과 열 여유를 두고 싸우는지. 팀은 종종 캐시를 전부 지워 “해결”했다가 증분 빌드를 망가뜨리거나, 하나의 Derived Data 트리를 공유했다가 병렬 쓰기 아래에서 드물게 모듈 캐시가 깨지는 상황을 겪습니다.
한 대의 원격 Mac에 러너나 에이전트를 여러 개 올린다면, 먼저 토폴로지를 맞춘 뒤 캐시를 조정하세요. 패키지·빌드 캐시가 실제 파이프라인과 어떻게 맞물리는지는 2026년 물리적 Mac CI 환경의 성능 일관성 최적화를 참고한 다음, 아래 Derived Data 규칙을 적용하면 됩니다.
2. xcodebuild 캐시: 남길 것 vs. 비울 것
거친 멘탈 모델이 트리아지를 정직하게 유지합니다.
- Clang / 모듈 캐시: 보통 Derived Data와 타깃 산출물 아래에 있습니다. SDK 플래그가 안정적이면 증분 빌드를 위해 유지하는 편이 유리합니다.
- Swift 컴파일러 캐시: 모듈 인터페이스, 최적화 수준, 매크로와 강하게 결합합니다. 브랜치나 Package 해석 변경으로 전체 리빌드가 나오면 “디스크가 느리다”기보다 의존성 그래프가 바뀐 경우가 많습니다.
- 명시적 클린 비용:
xcodebuild clean이나 Derived Data 전체 삭제는 콜드 경로를 강제합니다. 릴리스 열이나 손상 의심에는 좋지만, 모든 PR 잡의 기본값으로는 부적합합니다. 전역 삭제보다 프로젝트별 Derived Data 경로를 선호하세요.
3. Derived Data 전략: 세 가지 패턴
아래 표를 2026년 Xcode 26 CI 런북에 그대로 넣고(마운트 경로는 인프라에 맞게 조정), 운영 규칙과 함께 버전 관리하세요.
| 패턴 | 하는 일 | 장점 | 리스크 |
|---|---|---|---|
| 잡 단위 | 매 실행마다 임시 디렉터리나 고유 하위 경로에 -derivedDataPath |
격리가 가장 강하고 재현성 높음 | 캐시 히트율 낮음, 디스크 쓰기 부담 큼 |
| 저장소·브랜치 풀 | 고정 루트 + 워크스페이스나 브랜치 패밀리별 하위 경로 | 증분과 격리의 균형 | 락 또는 큐 필요 — 동일 트리에 동시 쓰기 금지 |
| 공유 읽기 전용 + 로컬 쓰기 | 시드 캐시는 읽기 전용, 잡은 쓰기 가능한 오버레이 | 콜드 스타트 단축 | 구성 요소 증가, 일관성 검증 필요 |
운영 규칙: 동시성 > 1이면 여러 xcodebuild 프로세스를 동일한 -derivedDataPath에 두지 마세요. 예외는 파일 락, 단일 비행 큐, 타깃 샤딩으로 직렬화할 때뿐입니다. 그렇지 않으면 간헐적 모듈맵 실패나 Swift 타입체크 단계가 “가끔 끝없이” 걸리는 현상이 납니다.
4. 동시 빌드 성능 저하: 흔한 용의자
잡 하나는 빠른데 여러 개를 같이 돌리면 기어다니면, Xcode 메이저 버전 탓하기 전에 아래를 보세요.
- NVMe / SSD 포화: 병렬 컴파일이 랜덤 쓰기를 키우고, 링크와
stat단계가 부풀어 오릅니다. - 열 스로틀링: 소형 Mac은 무거운
xcodebuild두 갈래에서 전력·온도 한계에 자주 닿습니다. - 메모리 압박: 링커와 인덱싱이 RAM을 급격히 씁니다. 압축과 페이징이 시간 프로파일을 들쭉날쭉하게 만듭니다.
- 공유 Derived Data 락 경합: 체감은 “디스크 느림”이지만, 추적하면 한 디렉터리의 재시도에 가깝습니다.
전용 베어메탈 호스트는 가상화를 여러 겹 쌓은 풀보다 지연 변동이 작은 경우가 많습니다. 빌드 SLA를 “같은 박스의 다른 부하”와 함께 짤 때 유용합니다. Windows 워크스테이션에서 원격 Mac으로 iOS 빌드를 붙이는 현장 흐름은 2026년 Windows에서 React Native 개발, iOS 원격 빌드 방법 (Mac 대여 실전)과 같이 큐·캐시 정책을 같은 표에서 비교해 보기 좋습니다.
5. SSH 친화적 관측 명령
GUI 없이도 됩니다. 진단 잡이나 온콜 문서에 잘라 붙여 넣으세요.
- Derived Data가 올라간 마운트에서
df -h: 디스크 부족과 고지연 네트워크 볼륨을 잡습니다. sysctl hw.ncpu와vm_stat: CPU 개수와 페이징 압력을 빠르게 봅니다.- 짧은
powermetrics샘플 또는top -o cpu: 이중xcodebuild부하에서 클럭 하락이 있는지 봅니다. xcodebuild -showBuildTimingSummary: 컴파일·링크·스크립트 단계에 시간을 귀속시켜 네트워크 오해를 줄입니다.
6. SSH 트리아지 매트릭스 (증상 → 가설 → 조치)
| 보이는 현상 | 우선 가설 | 조치 (순서대로) |
|---|---|---|
| 동시성 > 1일 때만 느림 | 디스크 대역폭 또는 공유 Derived Data 경합 | -derivedDataPath 분리, 동시성 상한, 다중 쓰기 디렉터리 없음 확인 |
| 단일 잡 느림 + 페이징 높음 | RAM 부족 또는 링커 스파이크 | 병렬 컴파일 스레드 축소, RAM 증설, 거대 타깃 분할 |
| 없던 모듈·헤더 누락 | 손상된 캐시 또는 병렬 쓰기가 중간 산출물을 덮음 | 잡 단위 클린, 잡 단위 Derived Data, 락 추가 |
| Xcode 업그레이드 직후 첫 빌드만 극도로 느림 | 툴체인·인덱스 재구축 | 시드 캐시 1회 워밍, 콜드·핫 기준선 알림 |
| Run Script 단계가 타임라인 지배 | 스크립트 내부 네트워크·서명·노터리 | 스크립트에 타이밍 로그, 의존성 캐시, 서명·노터리 단계 분리 |
7. 정리: 파이프라인에 정책을 박아 넣기
2026년 원격 Mac CI에서 Xcode 26을 쓴다면 Derived Data 경로 규칙, 풀 클린 시점, 최대 동시성, 디스크 워터마크 알림을 코드로 굳히세요. 장애가 나면 하드웨어나 Xcode를 또 바꾸기 전에, 매트릭스로 “캐시 계층”인지 “리소스 싸움”인지부터 가릅니다. 그래야 p95 빌드 시간이 큐 깊이에 흔들리지 않고 계약 밴드 안에 머뭅니다.
Mac mini라면 이 CI 이야기가 단순해지는 이유
여기서 다룬 xcodebuild, Derived Data, 헤드리스 관측은 macOS가 일급 플랫폼이라는 전제와 잘 맞습니다. 디스크 동작이나 Xcode 툴체인 특이점을 하이퍼바이저가 한 겹 더 해석할 필요가 없습니다. Apple Silicon 통합 메모리는 링커 부하가 몰리는 구간을 다소 완화하고, Mac mini급 기기는 대기 전력이 매우 낮은(대략 4W 수준) 편에 저소음이라 24/7 빌드 노드에 유리합니다.
총소유비용 측면에서는, 이웃 잡 소음이 백분위수에 숨는 “저렴한” 공유 풀보다 감사 가능한 물리 Mac 한 대가 나을 때가 많습니다. Gatekeeper·SIP·FileVault는 범용 호스트에서 겪는 툴체인 오염·악성코드 표면도 줄여 줍니다. 위 캐시 규칙을 예측 가능한 지연과 여유 RAM 위에서 강제하고 싶다면, 2026년 기준 Mac mini M4는 여전히 가성비 출발점 중 하나입니다.
큐 깊이와 메모리 여유에 맞는 구성을 고른 뒤, 정책을 코드로 옮기세요 — 요금과 구성은 홈에서 확인할 수 있습니다.