클라우드 Mac에서 Xcode CI/CD 실행: GitHub Actions 및 Jenkins 실전 가이드

Apple 툴체인이 macOS 하드웨어에 묶여 있는 이유

Android는 Linux 컨테이너에서 Gradle을 실행할 수 있는 것과 달리, iOS와 macOS 배포 파이프라인은 xcodebuild、codesign、notarytool、App Store Connect API—— 모두 Apple이 서명한 운영체제와 칩에서 실행되어야 합니다. 「시뮬레이터만 설치하면 우회할 수 있다」는 문제가 아닙니다: Archive와 App Store 배포 인증서 체인, Apple Silicon에 최적화된 Swift 컴파일러 경로는 모두 실제 Mac이 있다고 가정합니다.

따라서 iOS 제품이 있는 모든 팀은 결국 같은 질문에 답해야 합니다: 누가 이 Mac을 장기적으로 제공할 것인가? 일반적인 세 가지 방법 — GitHub 호스팅 macOS Runner, 사무실 자체 구매 Mac mini, 클라우드 전용 물리 서버 — 절대적 우열은 없으며, 대기 시간 허용도, 월간 빌드 빈도, 시스템 및 인증서 전담 유지보수 인력 여부에 따라 달라집니다. 본문은 세 번째 방법의 기술 구현에 집중하지만, 먼저 다른 두 방법의 한계를 판단하는 데 도움을 드립니다.

CI 소요 시간 분석: 대기, 컴파일, 서명 각각 비중

많은 팀이 「CI가 너무 느리다」고 불평하지만 총 소요 시간을 세 단계로 나누지 않습니다: 머신 대기, 로컬 컴파일 및 링크, 서명 및 업로드. 동일 commit에서 GitHub 호스팅 macos-14 Runner 와 ZovCloud M4 전용 노드를 비교하여 참고할 만한 수치를 얻었습니다.

호스팅 Runner는 피크 시간대(UTC 13:00–17:00) 평균 22분 대기 후 job 실행 시작; 실제 xcodebuild archive 소요 5분 38초. 전용 M4 노드는 대기 없음, Archive 전체 빌드 3분 58초 — Swift 병렬 컴파일이 10코어 M4에서 구형 Intel CI 머신보다 빠름, 16 GB 통합 메모리는 clean build 시 swap 미발생.

push 후 30분 뒤에야 컴파일 결과를 알 수 있다면, 병목은 Xcode 자체보다 대기열에 있을 가능성이 큽니다. Runner를 항상 온라인인 전용 Mac에 고정하는 것이 피드백 루프를 줄이는 가장 직접적인 방법 — 아래 3절부터 이 머신을 재현 가능한 빌드 기준선으로 준비하는 방법을 설명합니다.

클라우드 Mac에서 재현 가능한 Xcode 빌드 기준선 구축

ZovCloud가 제공하는 Mac mini는 완전한 macOS가 사전 설치되어 관리자 권한이 부여됩니다. 개통 후 SSH 또는 브라우저 VNC로 로그인하고, 인증서와 프로비저닝 프로파일을 고정 디렉터리 규칙으로 보관하여 Runner 스크립트마다 경로를 찾지 않도록 권장합니다. 다음 4단계는 새 노드 초기화 시 매번 수행하는 표준 체크리스트입니다.

1. 01
   Xcode 설치 및 라이선스 동의

   App Store에서 Xcode 16.x 설치, sudo xcodebuild -license accept 및 xcodebuild -runFirstLaunch 실행. 검증: xcodebuild -version 예상 버전 출력; xcode-select -p가 /Applications/Xcode.app/Contents/Developer를 가리킴.

2. 02
   Distribution 인증서 및 프로비저닝 프로파일 가져오기

   .p12를 보안 채널로 ~/certs/에 배치, security import로 전용 키체인 ~/Library/Keychains/ci.keychain-db에 저장; .mobileprovision은 ~/Library/MobileDevice/Provisioning Profiles/에 배치. 무인 빌드 시 팝업 방지를 위해 codesign 파티션 리스트 신뢰 설정.

3. 03
   App Store Connect API Key 구성

   Apple Developer에서 API Key 생성, AuthKey_XXXXXX.p8를 ~/private_keys/에 저장. TestFlight 업로드 시 xcrun altool 또는 Fastlane pilot upload 사용, 대화형 Apple ID 2FA 완전 우회.

