Commit 16
단일 앱의 Xcode 빌드와 fastlane 패키징, SSH·VNC 및 개발 도구 체인을 처음 구성하는 데 적합합니다. 시뮬레이터와 컨테이너를 함께 실행할 계획이라면 프로젝트의 실제 메모리 사용량을 먼저 확인하세요.
공유 가상 머신이 아닌 전용 Mac mini를 하루 단위로 대여하세요. 모델 선택과 접속 정보 확인부터 첫 빌드까지 아래 순서대로 진행하면 됩니다.
결제 후 약 15분 이내에 인스턴스가 제공됩니다. 첫 접속과 확인에 걸리는 시간은 키, 프로젝트, 서명 준비 상태에 따라 달라집니다.
최소 대여 기간은 1일입니다. M4 모델 2종을 제공하며, 일·주·월·분기 단위로 대여할 수 있습니다. 실시간 이용 가능 여부는 콘솔에서 확인하세요.
주문 시 모델, 리전, 대여 기간, 결제 수단을 차례로 선택합니다. 한 번의 릴리스 작업이라면 1일부터 시작하고, CI를 계속 실행해야 한다면 주·월·분기 요금제를 비교해 보세요. 선택한 기간의 요금은 선불이며 달러로 결제됩니다.
단일 앱의 Xcode 빌드와 fastlane 패키징, SSH·VNC 및 개발 도구 체인을 처음 구성하는 데 적합합니다. 시뮬레이터와 컨테이너를 함께 실행할 계획이라면 프로젝트의 실제 메모리 사용량을 먼저 확인하세요.
Xcode, 시뮬레이터, 컨테이너를 함께 실행하거나 MLX 모델과 빌드 캐시를 위한 공간이 더 필요한 작업에 적합합니다. 모델 파일이 크다면 주문 시 SSD 추가 옵션을 확인하세요.
싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 동부, 미국 서부 중에서 선택할 수 있습니다. 팀과 코드 서비스에 가깝고 안정적으로 접속할 수 있는 리전을 우선 선택하세요. 두 모델 모두 6개 리전에서 이용할 수 있습니다.
결제는 USDT-TRC20 또는 Stripe를 통한 Visa / Mastercard / Amex만 지원합니다. 이용 가능한 결제 게이트웨이는 콘솔에 표시되는 정보를 확인하세요.
인스턴스 정보는 콘솔에서 확인할 수 있습니다. 로그인 정보, 개인 키, 서명 인증서를 지원 요청 본문에 붙여 넣지 마세요. 문제를 확인해야 한다면 주문 번호와 민감 정보를 가린 오류 출력만 전달하세요.
| 항목 | 용도 | 확인 방법 |
|---|---|---|
| 호스트 주소 | SSH 및 VNC 접속 대상을 지정합니다. | 콘솔에 표시된 주소를 복사하고 앞뒤에 불필요한 공백이 없는지 확인하세요. |
| 사용자 이름 | 호스트 주소와 함께 SSH 로그인 계정을 구성합니다. | 주문에 지정된 계정을 사용하세요. 시스템 기본 사용자 이름을 추측하지 마세요. |
| SSH 공개 키 | 키 인증으로 기기 접속을 허용합니다. | 공개 키 파일의 내용을 등록하고 개인 키는 본인 기기에만 보관하세요. |
| VNC 접속 정보 | macOS 그래픽 인터페이스를 엽니다. | 인스턴스 안내에 나온 접속 방법과 인증 정보를 사용하세요. VNC를 SSH 포트처럼 사용하지 마세요. |
먼저 본인 컴퓨터에서 키 쌍을 생성한 뒤 공개 키를 콘솔에 등록하세요. 등록 후에는 로컬 개인 키로 접속하면 됩니다. 원격 호스트에서 해당 호스트 접속용 개인 키를 유일하게 생성하지 마세요.
먼저 주소, 사용자 이름, 공개 키를 확인한 뒤 로컬 네트워크에서 대상에 연결할 수 있는지 점검하세요. TCP 연결 시간이 초과되면 네트워크를 먼저 확인하고, 공개 키가 거부되면 계정 정보와 권한 설정을 확인하세요.
로컬 터미널에서 인스턴스 정보를 바탕으로 접속 변수를 설정하세요. 먼저 macOS와 프로세서 아키텍처를 확인하고, 프로젝트 디렉터리에서 사용 가능한 scheme을 조회하세요. 프로젝트의 scheme과 서명 설정을 확인한 뒤에만 빌드하거나 아카이브하세요.
ssh -i ~/.ssh/id_ed25519 "$VM_USER@$VM_HOST"연결되면 명령 프롬프트가 원격 Mac으로 전환됩니다. 처음 접속할 때는 호스트 지문이 인스턴스 정보와 일치하는지 확인하세요.
sw_vers -productName
uname -m
sysctl -n machdep.cpu.brand_string각 명령에서 macOS, arm64, Apple M4가 표시되어야 합니다. 정확한 시스템 버전은 제공된 Mac의 실제 출력으로 확인하세요.
xcodebuild -list
xcodebuild -scheme "$SCHEME" -destination 'generic/platform=iOS' build CODE_SIGNING_ALLOWED=NO서명 없이 빌드해 프로젝트가 빌드되는지 먼저 확인하세요. 성공 여부는 종료 상태와 BUILD SUCCEEDED를 확인하고, 실패했다면 첫 번째 빌드 오류부터 살펴보세요.
fastlane gym --scheme "$SCHEME"아카이브와 내보내기에는 프로젝트에 필요한 인증서, 프로비저닝 프로파일, fastlane 설정이 필요합니다. 명령이 끝나면 마지막 로그 한 줄만 보지 말고 내보낸 결과물도 확인하세요.
여기서 VM_USER·VM_HOST · SCHEME 은 셸 변수입니다. 인스턴스 정보와 프로젝트의 실제 scheme을 사용해 먼저 값을 지정하세요. 프로젝트가 특정 Xcode 버전에 의존한다면 xcodebuild -version 으로 버전을 확인한 뒤 전환하세요.
SSH는 파일 전송, 빌드 실행, 로그 확인에 적합합니다. Xcode 인터페이스나 시뮬레이터, 시스템 설정을 조작해야 할 때는 인스턴스 정보에 따라 VNC로 접속하세요. 두 방식 모두 동일한 전용 Mac mini에 연결됩니다.
VNC 클라이언트에 인스턴스 안내에 나온 주소와 접속 정보를 입력하세요. SSH 사용자 이름, 키, 포트를 VNC 클라이언트에 그대로 사용하지 마세요.
클라이언트에서 낮은 해상도로 시작하세요. 화면과 입력이 안정적으로 작동하면 해상도를 높이면 됩니다. 지역 간 원격 접속에서는 처음부터 최고 화질을 선택하기보다 응답 속도를 우선하세요.
실제 빌드는 SSH 명령으로 재현할 수 있도록 하세요. VNC 연결이 끊겨도 빌드, 로그 확인, CI 문제 해결을 데스크톱 화면에 의존하지 않을 수 있습니다.
검은 화면이 나타나면 먼저 올바른 주문과 리전에 연결했는지 확인한 뒤 세션 상태를 점검하세요. 원격 화면 문제를 해결하려고 프로젝트를 반복해서 수정하거나 빌드 캐시를 삭제하지 마세요.
GitHub Actions self-hosted runner를 연결하려면 먼저 저장소의 runner 설정에서 등록 명령과 단기 토큰을 생성한 다음 이 Mac에서 플랫폼이 제공하는 해당 명령을 실행하세요. 토큰을 저장소, 스크린샷, 빌드 로그에 남기지 마세요.
빌드할 저장소 또는 관리 대상 조직에 runner를 등록하고, 이 macOS 호스트를 식별할 수 있는 레이블을 지정하세요. 화면에 runner가 온라인으로 표시된 뒤 워크플로를 제출하세요.
먼저 워크플로에서 코드를 체크아웃한 뒤 수동 검증에 사용한 것과 같은 Xcode 명령을 실행하세요. 성공한 다음에 의존성 캐시, 테스트, 서명, 배포를 차례로 추가해 여러 문제 요인이 한꺼번에 생기지 않도록 하세요.
runner는 이 시스템의 빌드 환경에 접근할 수 있습니다. 실행을 허용할 브랜치와 저장소의 권한을 제한하고 서명 정보를 안전하게 관리하세요. 대여 기간이 끝나기 전에 더 이상 사용하지 않는 runner 등록을 해제하세요.
runner가 올바르게 선택되고 코드가 체크아웃되는지 먼저 확인한 다음 xcodebuild -version 이 수동 확인 결과와 일치하는지 점검하고 검증된 scheme을 실행하세요. 워크플로의 scheme, 대상 플랫폼, 서명 옵션은 프로젝트에 맞아야 합니다. 예시 명령을 모든 프로젝트의 패키징 설정으로 그대로 사용하지 마세요.
대여 기간은 인스턴스가 제공된 시점부터 시작됩니다. 만료 전에 백업과 runner 정리를 마치고 연장 여부를 결정하세요. 유일한 소스 코드, 인증서, 빌드 결과물을 원격 머신에만 보관하지 마세요.
소스 코드의 커밋 상태를 확인하고 아카이브, 로그, 모델 파일, 설정을 가져오세요. 파일을 본인 저장소에서 열 수 있는지 검증하고, 서명 정보는 팀의 기존 보안 절차에 따라 보관하세요.
빌드가 아직 끝나지 않았다면 콘솔에서 연장을 확인하세요. 병렬 작업이 메모리나 디스크 용량에 제한을 받는다면 Commit 16과 Commit 24의 사양을 비교한 뒤 실제 필요에 맞춰 조정하세요.
CI 대기열에 남은 작업이 있는지, runner가 저장소에 계속 연결되어 있는지 확인하세요. 만료 후 데이터 처리는 서비스 약관과 콘솔에 표시된 정책을 따릅니다. 백업은 대여 기간 안에 완료하세요.
접속 방법, 빌드 명령, 요금 규정을 확인하려면 먼저 문서를 살펴보세요. 원격 개발 환경을 체계적으로 구성하려면 블로그에서 ‘원격 Mac 개발 환경 설정’을 찾아보세요. 제공되는 글은 블로그에 현재 게시된 내용을 기준으로 합니다.
1일부터 시작해 리전과 모델을 선택하세요. 인스턴스가 제공되면 이 체크리스트에 따라 첫 빌드를 진행할 수 있습니다.