주문 및 기기
주문에 연결된 Mac, 모델, 인스턴스 ID를 확인하세요. 여러 기기를 관리한다면 작업할 기기를 먼저 구분해 프로젝트 파일을 잘못된 기기에 전송하지 않도록 하세요.
연결 및 빌드 지원
주문 정보를 확인하고 클라우드 Mac에 연결하세요.
먼저 기기, 리전, 접속 권한을 확인한 다음 SSH로 연결하고 빌드 환경을 점검하세요. 처음 연결하거나 문제를 진단할 때 활용할 수 있습니다. 접속 주소, 사용자 이름, 키는 본인의 주문 정보를 확인하세요.
이미 주문하셨나요? 콘솔에서 해당 주문을 열고 오른쪽의 확인 순서에 따라 진행하세요.
연결 확인 항목
01 / 03
먼저 확인하고 연결하세요
주문 하나당 기기 한 대입니다.
- 기기
- 주문한 모델과 인스턴스 ID 확인
- 리전
- 선택한 리전과 접속 경로 확인
- 권한
- 주문에 제공된 접속 정보 사용
공개 예시에는 실제 주소, 개인 키, 액세스 토큰이 포함되지 않습니다. 실제 접속 정보는 콘솔에서 확인하세요.
시작 전
접속 조건을 모두 확인한 뒤 터미널을 여세요.
주문 상세에서 항목별로 확인하고, 변경되었을 수 있는 접속 정보를 예전 메모나 채팅 기록에서 복사하지 마세요. 아직 주문하지 않았다면 먼저모델 및 가격 보기에서 선택 가능한 구성과 대여 기간을 확인하세요.
리전 및 접속 정보
주문에서 선택한 리전을 확인하고 해당 기기의 관리 정보에서 접속 주소, 포트, 사용자 이름을 확인하세요. 이 페이지의 예시 주소를 실제 접속 주소로 사용하지 마세요.
계정 및 접속 권한
현재 계정으로 해당 주문과 접속 정보를 확인할 수 있는지 점검하세요. 개인 키는 안전하게 관리되는 로컬 환경에 보관하고, 지원 티켓이나 저장소, 공개 페이지에 올리지 마세요.
민감한 인증 정보는 보내지 마세요.문제 해결을 위해 민감 정보를 제거한 오류 메시지는 제공할 수 있지만, 개인 키, 전체 토큰, 인증서 내용 또는 개인 정보가 포함된 원본 로그는 보내지 마세요.
연결 절차
세 단계로 안전하게 연결하세요.
먼저 해당 주문의 실제 접속 정보를 확인한 다음 로컬 키를 준비하고 최초 접속 시 호스트 신원을 확인하세요. 네트워크 연결, 계정 권한, 호스트 신원은 각각 별도로 확인해야 합니다. 로그인 메시지가 표시된다는 이유만으로 확인을 건너뛰지 마세요.
-
01
접속 정보 확인
콘솔에 로그인해 대상 주문을 열고 해당 기기에 제공된 주소, 포트, 사용자 이름, 연결 안내를 확인하세요. 주문에 접속 정보가 표시되지 않으면 주소를 추측하지 말고 주문 상태를 먼저 확인하세요.
-
02
SSH 키 준비
로컬 개인 키 파일의 접근 권한을 확인하고 주문 안내에 따라 해당 공개 키를 설정하세요. CI용으로는 권한이 제한된 인증 정보를 별도로 준비하세요. 개인 개발 컴퓨터의 개인 키를 빌드 저장소에 그대로 복사하지 마세요.
-
03
호스트 신원 확인
최초 접속 시 신뢰할 수 있는 기기 정보와 호스트 지문을 대조하세요. 지문이 일치하지 않거나 갑자기 바뀌면 접속을 중단하고 기기, 주소, 접속 경로를 잘못 선택했는지 확인하세요. 경고를 무시하지 마세요.
명령어 예시
연결 후 최소한의 명령어로 환경을 확인하세요.
아래 출력은 확인 순서를 설명하기 위한 예시일 뿐, 특정 기기의 실제 시스템 버전이나 빌드 결과 또는 구성된 프로젝트를 나타내지 않습니다. 예시용 192.0.2.10 는 주문에 제공된 접속 주소가 아닙니다. 실행하기 전에 콘솔에서 확인한 정보로 바꾸세요.
먼저 대상 기기에 접속할 수 있는지 확인하고, 이어서 Xcode 명령줄 도구의 경로를 확인한 다음 프로젝트 디렉터리에서 빌드 작업을 실행하세요. 각 단계의 실패 원인을 따로 파악할 수 있으므로 CI 파이프라인 전체를 한꺼번에 옮겨 테스트할 필요는 없습니다.
연결 및 빌드 확인 · 예시
$ ssh -i ~/.ssh/id_ed25519 operator@192.0.2.10
예시 출력: 대상 기기에 접속했습니다. 호스트 신원을 확인하세요
$ xcodebuild -version
예시 출력: 기기에 설치된 Xcode 버전이 표시됩니다
$ fastlane build
예시 출력: 프로젝트 설정을 확인한 후 빌드 결과를 반환합니다예시 명령어에는 실제 인증 정보가 포함되어 있지 않습니다.fastlane build 는 프로젝트에 해당 작업이 정의된 경우에만 사용할 수 있습니다. 실제 명령어는 프로젝트 설정을 따르세요.
첫 빌드
버전과 종속성을 기록한 뒤 빌드 결과를 비교하세요.
“연결 성공”은 기기에 접속했다는 뜻일 뿐, 개발 환경이 프로젝트 요구 사항에 맞는다는 뜻은 아닙니다. Runner를 배포하거나 많은 프로젝트 파일을 업로드하기 전에 다음 항목을 확인하세요. 구체적인 시스템 및 도구 버전은 대여한 기기의 실제 환경을 기준으로 합니다.
시스템 및 Xcode
macOS 버전과 현재 Xcode 버전, 그리고 xcode-select -p 가 가리키는 개발자 디렉터리를 기록하세요. 프로젝트에 특정 SDK가 필요하다면 사용 가능한 버전을 확인한 뒤 빌드를 시작하세요.
확인 항목: 시스템 버전, Xcode 버전, 명령줄 도구 경로.
프로젝트 종속성
저장소의 잠금 파일에 따라 종속성을 설치하고 패키지 관리자, 스크립트 실행 환경, 프로젝트에 필요한 플러그인을 확인하세요. 도구 설치, 프로젝트 설정, 서명 자료는 따로 관리해야 합니다. 빌드 한 번의 실패만으로 기기 문제라고 단정하지 마세요.
확인 항목: 잠금 파일, 설치 로그, 종속성 버전.
최소 빌드
먼저 프로젝트 디렉터리에서 재현 가능한 검사 또는 빌드 명령 하나를 실행하고, 명령어와 종료 상태, 첫 오류 위치를 기록하세요. 로컬 수동 빌드가 정상적으로 완료된 뒤 같은 작업을 CI에 연결하세요.
확인 항목: 실행 디렉터리, 전체 명령어, 최초 실패 단계.
자동화 연동
Runner에서 검증된 수동 빌드를 재현하세요.
CI/CD 연동의 목적은 추적할 수 없는 새 환경을 만드는 것이 아니라, 이미 성공한 명령어와 종속성, 권한 요구 사항을 기록해 반복 실행 가능한 작업으로 만드는 것입니다. 등록 방식과 실행기 설정은 사용하는 CI 시스템에 따라 다릅니다. 실제 등록 토큰을 공개 설정에 붙여 넣지 마세요.
A
등록 및 격리
사용하는 CI 시스템에서 대상 기기에 Runner를 등록하고, 예상한 프로젝트와 작업만 실행되는지 확인하세요. 실행 사용자, 작업 디렉터리, 동시 실행 작업을 점검하세요.
B
키 및 서명 자료
액세스 키와 서명 자료는 CI 시스템에서 제공하는 안전한 비밀 정보 저장 기능에 보관하세요. 저장소, 빌드 스크립트 출력, 캐시에 기록하지 마세요. 작업에 필요한 권한만 부여하세요.
C
캐시 및 빌드 결과물
종속성 캐시 경로와 정리 조건을 정하고 빌드 결과물을 팀에서 지정한 위치에 저장하세요. 오류를 재현할 수 없다면 이전 캐시를 사용하지 않고 빌드해 결과를 비교하세요.
D
세션 종료
작업이 끝나면 임시 파일, 백그라운드 프로세스, 세션 상태를 확인하세요. 기기를 인계하거나 권한을 변경할 때 더 이상 필요하지 않은 접근 권한을 취소하고 작업 디렉터리에 인증 정보가 남아 있지 않은지 확인하세요.
문제 해결
처음 실패한 단계부터 확인하세요.
문제가 발생한 단계를 기록하고 관련 명령어, 종료 상태, 민감 정보를 제거한 로그를 보관하세요. “실패” 화면만 캡처해 보내지 마세요. 마지막 요약보다 처음 나타난 오류가 문제 해결에 더 유용합니다.
SSH 연결 실패
먼저 주문과 대상 기기를 확인한 뒤 주소, 포트, 로컬 네트워크 연결 여부를 확인하세요. 다음으로 사용자 이름, 키 권한, 호스트 신원 안내를 점검하세요. 연결 시간 초과와 권한 거부는 따로 기록해야 합니다. 전자는 접속 경로를, 후자는 권한 설정을 먼저 확인하세요.
서명 설정 오류
프로젝트에서 사용하는 서명 설정, 빌드 대상, CI 실행 사용자가 일치하는지 확인하세요. 인증서나 개인 키 내용을 지원 요청에 붙여 넣지 마세요. 민감 정보를 제거한 오류 줄과 오류가 발생한 빌드 단계를 제공하면 됩니다.
빌드 실패
수동 실행과 CI 작업에서 Xcode 경로, 종속성 버전, 작업 디렉터리, 환경 변수 출처를 비교하세요. 실제 컴파일 또는 스크립트 오류가 처음 발생한 지점을 찾은 다음 캐시를 정리하고 재실행할지 판단하세요.
디스크 공간 부족
사용 가능한 공간을 확인하고 프로젝트 파일, 빌드 결과물, 종속성 캐시, 임시 파일을 구분하세요. 정리하기 전에 파일 소유자를 확인하세요. 작업에 지속적으로 더 많은 공간이 필요하다면요금제 페이지에서 스토리지 추가 옵션을 확인하세요.
지원 요청을 제출할 때:주문에 해당하는 기기 모델과 리전, 문제 발생 시각, 실행한 명령어, 첫 오류 위치, 이미 시도한 해결 방법을 함께 보내세요. 전송 전에 토큰, 인증서, 개인 키, 개인 정보를 삭제하세요.
추가 지원이 필요하신가요?
직접 확인해도 해결되지 않나요? 주문 정보를 함께 알려 주세요.
기존 주문 관련 문제는 먼저 콘솔에 로그인해 기기 정보를 확인한 다음 지원 티켓을 제출해 해당 주문과 연결하세요. 구매 전 제품 선택이나 주문 전 문의는 문의 페이지의 이메일 작성 안내를 확인하세요. 지원 요청에 계정 비밀번호나 전체 키를 포함할 필요는 없습니다.
시작할 준비가 되셨나요?
기기를 선택하고 체크리스트에 따라 연결하세요.
Apple Silicon 전용 물리 서버 3종을 일간, 주간, 월간 또는 분기 단위로 대여할 수 있습니다. 모델과 대여 기간을 확인하고 주문한 뒤 콘솔에서 접속 정보를 확인하세요.