주문부터 첫 아카이브까지

클라우드 Mac을 Xcode 빌드 파이프라인에 연결하기

이 가이드는 요금제 선택, 주문, 연결, 환경 초기화, 첫 archive 및 CI runner 연동을 다룹니다. 순서대로 실행해 먼저 재현 가능한 릴리스 파이프라인을 완성한 다음 동시성과 캐시를 추가하세요.

클라우드 Mac 즉시 대여 구성 및 가격 보기

3개 요금제: 고정 구성
4개: 판매 중인 리전
$20.7/일: 최저 시작 가격

BUILD RUN SHEET 첫 iOS 아카이브

실행 준비

코드 저장소 전용 노드 아카이브 산출물

01
요금제 및 노드 확인구성, 기간, 도시 및 스토리지 확장 옵션 일치 여부 확인
02
Xcode 환경 초기화버전, 명령줄 도구, Git 및 의존성 관리 도구 확인
03
첫 archive 실행scheme, 서명 설정 및 내보내기 매개변수 고정
04
CI runner 등록작업 디렉터리를 격리하고 빌드 후 정리 규칙 설정

SG 싱가포르 JP 도쿄 KR 서울 HK 홍콩

1단계

시작 전에 다섯 가지 입력값부터 확정하세요

실제 제공 속도를 좌우하는 것은 도구를 얼마나 많이 설치했는지가 아니라 계정 권한, 저장소 권한, Xcode 버전, 노드와 대여 기간을 주문 전에 명확히 확정했는지입니다.

개발자 권한

Apple Developer 계정에 대상 팀, 인증서, 프로비저닝 프로파일 및 배포에 필요한 권한이 있는지 확인하세요. archive가 끝난 뒤 서명 접근 범위를 확인하지 마세요.

저장소 접근

최소 권한의 배포 자격 증명을 준비하고 기본 저장소, 비공개 의존성, 서브모듈 및 대용량 파일 저장소를 모두 읽을 수 있는지 확인하세요. CI 전용 자격 증명을 개인 장기 자격 증명과 재사용하지 마세요.

Xcode 버전

프로젝트 요구사항을 주 버전과 빌드 버전까지 정확히 지정하고 Swift, SDK 및 명령줄 도구의 호환성을 확인하세요. runner 버전은 고정하고 임시 전환에 의존하지 마세요.

노드 위치

싱가포르, 도쿄, 서울, 홍콩 중 주요 개발자와 코드 저장소 및 의존성 소스에 가까운 노드를 우선 선택한 뒤 실제 연결 환경으로 검증하세요.

대여 기간

임시 서명 검증은 일간 또는 주간부터 시작할 수 있고, 지속적인 개발과 고정 runner에는 월간 또는 분기 요금제가 더 적합합니다. 실제 빌드 계획에 맞춰 선택하고 근거 없는 사용률을 예상하지 마세요.

2단계

프로젝트 이름이 아니라 작업 부하에 맞춰 구성 선택하기

세 요금제 모두 Apple Silicon 전용 물리 머신이며 가상 머신이 아닙니다. 선택할 때는 병렬 작업 수, 의존성 규모, 캐시 용량 및 통합 메모리 요구사항을 중점적으로 확인하세요.

경량 빌드

Go M4 Core

단일 프로젝트 검증, 임시 서명, 낮은 동시성의 Xcode 빌드 및 전용 환경이 필요한 단기 작업에 적합합니다.

칩: M4
메모리: 16GB
스토리지: 256GB

Go M4 Core 선택

일상 개발

Go M4 Plus

여러 일상 프로젝트, React Native 또는 Flutter 의존성 설치 및 적절한 병렬 처리가 필요한 지속적 통합 큐에 적합합니다.

칩: M4
메모리: 24GB
스토리지: 512GB

Go M4 Plus 선택

고메모리 작업

Go M4 Pro

높은 동시성 빌드, 대규모 의존성 캐시 및 통합 메모리와 로컬 스토리지가 많이 필요한 AI 추론 실험에 적합합니다.

칩: M4 Pro
메모리: 64GB
스토리지: 2TB

Go M4 Pro 선택

3단계

주문 생성 시 네 가지 매개변수를 한 번에 확인하세요

구성 도구는 호스트, 기간, 노드 및 추가 옵션을 하나의 주문으로 통합합니다. 제출 전에 항목별로 대조해 환경 구축 후 데이터 이전을 피하세요.

주문 매개변수 체크리스트 제출 전 확인

HOST

세 가지 기본 구성 중 하나 선택

칩, 메모리 및 시스템 디스크 사양은 구성 카드 기준입니다.