4. 04
   첫 전체 Archive 및 DerivedData 보존

   저장소 클론 후 로컬에서 Release Archive 1회 실행, 서명 체인 오류 없음 확인. 256 GB 시스템 디스크는 중형 프로젝트에 충분; DerivedData 보존 시 후속 증분 빌드 약 30–45% 시간 절약. Swift Package 의존성이 많으면 -clonedSourcePackagesDirPath 캐시 디렉터리 지정.

GitHub Actions 자체 호스팅 Runner 등록 및 workflow 라우팅

자체 호스팅 Runner 등록 완료 후 workflow가 label로 job을 이 클라우드 Mac에 정확히 배치, 공용 풀 완전 우회. 경로: 저장소 Settings → Actions → Runners → New self-hosted runner, macOS ARM64 선택, 페이지 안내에 따라 actions-runner 패키지 다운로드 후 실행:

./config.sh --url https://github.com/YOUR_ORG/YOUR_REPO --token RUNNER_TOKEN --labels macos-m4,zovcloud,ios-build --unattended

등록 성공 후 시스템 서비스로 설치, 노드 재시작 후 Runner 자동 온라인 보장: sudo ./svc.sh install → sudo ./svc.sh start。 workflow YAML에서 label 지정:

runs-on: [self-hosted, macos-m4]

일반적인 iOS job 단계: 코드 체크아웃 → CI 키체인 잠금 해제 → xcodebuild archive → xcodebuild -exportArchive → Fastlane upload_to_testflight 또는 altool --upload-app. M4 노드에서 push 트리거부터 TestFlight 처리 완료(Apple 측 대기 포함)까지 평균 약 10분, 로컬 빌드 및 업로드는 5–6분만 소요.

Jenkins Agent 마운트 및 파이프라인 요점

팀에 Jenkins 컨트롤러(Linux에서 실행 가능)가 있으면 macOS 빌드 기능은 Agent 노드로 연결. 클라우드 Mac에 JDK 17 설치, agent.jar 다운로드, LaunchDaemon으로 상시 실행, 컨트롤러가 SSH 또는 JNLP로 빌드 작업 배포.

Jenkins 장점은 시각적 파이프라인과 플러그인 생태계: Credentials Binding으로 키체인 비밀번호 주입, AnsiColor 로그 색상, 빌드 산출물 Artifactory 아카이브 등. 일반적인 Pipeline은 stage('Archive')에서 sh 'xcodebuild ...' 호출, stage('Upload')에서 Fastlane 호출. GitHub Actions 대비 Jenkins는 다중 브랜치, 다중 환경, 수동 승인 게이트가 필요한 기업 내부 프로세스에 더 적합.

클라우드 Mac 일 단위 임대를 「탄력적 Agent」로 활용: 릴리스 주간 노드 개통 후 Jenkins 마운트, 비수기 해제, 연중 365일 서버실 Mac 유지보수 불필요. DEVELOPER_DIR 고정으로 다중 Xcode 버전 전환 혼란 방지는 Jenkins 환경에서 가장 간과되는 안정성 요소.

Archive → Export → TestFlight 명령줄 폐루프

GitHub Actions든 Jenkins든 최종 산출물 체인은 동일: Archive로 .xcarchive 생성 → Export로 .ipa 생성 → App Store Connect 업로드. 명령줄 방식이 CI 표준이며 Xcode GUI에 의존하지 않습니다.

Archive 예시(Release, scheme 지정):

xcodebuild archive -workspace MyApp.xcworkspace -scheme MyApp -configuration Release -archivePath build/MyApp.xcarchive CODE_SIGN_STYLE=Manual PROVISIONING_PROFILE_SPECIFIER="MyApp AppStore"

Export는 ExportOptions.plist 필요(method를 app-store로 설정):

xcodebuild -exportArchive -archivePath build/MyApp.xcarchive -exportPath build/export -exportOptionsPlist ExportOptions.plist

TestFlight 업로드(API Key 방식, 무인 운영에 적합):

xcrun altool --upload-app -f build/export/MyApp.ipa -t ios --apiKey KEY_ID --apiIssuer ISSUER_ID

