01

기기와 노드 선택

프로젝트의 메모리와 저장 공간 요구 사항에 맞춰 판매 중인 구성을 고른 다음, 팀 위치와 협업 시간대에 맞는 노드를 선택하세요. 제공 범위를 확인한 후 주문을 진행하세요.

예시 약 1분
02

주문 완료

대여 기간과 선택 가능한 추가 옵션을 확인한 뒤 주문을 제출하세요. 이용 가능 여부와 실제 결제 게이트웨이는 콘솔에 표시되는 실시간 정보를 기준으로 합니다.

예시 약 1분
03

연결 정보 확인

기기 상태가 준비 완료로 바뀌면 콘솔에서 해당 인스턴스에 할당된 주소, 계정, 연결 안내를 확인하세요. 공개된 예시의 인증 정보를 복사해 사용하지 마세요.

예시 약 1분
04

첫 로그인 및 환경 확인

연결한 뒤 현재 계정, 디스크 공간, Xcode 도구 체인 버전을 확인하세요. 조건이 맞지 않으면 자동 작업을 중지하고 출력을 기록하세요.

예시 약 1분

연결 및 명령어 · 민감 정보 제거 예시

먼저 노드에 연결한 다음 빌드를 확인하세요.

SSH는 코드 체크아웃, 빌드 실행, 로그 확인에 적합합니다. Xcode 그래픽 인터페이스를 사용하려면 인스턴스에 제공된 원격 데스크톱 연결 안내를 따르세요.

첫 빌드 · 출력 예시

$ ssh developer@192.0.2.10
Last login: example session
$ xcodebuild -version
Xcode
Build version: example
$ xcodebuild -workspace App.xcworkspace \
  -scheme App -configuration Release \
  -destination 'generic/platform=iOS' build
** BUILD SUCCEEDED **
$ fastlane build
[example] Build completed
[example] Artifact: ./build/App.ipa

실행 전에 항목별로 바꾸세요

주소 및 계정: 예시 주소로는 연결할 수 없습니다. 현재 인스턴스에 대해 콘솔이 제공한 정보만 사용하세요.
프로젝트 및 Scheme: 명령어의 프로젝트 파일과 Scheme을 저장소에서 사용하는 이름으로 바꾸고 대상 플랫폼을 확인하세요.
성공 기준: 종료 코드, 빌드 로그, 결과물 파일을 모두 확인하세요. 예시 출력은 프로젝트의 실제 실행 기록이 아닙니다.

SSH 및 원격 데스크톱 연결 가이드 보기 →

로컬에서 클라우드로

옮길 것은 프로젝트 파일만이 아니라 재현 가능한 작업 흐름입니다.

로컬 Mac에서 클라우드 Mac으로: 소스 코드와 의존성을 사용할 수 있게 준비하고, 도구 체인을 확인한 뒤 CI 작업을 새 실행 노드로 지정하세요.

01 / 데이터

프로젝트와 필요한 파일 옮기기

가능하면 버전 관리 저장소에서 코드를 체크아웃하고, 저장소에 포함되지 않은 설정 파일과 빌드 리소스를 하나씩 확인하세요. 전송 전에 민감한 자료를 점검해 인증 정보가 저장소나 로그에 남지 않도록 하세요.

완료 확인: 클라우드 디렉터리에 필요한 프로젝트 파일이 있고 민감한 파일의 접근 범위를 확인했습니다.

02 / 환경

Xcode 및 의존성 확인

로컬에서 사용하는 Xcode, 명령줄 도구, 패키지 관리 의존성의 버전을 기록하세요. 클라우드에서 의존성을 다시 확인하고 프로젝트의 최소 OS 및 아키텍처 요구 사항과 비교하세요.

완료 확인: 같은 Scheme으로 명령줄 빌드를 시작할 수 있고 버전 차이를 기록했습니다.

03 / 자동화

CI Runner 연동

새 노드에 별도의 Runner ID와 작업 태그를 설정하세요. 먼저 배포 인증 정보가 필요 없는 검증 작업을 실행한 다음 패키징에 필요한 권한을 확인하세요.

완료 확인: 테스트 작업이 지정한 노드에서 실행되고 로그와 결과물을 추적할 수 있습니다.

Xcode 클라우드 빌드

첫 빌드를 확인 가능한 기준점으로 만드세요.

먼저 전체 빌드를 수동으로 한 번 완료하고 버전, 명령어, 오류 출력을 보관한 다음 자동 작업에 맡길지 결정하세요. 서명과 의존성 요구 사항은 프로젝트별로 설정해야 합니다.

프로젝트 체크아웃

팀에서 승인한 방법으로 저장소를 가져와 대상 커밋, 서브모듈, 잠금 파일을 확인하세요. 먼저 git status를 실행해 알 수 없는 변경 사항을 기준으로 빌드 결과를 판단하지 않도록 하세요.

서명 자료 보호

인증서, 프로비저닝 프로파일, 필요한 키를 누가 관리하고 읽을 수 있는지 정하세요. 개인 키를 공개 저장소에 올리거나 전체 인증 정보를 문제 티켓에 붙여 넣지 마세요.

빌드 실행

먼저 xcodebuild -version 과 프로젝트 Scheme을 확인한 다음 프로젝트에서 실제 사용하는 빌드 명령어를 실행하세요. 로그 끝부분만 발췌하지 말고 종료 코드와 처음 발생한 유효한 오류를 기록하세요.