TERM

일간, 주간, 월간 또는 분기 선택

추가 옵션의 기간은 호스트 기간과 일치해야 합니다.

NODE

판매 중인 네 개 노드 중 하나 선택

싱가포르, 도쿄, 서울 및 홍콩을 구성 도구에서 선택할 수 있습니다.

ADD

작업에 맞춰 확장 옵션 추가

+1TB SSD, +2TB SSD 또는 Thunderbolt 5 병렬 연결을 각 장비에 추가할 수 있습니다.

노드 선택

주요 작업 흐름과 가까운 곳을 먼저 선택하세요

원격 데스크톱 경험은 개발자와 노드 사이의 네트워크 경로에 크게 좌우됩니다. 의존성 다운로드 속도는 저장소와 다운로드 소스의 위치에도 영향을 받습니다. 먼저 후보 노드를 선택한 뒤 실제 프로젝트로 테스트하세요.

노드 안내 보기

가용성 안내

콘솔의 실시간 응답을 기준으로 확인하세요

디렉터리의 모든 조합은 주문을 시작할 수 있지만, 주문 생성 시점의 실제 가용 상태는 콘솔이 실시간으로 반환합니다. 페이지 스크린샷으로 현재 상태를 추정하지 마세요.

주문 구성 시작

4단계

그래픽 인터페이스로 먼저 검수한 후 자동화에 연결하세요

제공 정보를 받은 후 먼저 VNC로 데스크톱, 키보드, 네트워크 및 시스템 상태를 확인하세요. 기본 환경이 정상인지 확인한 다음 SSH로 스크립트와 runner 작업을 실행하세요.

연결 01

VNC로 데스크톱 검수 완료

해상도, 키보드 레이아웃, 클립보드, 시간대 및 네트워크 접근을 확인하세요. 첫 검수에서 시스템 설정을 대량으로 변경하지 말아야 문제 발생 시 변수를 쉽게 추적할 수 있습니다.

노드 주소와 연결 시간 기록
데스크톱 세션을 계속 사용할 수 있는지 확인
기본 다운로드 및 저장소 접근 확인

연결 02

SSH로 반복 작업 처리

코드 가져오기, 의존성 설치, 캐시 정리 및 빌드를 반복 가능한 스크립트로 작성하세요. 자격 증명은 최소 권한을 사용하고 로그 및 빌드 산출물과 분리해 저장하세요.

키가 접근할 수 있는 프로젝트 범위 제한
스크립트 진입점과 작업 디렉터리 고정
실패한 명령의 종료 코드와 로그 보관

5단계

개발 환경을 재현 가능한 상태로 초기화하세요

먼저 시스템과 Xcode를 검증한 다음 프로젝트 도구를 설치하세요. 각 단계의 버전 출력을 남겨야 runner에서 환경 차이가 코드 때문인지 호스트 때문인지 판단할 수 있습니다.

환경 확인 명령 ENV-CHECK

$ sw_vers macOS 버전 확인

$ xcodebuild -version Xcode 및 빌드 버전 확인

$ xcode-select -p 명령줄 도구 경로 확인

$ git --version Git 사용 가능 여부 확인

$ fastlane --version 자동화 도구 버전 확인

01
시스템 계정 확인
현재 사용자, 홈 디렉터리, 관리자 권한 및 디스크 마운트 위치를 확인하세요. 프로젝트 디렉터리를 데스크톱이나 임시 다운로드 폴더에 분산하지 마세요.
02
Xcode 최초 실행 완료
대상 Xcode를 열고 필요한 구성 요소 설치를 승인한 뒤 명령줄 도구가 동일한 버전을 가리키는지 확인하세요.
03
프로젝트 의존성 체인 설치
프로젝트 잠금 파일에 따라 패키지 관리자와 의존성을 설치하고 첫 빌드에서 잠긴 버전을 무작정 업그레이드하지 마세요.
04
Fastlane 및 스크립트 진입점 고정
프로젝트 내부 버전 제약을 사용하고 빌드, 테스트, 아카이브 및 배포를 각각 독립적으로 재시도할 수 있는 작업으로 나누세요.

6단계

첫 Xcode 클라우드 빌드에서는 핵심 경로 하나만 검증하세요

첫 번째 목표는 최고 속도가 아니라 깨끗한 디렉터리에서 검증 가능한 산출물을 얻는 것입니다. 저장소 버전, scheme, 서명 및 내보내기 방식을 고정한 뒤 캐시를 최적화하세요.

확정된 버전 가져오기

