전용 물리 Mac mini 연결부터 빌드, 대여 기간 관리, 문제 해결까지 안내합니다. 명령어나 문제 키워드를 입력해 이 페이지에서 관련 항목을 찾아보세요.
인스턴스가 준비되면 콘솔의 인스턴스 상세 정보에서 호스트 주소, 사용자 이름, 연결 방법을 확인하세요. 예시 명령의 변수를 실제 로그인 정보로 착각하지 마세요. 실행 전에 이번에 제공된 값으로 설정해야 합니다.
로컬 기기에서 키 쌍을 생성한 뒤 공개 키를 콘솔에 등록하세요. 개인 키는 본인 기기에만 보관합니다. 인스턴스가 준비되고 키가 등록되었는지 확인한 다음, 인스턴스 상세 정보의 주소와 사용자 이름으로 연결하세요.
ssh-keygen -t ed25519
ssh -i ~/.ssh/id_ed25519 "$USER@$HOST"USER 와 HOST 는 로컬에서 직접 설정해야 하는 환경 변수입니다. 처음 연결할 때 호스트 지문을 확인하고, 검증을 건너뛰지 마세요.
Xcode, 시뮬레이터 또는 시스템 설정을 조작해야 한다면 콘솔의 인스턴스 상세 정보에 안내된 방법으로 원격 데스크톱에 연결하세요. 연결 전에 인스턴스 상태를 확인하고 디스플레이 주소와 접속 정보를 대조하세요.
화면이 눈에 띄게 지연되면 클라이언트 해상도나 색 심도를 낮추고 로컬 네트워크 상태를 확인하세요. VNC 접속 정보를 빌드 로그에 기록하거나 SSH 개인 키와 함께 공유하지 마세요.
콘솔의 인스턴스 상세 정보에서 실제로 열린 포트를 확인하세요. 모든 인스턴스가 같은 포트를 사용한다고 가정하지 마세요. SSH 연결 시간이 초과되면 먼저 로컬 네트워크가 아웃바운드 연결을 차단하는지 확인한 다음 호스트 주소, 포트, 인스턴스 상태를 점검하세요. 방화벽 규칙을 변경하기 전에 사용할 수 있는 관리 연결을 하나 유지해 접속이 차단되지 않도록 하세요.
전용 물리 Mac에서 명령줄 빌드를 실행하기 전에 Xcode 버전이 프로젝트 요구 사항과 일치하는지 확인하세요. 팀 CI에서는 프로젝트, Scheme, 코드 서명 자료의 출처를 고정해 일시적인 데스크톱 조작에 빌드 성공이 좌우되지 않도록 하세요.
먼저 Mac에 설치된 Xcode를 확인하고 프로젝트에 필요한 버전을 선택하세요. 버전을 바꾼 뒤에는 명령줄 도구 경로와 버전을 다시 확인하세요. 아래 경로는 해당 버전이 실제로 설치된 경우에만 사용할 수 있습니다.
ls /Applications | grep Xcode
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
xcode-select -p
xcodebuild -version프로젝트 디렉터리에서 사용 가능한 Scheme을 확인해 빌드 대상을 선택한 다음 Release 빌드를 실행하세요. fastlane을 사용하는 팀은 lane 설정을 버전 관리에 포함하고 실행 전에 인증서와 환경 변수를 확인해야 합니다.
xcodebuild -list
xcodebuild -scheme App -configuration Release build
bundle exec fastlane gymApp 프로젝트에 실제로 있는 Scheme 이름으로 바꾸세요. gym 해당 프로젝트에 fastlane 설정이 있어야 합니다.
작업을 실행할 시스템 계정에 필요한 권한만 부여하고 작업 디렉터리를 제한하세요. SSH 개인 키나 코드 서명 자료를 저장소에 커밋하지 마세요.
GitHub Actions 또는 GitLab의 프로젝트 설정에서 등록 정보를 생성한 다음, 플랫폼이 안내하는 최신 설치 명령에 따라 Mac에 러너를 등록하세요.
먼저 출력을 확인하는 간단한 작업을 실행하세요: sw_vers 및 xcodebuild -version 를 출력해 실행 노드가 올바른지 확인한 다음 전체 빌드를 연결하세요.
제공받은 인스턴스를 처음 사용한다면 빠른 시작 안내에 따라 연결하고 첫 빌드를 완료하세요.
다음 용어는 대여 장비, 연결 방식, 요금 단위를 구분하는 데 사용됩니다. 요금제를 선택할 때는 먼저 작업에 필요한 사항을 살펴보고 대여 기간을 결정하세요.
주문할 때 기종, 노드, 대여 기간, 추가 옵션을 선택하고 해당 주기의 요금을 선결제합니다. 주문에 표시된 제공 시각과 만료 시각은 콘솔 기록을 기준으로 확인하세요. 결제 시각으로 사용 가능 시간을 계산하지 마세요.
결제 전에 기종, 노드, 일·주·월·분기 중 선택한 과금 주기를 확인하세요. 실제 이용 가능 여부는 콘솔에 표시되는 최신 정보가 기준입니다.
인스턴스 제공 후 콘솔에서 대여 기록과 만료 정보를 확인하세요. 알림은 일정 관리에 참고만 하고, 별도의 백업 계획을 세워야 합니다.
계속 사용하려면 콘솔에서 주문을 열어 연장 절차를 진행하세요. Commit 16에서 Commit 24로 변경하려면 새 구성과 데이터 이전 계획을 먼저 확인한 다음 콘솔의 안내에 따라 진행하세요.
USDT-TRC20 및 Stripe를 통해 처리되는 Visa, Mastercard, Amex만 지원합니다. 모든 가격과 결제 금액은 미국 달러(USD) 기준입니다. 결제 시 실제로 사용할 수 있는 결제 게이트웨이는 콘솔에 표시되는 정보를 확인하세요. 기종별 가격과 네 가지 대여 주기는 요금제 및 가격에서 확인할 수 있습니다.
인스턴스 상태, 네트워크, 시스템 세션, 프로젝트 설정 순서로 확인하세요. 오류 원문, 발생 시각, 이미 시도한 조치를 기록해 두면 지원 티켓에서 문제를 더 빠르게 파악할 수 있습니다.
먼저 콘솔에서 인스턴스가 연결 가능한 상태인지 확인하세요. 연결을 끊었다가 그래픽 세션을 다시 시작하고 클라이언트 해상도를 낮춰 보세요. SSH로 접속할 수 있다면 시스템이 명령에 응답하는지 확인할 수 있습니다. 지원 티켓에는 클라이언트에 표시된 안내, 연결 시각, SSH 사용 가능 여부를 적고 접속 비밀번호는 첨부하지 마세요.
시간 초과는 보통 키 인증 단계에 도달하기 전에 발생합니다. 콘솔에 표시된 주소와 포트, 인스턴스 상태, 로컬 네트워크의 아웃바운드 연결 허용 여부를 확인하세요. 다른 네트워크에서 다시 연결해 결과를 기록하고, 포트 규칙을 확인하기 전에는 개인 키를 반복해서 바꾸지 마세요.
먼저 df -h 로 남은 공간을 확인한 다음 빌드 결과물, DerivedData, 아카이브, 모델 파일이 차지하는 공간을 확인하세요. 삭제하기 전에 파일 소유자를 확인하고 보관할 결과물은 백업하세요. 장기적으로 더 많은 공간이 필요하다면 요금제 페이지에서 SSD 추가 옵션을 확인하세요.
인증서가 유효한지, 프로비저닝 프로파일과 Bundle ID가 일치하는지, 빌드를 실행하는 계정에 해당 키체인을 읽을 권한이 있는지 확인하세요. 데스크톱 로그인 계정과 CI 러너 계정은 다를 수 있으므로 같은 계정에서 오류를 재현해 보세요. 지원 티켓에는 민감한 정보를 가린 오류 로그를 첨부하고 개인 키나 인증서 비밀번호는 보내지 마세요.
프로젝트 소스 코드, 빌드 결과물, 인증서, 모델 파일은 직접 백업해야 합니다. 대여 기간이 끝난 뒤 인스턴스 접근은 서비스 약관에 따라 처리됩니다. 데이터 보관 기간과 이후 삭제 절차는 서비스 약관및 주문 정보를 확인하세요. 만료 후에도 로그인해 파일을 가져올 수 있다고 가정하지 마세요.
코드를 본인 저장소에 커밋하고, 아직 아카이브하지 않은 IPA, 로그 또는 모델 결과를 직접 관리하는 저장 위치로 복사하세요.
코드 서명 인증서, 키, CI 변수의 사용 범위를 확인하세요. 필요한 경우 프로젝트 측에서 자격 증명을 교체하고 개인 키를 공유 빌드 로그에 남기지 마세요.
같은 인스턴스를 계속 사용해야 한다면 미리 연장 옵션을 확인하세요. 사용을 마칠 예정이라면 백업을 열어 확인한 뒤 정리 작업을 완료하세요.
주문이 있다면 콘솔에 로그인해 지원 티켓을 제출하고 주문 번호, 노드, 문제 발생 시각, 오류 정보를 적어 주세요. 아직 주문하지 않았다면 연결이나 구성 문제에 대해 문의 페이지에서 이메일로 상담할 수 있습니다.