문제별 다음 단계 찾기

클라우드 Mac 사용 가이드

먼저 주문 내역의 모델과 물리 노드를 확인한 다음 데스크톱 연결, 개발 툴체인 또는 빌드 작업을 진행하세요. 이 가이드는 점검 순서를 안내합니다. 연결 매개변수와 실제 이용 가능 여부는 콘솔에 표시되는 제공 정보를 기준으로 확인하세요.

SESSION / 01 첫 사용 점검 순서
01
주문

모델, 결제 주기, 선택한 추가 옵션을 확인하세요.

먼저 확인
02
노드

주문 내역과 제공 정보의 물리 노드를 대조하세요.

다음 확인
03
세션

실제 제공된 방식에 맞게 원격 데스크톱 클라이언트를 설정하세요.

그다음 연결

이 목록에는 연결 주소나 인증 정보가 표시되지 않습니다. 로그인한 뒤 본인의 제공 정보를 확인하세요.

첫 사용

연결 전에 세 가지를 순서대로 확인하세요

대여하신 장비는 전용 물리 Mac입니다. 범용 이미지 설정을 그대로 적용할 수 있는 가상 머신이 아닙니다. 먼저 주문 내역과 제공 정보를 대조한 뒤 클라이언트를 설정하세요.

01주문 확인

콘솔에서 주문한 모델, 일·주·월·분기 결제 주기, 추가 옵션을 확인하세요. 주문 내용이 예상과 다르면 선택 내역부터 확인하고, 모델명만으로 하드웨어나 요금을 추측하지 마세요.

02물리 노드 확인

제공 정보에 표시된 노드와 주문 시 선택한 항목을 대조하세요. 이용 가능한 지역은 싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 서부입니다. 현재 이용 가능 여부는 콘솔의 실시간 정보를 확인하세요.

03연결 조건 준비

로컬 네트워크가 안정적인지 확인하고, 제공된 연결 방식에 맞는 원격 데스크톱 클라이언트를 준비하세요. 로그인 후 실제 연결 매개변수를 확인하고, 주소나 인증 정보를 공개 문의에 붙여 넣지 마세요.

연결 조건 점검

먼저 로컬 네트워크에서 필요한 서비스에 정상적으로 접속할 수 있는지 확인한 다음 클라이언트 설정과 제공 정보가 일치하는지 살펴보세요. 화면은 보이지만 입력이 되지 않는다면 화면, 키보드, 마우스의 증상을 각각 기록하세요. 확인 없이 연결 매개변수를 변경하지 마세요.

문제가 계속되나요?

선택한 노드, 클라이언트 유형, 발생 시각, 화면에 나타난 내용, 시도한 조치를 기록하세요. 로그인 후 콘솔에서 티켓을 제출할 수 있습니다. 전체 절차는 원격 데스크톱 연결 가이드에서도 확인하세요.

원격 데스크톱 연결 가이드 보기
개발 환경

프로젝트 요구 사항을 클라우드 Mac에 그대로 적용하세요

먼저 필요한 항목을 정리한 뒤 환경을 재현하세요. 프로젝트에 필요한 도구, 플러그인, 특정 버전이 모두 설치되어 있다고 가정하지 말고, 실제 장비 환경과 프로젝트 문서를 기준으로 확인하세요.

ENV / 01

시스템 및 Xcode

프로젝트에서 요구하는 macOS와 Xcode 버전, SDK, 명령줄 도구를 정리하세요. 연결 후 실제 버전을 확인하고 툴체인을 조정할지 결정한 다음, 최소한의 빌드로 먼저 검증하세요.

확인 기준: 프로젝트 설정, 팀 빌드 문서, 장비의 실제 버전

ENV / 02

의존성 및 로컬 설정

패키지 관리자 목록, 잠금 파일, 런타임 버전, 환경 변수 이름을 정리하세요. 클라우드 Mac에 항목별로 설치하고 테스트를 실행하세요. 토큰, 개인 키, 개인 경로가 포함될 수 있는 로컬 설정을 통째로 복사하지 마세요.

확인 기준: 의존성 잠금 파일, 환경 안내, 테스트 결과

ENV / 03

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

서명 ID, 프로비저닝 프로파일, 프로젝트 대상 설정, 팀 접근 권한을 각각 확인하세요. 팀에서 승인한 안전한 방법으로만 자료를 전달하고, 검증 후 임시 파일이 저장된 위치를 확인하세요.

확인 기준: 프로젝트 서명 설정, 자료 유효성, 접근 권한

이전 과정에서 검증 단계 유지

의존성을 한 그룹씩 설치할 때마다 해당 빌드 또는 테스트 명령을 실행하고 오류 내용을 저장하세요. 설정을 한꺼번에 옮긴 뒤 실패 원인을 찾는 것보다 문제를 훨씬 쉽게 추적할 수 있습니다.

CI/CD

검증 가능한 빌드 환경에서 runner 실행하기

self-hosted runner를 연동하기 전에 작업을 실행할 수 있는 사람, 작업에서 읽을 수 있는 항목, 빌드 실패 시 로그를 확인할 위치를 정하세요. 데스크톱에서 수동 빌드에 성공해도 자동 작업에 동일한 권한이 있다고 볼 수는 없습니다.

ACCESS

계정 권한 제한

runner를 등록하는 계정, 저장소 또는 프로젝트의 접근 범위, 작업 실행 조건을 확인하세요. 일상적인 원격 데스크톱 계정과 자동 작업에 필요한 권한을 구분하고, 문제 해결을 위해 접근 범위를 무작정 넓히지 마세요.

BUILD

툴체인 고정 후 테스트 실행