명확한 브랜치, 태그 또는 커밋 번호를 사용하세요. 서브모듈과 의존성 잠금 파일을 동기화하고 이번 빌드에 해당하는 커밋을 기록하세요.

scheme 확인

먼저 xcodebuild -list 를 사용해 사용 가능한 scheme을 확인하고 대상 scheme이 공유되어 있으며 명령줄 빌드에 적합한지 확인하세요.

서명 자료 확인

인증서, 프로비저닝 프로파일, Bundle Identifier 및 팀 권한을 대조하세요. 서명 비밀번호를 저장소나 일반 빌드 로그에 기록해서는 안 됩니다.

archive 실행

workspace 또는 project, scheme, configuration 및 아카이브 경로를 명확히 지정하고 실패 시 전체 종료 코드와 로그를 보관하세요.

내보낸 산출물 검증

산출물 이름, 버전 번호, 빌드 번호, 서명 결과 및 파일 크기를 확인하고 TestFlight 배포 경로가 수신 가능한지 확인하세요.

성공 기준 동일한 커밋에서 동일한 명령으로 유효한 아카이브를 다시 생성할 수 있음

지금은 최적화하지 않음 동시성, 캐시 적중률 및 증분 빌드 속도

7단계

self-hosted runner가 빌드를 안정적으로 인계하도록 설정하세요

첫 archive가 정상 실행된 후 runner를 등록하세요. 핵심은 '온라인' 상태가 아니라 작업 디렉터리 격리, 명확한 태그, 제한된 프로젝트 권한 및 매 작업 후 복구 가능성입니다.

작업 디렉터리

각 runner에 전용 경로 사용

소스 코드, DerivedData, 의존성 캐시 및 내보낸 산출물을 별도 디렉터리로 관리하세요. 여러 동시 작업이 동일한 아카이브 경로에 쓰지 않도록 하세요.

태그 설계

임시 작업이 아닌 기능을 설명하는 태그 사용

태그에는 노드, Xcode 주 버전 및 부하 등급을 표현할 수 있습니다. 장기 태그에 프로젝트명, 사용자명 또는 단기 브랜치를 포함하지 마세요.

접근 범위

실행에 필요한 프로젝트만 권한 부여

runner가 읽을 수 있는 저장소와 변수 범위를 제한하세요. 프로덕션 서명 자료와 테스트 빌드 권한은 워크플로별로 분리해야 합니다.

정리 규칙

작업 종료 후 민감한 잔여 파일 삭제

임시 자격 증명, 내보내기 구성 및 더 이상 필요하지 않은 산출물을 삭제하세요. 캐시는 디렉터리, 용량 및 수정 시간에 따라 관리하고 무차별적으로 비우지 마세요.

8단계

출시 전에 최종 제공 점검을 완료하세요

아래 항목을 팀 운영 매뉴얼에 포함하세요. 점검을 통과한 후에야 runner가 지속적인 빌드와 TestFlight 배포 작업을 맡기에 적합합니다.

인증서 및 프로비저닝 프로파일

유효 기간, 팀 소속, Bundle Identifier 및 사용 범위를 확인하고 갱신 담당자를 기록하세요.

디스크 여유 공간

소스 코드, DerivedData, 의존성 캐시, 아카이브 및 내보낸 산출물의 사용량을 확인하고 연속 빌드에 필요한 공간을 확보하세요.

캐시 전략

재사용할 수 있는 디렉터리, 만료 시점, 용량 한도 및 정리 조건을 명확히 하세요. 서명 비밀번호와 임시 토큰은 캐시하지 마세요.

TestFlight 경로

아카이브 내보내기부터 업로드 완료까지 엔드투엔드 검증을 한 번 수행하고 버전 번호, 빌드 번호 및 릴리스 로그가 서로 대응하는지 확인하세요.

민감 정보 정리

저장소, 환경 파일, 명령 기록 및 빌드 로그를 확인하고 장기 보관하면 안 되는 키, 토큰 및 서명 비밀번호를 삭제하세요.

실패 에스컬레이션 경로

주문 번호, 노드, 재현 시간, 오류 로그 및 수행한 단계를 기록하세요. 도움이 필요하면 콘솔에서 지원 티켓을 제출하세요.

READY 첫 빌드를 재현할 수 있고 runner 권한이 통제되며 민감 정보가 정리됨

콘솔에서 지원 티켓 제출

준비가 되었다면 전용 노드 한 대부터 시작하세요

구성, 기간 및 노드를 선택하고 먼저 첫 Xcode 아카이브를 완료한 다음 안정적인 명령을 CI 큐에 연결하세요.

클라우드 Mac 즉시 대여 세 가지 요금제 비교