M4 10코어 CPU는 Swift 병렬 컴파일이 구형 Intel CI 머신보다 현저히 빠름; Swift Package 의존성이 많은 프로젝트는 workflow에서 캐시 권장 ~/Library/Developer/Xcode/DerivedData 및 SourcePackages 디렉터리, 두 번째 빌드부터 소요 시간 약 1/3 추가 단축.

무인 환경에서 키체인 및 서명 문제 해결

SSH 또는 헤드리스 Runner에서 codesign 실패는 대부분 인증서 만료가 아닌 키체인 문제. 빌드 스크립트 시작 부분에 잠금 해제 및 권한 부여 고정 실행 권장:

security unlock-keychain -p "$KEYCHAIN_PASSWORD" ~/Library/Keychains/ci.keychain-db

security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k "$KEYCHAIN_PASSWORD" ~/Library/Keychains/ci.keychain-db

비밀번호는 GitHub Secrets 또는 Jenkins Credentials로 주입, 저장소에 평문 저장 금지. errSecInternalComponent 오류 시 키체인 기본 설정 및 codesign 신뢰 목록 추가 여부 확인. altool 업로드가 인증에서 멈추면 API Key Issuer ID와 .p8 파일명 일치 및 Key 「Developer」 권한 유지 여부 확인.

또 다른 흔한 함정은 Provisioning Profile과 Bundle ID 불일치 — Archive 단계에서는 오류 없이, Export 단계에서 실패. CI에 security cms -D -i profile.mobileprovision로 UUID 출력 단계 추가 권장, Xcode 프로젝트의 PROVISIONING_PROFILE_SPECIFIER와 교차 확인.

탄력적 macOS 빌드 연산: Runner를 클라우드 전용 노드에 둘 시점

독립 개발자와 소규모 팀은 딜레마에 빠지기 쉽습니다: macOS 빌드가 필요하지만 CI 머신 하나를 위해 사무실 임대, 전용선, 정전·시스템 업그레이드 처리를 원하지 않음. 퍼블릭 클라우드 Linux VM은 불가(완전한 macOS와 Apple 서명 체인 없음); 집에 Mac mini를 두면 업로드 대역폭 불안정, IP 변경, 실수로 전원 끄기 등 위험.

ZovCloud는 전용 물리 Mac mini M4 제공: 가상화 없음, 오버셀 없음, 각 머신 16 GB 메모리 및 1 Gbps 전용 대역폭, 결제 후 1–5분 자동 개통. 5개 지역 노드 — 싱가포르, 일본, 한국, 홍콩, 미국 동부 — 사용자 분포에 따라 선택; 일본 시장 대상 앱은 도쿄 노드 선택, TestFlight 업로드 시 국경 간 지연 단축.

일 $19.8부터, 주 $53.5, 월 $99.1 과금, 장기 계약 없음. 릴리스 집중 주간에 노드 개통 후 Runner 마운트, 일상 유지보수 기간 해제, 연중 자체 구매+전기비보다 경제적인 경우가 많음. 다중 Archive 병렬 필요 시 Thunderbolt 5 클러스터링으로 80 Gbps 클러스터 구성, 대형 monorepo 또는 다중 App 매트릭스에 적합.

1. 01
   ZovCloud에서 노드 선택 및 개통

   콘솔 로그인 후 지역·임대 기간 선택, 결제 후 SSH 자격 증명 및 VNC 접속 정보 자동 발급. 접속 튜토리얼은 도움말 센터 참조.

2. 02
   3절에 따라 Xcode 및 서명 기준선 완료

   키체인 경로, API Key 경로를 환경 변수에 기록, GitHub Actions / Jenkins가 통일 참조.

3. 03
   Runner 등록 및 첫 pipeline 실행

   먼저 Debug 빌드로 컴파일 검증, 이후 Release Archive + TestFlight 전환, Fastlane lane을 저장소에 고정.

iOS CI/CD의 문턱은 Xcode 메뉴바가 아니라 안정적이고 예측 가능한 macOS 연산력 + 단일 신뢰할 수 있는 서명 환경에 있습니다. 공용 Runner는 저빈도 빌드에 적합; 자체 서버실은 운영 역량이 있는 성숙 팀에 적합; 클라우드 전용 Mac은 「대기 싫고, 머신 사기도 싫은」 중간 지대를 채웁니다. 컴파일을 클라우드로 옮기면 로컬 MacBook은 코드 작성에 집중하고, 심야에 CI 작업이 팬과 메모리를 빼앗지 않습니다.