2026년 단주기 버스트 빌드: GitLab CI 셀프 호스팅 macOS Runner를 클라우드 Mac에 붙일 때의 Shell Executor, 캐시 키와 태그 전략——GitHub Actions와 혼용할 때의 의사결정 매트릭스와 실행 가능한 파라미터 FAQ

단주기 버스트 빌드에서 가장 무서운 것은 둘입니다. 대기열이 짧은 릴리스 창을 밀어버리는 것, 그리고 캐시가 환경을 조용히 오염시키는 것입니다. GitLab Runner를 클라우드 Mac에 등록하고 shell 실행기를 쓰면, 이미 로컬에서 검증한 Xcode·Ruby/CocoaPods·서명 키체인을 그대로 재사용할 수 있어 Docker on Mac이나 SSH 래퍼를 한 겹 덜 쌓습니다. 대신 동일 사용자 홈 아래의 전역 상태는 태그와 캐시 키로 통제해야 합니다. 아래는 운영에서 자주 고치는 파라미터 위주이며, 저장소의 .gitlab-ci.yml에 붙여 바로 시험할 수 있습니다. 원격 캐시와 로컬 디스크 트레이드오프는 2026 단주기 클라우드 Mac CI: 원격 빌드 캐시(DerivedData/Pods/sccache)와 노드 로컬 디스크 비교—콜드 스타트·동기 대역폭·재사용 결정 매트릭스(실행 가능한 파라미터 목록)와 같이 읽으면 키 설계가 빨라집니다.

Shell Executor: 클라우드 Mac에 붙일 만한 때

잡이 주로 xcodebuild·Archive·notary 또는 키체인에 의존하는 스크립트라면, shell이 컨테이너 실행기보다 단순합니다. 경로·권한·(필요 시) GUI 세션이 사람이 로그인해 고치는 것과 같아서요. Runner용으로 별도 macOS 사용자나 최소한 독립 Home을 두고, 사람이 쓰는 데스크톱과 DerivedData를 나누세요. 동시성이 1보다 크면 디스크 IO와 codesign 락 경합으로 꼬리 지연이 커질 수 있습니다.

캐시 키: 빠름과 정확함 둘 다

cache:key:files에는 Gemfile.lock·Podfile.lock·컴파일에 관여하는 Package.resolved를 넣는 편이 안전합니다. Xcode 메이저 업 시에는 MACOS_CI_IMAGE_ID 같은 변수를 prefix에 붙여, 옛 DerivedData가 새 툴체인에 섞이지 않게 하세요. 정책은 pull-push가 메인·고빈도 브랜치에 잘 맞고, 릴리스나 nightly만 전체 push를 열면 오브젝트 스토리지 쓰기 폭주를 줄일 수 있습니다. GitHub Actions 쪽 탄력 풀과 상주 노드 선택은 2026년 단주기 피크 빌드: GitHub Actions 자체 호스팅 macOS Runner는 클라우드 Mac 탄력 풀과 상주 노드 중 무엇을 쓸까? 지연·캐시·대기열 결정 매트릭스(실행 가능한 파라미터 목록)와 짝을 이룹니다.

cache:
  key:
    files:
      - Gemfile.lock
      - Podfile.lock
      - YourApp.xcworkspace/xcshareddata/swiftpm/Package.resolved
    prefix: "${CI_COMMIT_REF_SLUG}-xcode${XCODE_VERSION}"
  paths:
    - .cocoapods/
    - ~/Library/Developer/Xcode/DerivedData/
  policy: pull-push

태그 전략: burst·steady·「클라우드 Mac만」

tags로 mac-burst(탄력 클라우드, 짧은 타임아웃·선점 허용)와 mac-steady(고정 쿼터, 서명·스토어 업로드)를 나눕니다. 기본 파이프라인은 burst만 태우고, 키체인 잠금 해제나 사람이 지켜야 하는 단계는 steady 전용 잡으로 빼서 버스트가 핵심 경로를 밀지 않게 하세요.

GitHub Actions와 혼용: 의사결정 매트릭스(요약)

흔한 이유는 공개는 GitHub, 사내 아티팩트·내부 의존성은 GitLab에 있다는 절입니다. 원칙은 「코드와 시크릿에 더 가까운 쪽이 무거운 잡을 집는다」입니다. GitHub에 이미 익숙한 macOS workflow가 있으면 Actions에 가벼운 검사만 두고, 내부 캐시나 GitLab Registry가 필요한 단계는 셀프 호스팅 Runner로 옮깁니다. 양쪽 모두 캐시를 켤 때는 버킷 prefix와 키를 분리해 이름 충돌을 막으세요.

ios_burst:
  stage: build
  tags: [mac-burst, shell]
  rules:
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
  variables:
    GIT_STRATEGY: fetch
    FASTLANE_OPT_OUT_USAGE: "1"
  script:
    - xcodebuild -version
    - bundle exec fastlane ci_unit