결과물 확인

결과물 파일, 크기, 생성 경로를 확인하고 팀 절차에 따라 보관하거나 옮기세요. 빌드 성공 메시지만으로 실제 파일과 서명 결과 확인을 대신할 수 없습니다.

CI/CD 연동

Runner를 검증한 뒤 자동 패키징을 시작하세요.

GitLab CI macOS Runner를 연동하려면 노드에 Runner를 설치하고 등록한 뒤 권한이 있는 프로젝트에 연결하고 작업 태그로 작업 실행 위치를 제한해야 합니다. 등록 방식, 접근 범위, 동시 실행 설정은 팀의 CI 관리 정책을 따르세요.

첫 검증 작업에서는 시스템 및 Xcode 버전만 출력해도 됩니다. 이를 통해 작업이 지정한 Apple Silicon 노드에 도달했는지는 확인할 수 있지만 서명, 의존성 다운로드, 배포 단계까지 사용할 수 있다는 뜻은 아닙니다.

패키징 전 권한 점검

Runner ID: 등록 범위, 실행 계정, 작업 태그를 확인해 다른 노드가 작업을 가져가지 않도록 하세요.
프로젝트 접근: 실행 계정으로 저장소, 서브모듈, 비공개 의존성에 접근할 수 있는지 확인하세요.
서명 자료 접근: 패키징에 필요한 작업에만 필요한 자료를 제공하세요. 로그에 민감한 값이 출력되지 않는지도 확인하세요.
결과물 위치: 전체 패키징 작업을 실행하기 전에 보관 디렉터리, 읽기 권한, 정리 담당을 정하세요.

fastlane은 기존 패키징 과정의 일부로 사용할 수 있지만 프로젝트별 권한, 서명, 버전 확인을 대신하지는 않습니다.

주문 및 청구

대여 조건과 실행 작업을 따로 확인하세요.

주문 전에 기기, 노드, 일·주·월·분기 단위 대여 기간, SSD 확장 또는 Thunderbolt 5 병렬 연결 필요 여부를 확인하세요. 추가 옵션은 항목별로 요금이 부과되며 최종 선택 및 금액은 주문 확인 내용이 기준입니다.

USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원하며 모든 결제는 USD로 처리됩니다. 실제 이용 가능한 게이트웨이는 콘솔에 표시되는 정보를 기준으로 합니다.

요금제 및 가격 모두 보기

기존 주문에서 확인할 항목

콘솔에서 주문 ID, 대여 기간, 노드, 추가 옵션, 기기 상태를 확인하세요. 기존 주문의 청구 관련 문의는 로그인 후 지원 티켓을 제출하고 주문 ID와 확인이 필요한 항목을 적으세요. 공개 메시지에 결제 정보를 보내지 마세요.

콘솔로 이동

문제 해결

먼저 어느 단계에서 실패했는지 확인하세요.

팀에 문의하기 전에 발생 시각, 인스턴스의 주문 ID, 실행한 작업, 민감 정보를 제거한 오류 내용을 기록하세요. 비밀번호, 개인 키, 서명 인증서, 가리지 않은 프로젝트 자료는 보내지 마세요.

연결할 수 없음

먼저 콘솔에서 기기 상태, 주소, 계정을 확인한 다음 로컬 네트워크와 연결 방식을 점검하세요. 연결 명령어, 오류 유형, 발생 시각을 기록하고 인증 정보는 가리세요.

빌드 실패

커밋 버전, Xcode 버전, Scheme, 전체 명령어, 처음 발생한 유효한 오류를 기록하세요. 의존성 다운로드, 컴파일, 서명, 내보내기 단계 중 어디에서 실패했는지 구분하고 “빌드 실패”라는 마지막 줄만 보내지 마세요.

디스크 공간 부족

프로젝트 디렉터리, 빌드 캐시, 결과물의 디스크 사용량을 확인하고 팀에서 안전하게 정리할 수 있는 파일을 먼저 파악하세요. 민감 정보를 제거한 공간 사용량과 오류 경로를 첨부해 보관할 결과물을 실수로 삭제하지 않도록 하세요.

접근 권한 오류

현재 실행 계정, 파일 소유권, 저장소 또는 서명 자료의 권한 범위를 확인하세요. 영향을 받은 경로와 오류를 기록하고 모든 파일의 권한을 넓혀 문제를 우회하지 마세요.

지원팀 연락 방법 보기 자주 묻는 질문 보기

시작할 준비가 되셨나요?

노드를 선택하고 다음 빌드에 사용할 환경을 정하세요.

세 가지 기기 등급과 대여 기간을 확인한 뒤 콘솔에서 실시간 이용 조건을 확인하세요. 연결 후 재현 가능한 검증 빌드부터 시작하세요.

클라우드 Mac 대여하기 대여 옵션 확인

클라우드 Mac을 주문하고 첫 빌드 결과물을 받기까지.

지금 멈춘 단계부터 시작하세요.

주문 및 시작

원격 연결

빌드 도구 체인

CI 연동

청구 관리

네 단계로 첫 로그인까지.

기기와 노드 선택

주문 완료

연결 정보 확인

첫 로그인 및 환경 확인