Xcode, 명령줄 도구, 프로젝트 의존성, 작업 디렉터리를 확인하세요. 재현 가능한 최소 작업부터 실행해 종료 상태, 빌드 로그, 산출물 경로를 점검한 뒤 전체 파이프라인에 연결하세요.

SECRETS

서명 자료 분리

작업에 필요한 인증 정보와 인증서를 정리하고 읽기 범위를 제한하세요. 저장소, 스크립트 출력, 티켓에 기록하지 마세요. 작업이 끝나면 임시 산출물이나 로그에 민감한 값이 포함되지 않았는지 확인하세요.

데스크톱 수동 빌드와 runner 결과가 다르면 실행 계정, 작업 디렉터리, 도구 버전, 환경 변수를 우선 비교하세요. 두 빌드의 오류 로그를 모두 보관하고 차이를 하나씩 확인하세요.

요금 및 결제

요금 내역을 항목별로 확인하세요

모델, 노드, 결제 주기, 추가 옵션을 확인한 뒤 최종 결제 내역을 살펴보세요. 서로 다른 주기의 표시 가격을 같은 일일 요금처럼 비교하지 마세요.

결제 주기

일·주·월·분기는 각각 별도로 표시되는 네 가지 결제 주기입니다. 주기를 변경할 때마다 해당 모델과 선택한 추가 옵션의 가격, 주문의 실제 시작일과 종료일을 확인하세요.

추가 옵션

+1TB SSD, +2TB SSD 또는 Thunderbolt 5 병렬 연결을 추가로 선택한 경우 선택 여부와 해당 주기의 가격을 각각 확인하세요. 선택하지 않은 항목을 구매한 구성으로 간주하지 마세요.

결제 방식

USDT-TRC20과 Stripe를 통한 Visa / Mastercard / Amex만 지원하며, 모든 결제는 USD로 처리됩니다. 결제 시 실제 이용 가능한 결제 게이트웨이는 콘솔에 표시되는 옵션을 확인하세요.

용어 빠르게 찾기

여덟 가지 용어의 의미부터 확인하세요

제공 정보를 확인하거나 문제를 설명할 때 다음 용어를 사용하면 장비, 위치, 연결 방식, 결제 단위를 구분하기 쉽습니다.

물리 노드
선택한 클라우드 Mac이 배정되는 실제 서비스 노드입니다. 주문 내역과 제공 정보에 표시된 선택 항목을 기준으로 확인하세요.
전용 물리 Mac
대여자 한 명이 사용하는 실제 Mac으로, 컴퓨팅 자원을 공유하는 가상 인스턴스가 아닙니다.
가상 머신이 아닌 장비
대여한 컴퓨팅 환경이 가상 머신 인스턴스가 아니라 실제 물리 Mac임을 뜻합니다.
원격 Mac 데스크톱
네트워크를 통해 대여한 Mac의 그래픽 인터페이스에 접속하는 방식입니다. 구체적인 연결 매개변수는 제공 정보에서 확인하세요.
VNC
원격 데스크톱 화면과 입력을 전송하는 방식입니다. 사용 여부와 설정 방법은 제공 정보를 기준으로 확인하세요.
self-hosted runner
직접 관리하는 장비에서 CI/CD 작업을 실행하는 프로그램입니다. 권한과 툴체인을 별도로 점검해야 합니다.
결제 주기
주문 및 표시 가격에 적용되는 일·주·월·분기 단위입니다.
노드 지역
주문 시 선택하는 서비스 위치입니다. 협업하는 지역과 실제 연결 환경을 고려해 선택하세요.
더 알아보기

다음으로 살펴볼 주제

아래 항목은 학습 주제이며, 게시된 문서 목록이 아닙니다. 바로 실행할 절차가 필요하면 위 가이드 색인에서 해당 단계로 이동하세요.

01Apple Silicon 및 가상화

아키텍처 개념과 전용 물리 Mac의 실제 제공 방식을 구분하세요.

02CI/CD 파이프라인 연동

runner 권한부터 첫 빌드, 로그와 산출물 확인까지 살펴보세요.

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

원격 개발과 자동 작업 간 서명 자료 전달 과정을 정리하세요.

04TestFlight 배포 절차

클라우드 Mac에서의 빌드 확인과 이후 제출 작업을 구분하세요.

05iOS 앱 자동 빌드

의존성, 서명, 빌드 매개변수, 산출물 검증을 절차에 포함하세요.

06Homebrew 환경 이전

도구 목록을 바탕으로 버전과 프로젝트 의존성을 하나씩 재현하세요.

지원이 필요하신가요?

문제를 재현할 수 있도록 정보를 남겨 주세요

모델, 선택한 노드, 문제 발생 시각, 기대한 결과, 실제 결과, 시도한 조치를 적어 주세요. 빌드 문제라면 민감한 정보를 삭제한 오류 로그를 첨부할 수 있습니다. 공개 페이지, 이메일, 티켓에 비밀번호, 토큰, 개인 키를 보내지 마세요.

기존 주문 또는 인스턴스 확인

주문 및 제공 정보와 문제를 함께 확인할 수 있도록 콘솔에 로그인해 티켓을 제출하세요.

콘솔에 로그인해 티켓 제출
구매 전 상담 및 일반 문의

support@xcodezone.com으로 이메일을 보내 용도, 필요한 툴체인, 희망 노드를 알려 주세요.

지원팀에 이메일 보내기

모델, 노드, 이용 기간을 정하셨나요?

먼저 요금제를 확인한 뒤 주문을 진행하세요. 기존 주문의 연결 및 요금 관련 문의는 콘솔에서 처리할 수 있습니다.