첫 사용 가이드

주문부터
첫
archive까지

독립형 Apple Silicon 물리 노드를 임대해 연결, 툴체인, 빌드를 차례로 점검하세요. 먼저 프로젝트 하나를 빌드한 다음 팀 CI에 연결하면 됩니다.

모델 2종, 노드 5곳, 하루 $21.2부터. 전체 장비를 단독으로 사용하며 가상 머신이 아닙니다. 제공 상태와 실제 사용 가능 여부는 콘솔의 실시간 정보를 확인하세요.

1단계 / 컴퓨팅 리소스 선택

워크로드를 먼저 살펴보고 노드를 선택하세요

단순 컴파일과 첫 검증에는 Arm Line M4부터 시작하세요. 모델 추론이나 더 큰 통합 메모리가 필요하면 Arm Grid M4 Pro를 선택하세요. 프로젝트 디렉터리 크기만으로 메모리 요구량을 판단하지 말고, 동시 작업과 툴체인이 차지하는 리소스도 고려하세요.

Arm Line M4

M4 / 16GB / 256GB

첫 Xcode 빌드, 단일 CI 빌드 파이프라인, 임시 iOS 빌드에 적합합니다. 실제 프로젝트로 의존성 설치, 캐시 크기, 빌드 흐름을 먼저 확인하세요.

하루 $21.2

Arm Line M4 임대하기

Arm Grid M4 Pro

M4 Pro / 64GB / 2TB

모델 추론, 대규모 빌드 캐시, 메모리 사용량이 많은 워크플로에 적합합니다. 특정 모델을 실행할 수 있는지는 양자화 방식, 컨텍스트 길이, 실행 매개변수에 따라 확인해야 합니다.

하루 $59.8

Arm Grid M4 Pro 임대하기

두 모델 모두 5개 노드에서 제공

싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 동부. 대화형 데스크톱 작업이라면 팀 위치에서 노드까지의 네트워크 경로를 우선 고려하세요. 무인 빌드는 코드 가져오기, 의존성 다운로드, 결과물 전송도 따져봐야 합니다. 지리적 거리는 참고 기준일 뿐, 실제 지연 시간을 뜻하지는 않습니다.

처음 임대한다면 일 단위로 시작해 같은 프로젝트로 전체 과정을 실행한 뒤 장기 임대 여부를 결정하세요. 4가지 기간과 추가 옵션의 전체 가격은 요금제 페이지에서 확인할 수 있습니다.

2단계 / 결제 및 제공

결제 후 먼저 주문 상태를 확인하세요

USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원하며, 모든 결제는 미국 달러(USD)로 처리됩니다. 실제 이용 가능한 결제 게이트웨이는 백엔드 응답을 기준으로 합니다.

  1. 01

    주문 확인

    모델, 기간, 노드, 추가 옵션을 확인하세요. USDT 송금은 반드시 TRC20 네트워크를 선택하고, 결제 페이지에 표시된 수취 정보와 금액을 하나씩 대조하세요. 이전 주문의 결제 정보를 재사용하지 마세요.

  2. 02

    결제 확인 대기

    온체인 결제는 확인 절차가 필요하며, 입금 속도는 네트워크 상태에 따라 달라집니다. 카드 결제는 결제 결과와 주문 상태를 확인하세요. 페이지가 아직 갱신되지 않았다고 중복 결제하지 말고, 결제 성공을 노드 제공 완료로 간주하지 마세요.

  3. 03

    연결 정보 확인

    콘솔에서 제공 상태를 확인하세요. 노드를 사용할 수 있게 되면 IP, 로그인 사용자 이름, 초기 비밀번호, 연결 포트를 확인하세요. 결제 증빙과 주문 상태가 일치하지 않으면 주문 번호와 거래 해시 또는 결제 증빙을 첨부해 지원 티켓을 제출하세요.

3단계 / 첫 연결

먼저 SSH를 확인한 다음 그래픽 데스크톱을 여세요

아래 명령어는 로컬 터미널에서 실행합니다. 콘솔에 실제로 표시된 주소, 포트, 사용자 이름을 입력하고, 문서의 예시를 접속 정보로 사용하지 마세요.

SSH 세션 연결

read -r -p "Node IP: " NODE_IP
read -r -p "SSH port: " SSH_PORT
read -r -p "Login user: " NODE_USER
ssh -p "$SSH_PORT" "$NODE_USER@$NODE_IP"

처음 연결하면 호스트 지문이 표시됩니다. 신뢰할 수 있는 경로로 지문을 확인한 뒤 수락하세요. 저장된 지문이 바뀌었다면 노드를 재설치했거나 교체했는지 먼저 확인하고, 검증을 건너뛰지 마세요.

원격에서 현재 사용자 비밀번호 변경

whoami
hostname
passwd

passwd 클라우드 Mac의 SSH 세션에서 실행하세요. 안내에 따라 이전 비밀번호와 새 비밀번호를 입력합니다. 입력 중에는 문자가 표시되지 않습니다. 다른 서비스의 비밀번호를 재사용하거나 빌드 로그에 기록하지 마세요.

VNC 클라이언트 설정 방법

항목입력할 값확인 방법
서버 주소콘솔에 표시된 노드 IP현재 주문에 해당하는 IP를 입력하세요. 로컬 컴퓨터 주소를 입력하면 안 됩니다.
포트콘솔에 표시된 VNC 포트클라이언트에 포트 입력란이 별도로 있으면 각각 입력하세요. 포트를 임의로 추측하지 마세요.
인증 정보콘솔에 표시된 그래픽 연결 인증 정보VNC 비밀번호와 SSH 비밀번호가 항상 같다고 가정하지 마세요.
초기 디스플레이 설정낮은 해상도부터 시작화면과 입력이 정상인지 먼저 확인한 뒤 대역폭에 맞춰 화질을 높이세요.

macOS의 화면 공유 기능도 사용할 수 있습니다. 로그인 비밀번호를 변경한 뒤 그래픽 연결 인증 정보도 업데이트해야 하는지 제공 안내를 확인하세요. 신뢰할 수 없는 네트워크에 VNC 서비스를 직접 노출하지 마세요.

4단계 / 빌드 환경 준비

첫 빌드 전에 툴체인을 점검하세요

아래 명령어는 클라우드 Mac에서 실행합니다. 시스템과 기존 도구를 먼저 확인한 뒤 누락된 구성 요소를 설치하세요. 예제를 그대로 따라 하려고 팀에서 고정한 Xcode, Ruby 또는 의존성 버전을 덮어쓰지 마세요.

1. 시스템 및 Xcode 확인

sw_vers
uname -m
df -h /
ls /Applications
xcode-select -p
xcodebuild -version

xcode-select 독립 명령줄 도구를 가리키는 경우, 이것만으로 전체 Xcode를 사용할 수 있다고 판단할 수 없습니다. 전체 Xcode가 설치되어 있지 않다면 팀에서 사용 권한을 확인한 설치 패키지를 준비해 압축을 푼 다음 /Applications에 넣으세요. 압축 해제, 의존성, archive 결과물에 필요한 디스크 공간도 확보해야 합니다.

2. 전체 Xcode 지정 및 초기화

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
sudo xcodebuild -license
sudo xcodebuild -runFirstLaunch
xcodebuild -version
xcodebuild -showsdks

위 예시는 애플리케이션 이름이 Xcode.app이라고 가정합니다. 여러 버전을 설치한 경우 실제 경로를 지정하세요. 라이선스를 수락하기 전에 약관을 읽으세요. 다른 작업의 툴체인을 변경하지 않으려면 단일 빌드에서 DEVELOPER_DIR 를 설정해 원하는 버전을 지정할 수도 있습니다.

3. Homebrew, Ruby, Fastlane 확인

command -v brew
brew --version
ruby --version
bundle --version

Homebrew가 아직 설치되지 않았다면 팀에서 검토한 설치 절차를 사용하세요. 출처를 알 수 없는 원격 설치 스크립트를 붙여 넣지 마세요. Apple Silicon에서 흔히 사용하는 설치 경로는 /opt/homebrew이며, 실제 출력 결과를 기준으로 하세요. 설치되어 있지만 현재 세션에서 찾을 수 없다면 환경을 불러오세요.

eval "$(/opt/homebrew/bin/brew shellenv)"
brew install ruby
export PATH="$(brew --prefix ruby)/bin:$PATH"
gem install bundler
bundle install
bundle exec fastlane --version

마지막 네 명령어는 프로젝트 디렉터리에서 실행하며, 저장소에 Fastlane 의존성이 고정된 Gemfile 과 잠금 파일이 있다고 가정합니다. 이 파일들이 없다면 먼저 팀에서 의존성 버전을 정하고 잠금 파일을 커밋한 다음 설치하세요. 관리자 권한으로 시스템 Ruby에 빌드 의존성을 대량 설치하지 마세요.

4. 서명 없이 archive 먼저 검증

read -r -p "Workspace path: " WORKSPACE
read -r -p "Shared scheme: " SCHEME
xcodebuild -list -workspace "$WORKSPACE"
xcodebuild \
  -workspace "$WORKSPACE" \
  -scheme "$SCHEME" \
  -destination 'generic/platform=iOS' \
  -archivePath "$HOME/BuildArtifacts/FirstBuild.xcarchive" \
  CODE_SIGNING_ALLOWED=NO \
  archive

먼저 프로젝트 디렉터리로 이동해 프로젝트에 선언된 의존성을 설치하고 scheme이 공유되어 있는지 확인하세요. .xcodeproj 만 있는 프로젝트라면 -project 를 사용해 -workspace를 대체하세요. 이 명령어는 컴파일 및 archive 흐름을 검증하지만 배포 가능한 서명 패키지를 만들지는 않으며, 서명이 필요한 모든 빌드 스크립트가 통과하는 것도 보장하지 않습니다.

5단계 / 자동화 연동

로컬 명령이 정상 작동한 뒤 runner를 등록하세요

코드 플랫폼에 맞춰 GitHub Actions 또는 GitLab Runner 중 하나를 선택하세요. 신뢰할 수 있는 브랜치에서 작업을 하나 실행해 서비스 사용자, 환경 변수, 키체인 접근을 확인한 뒤 정식 파이프라인에 연결하세요.

GitHub Actions: runner 등록 및 사용자 서비스 설치

저장소 또는 조직의 runner 설정에서 macOS와 ARM64를 선택하고, 플랫폼의 최신 안내에 따라 패키지를 다운로드해 검증한 뒤 별도 디렉터리에 압축을 푸세요. 아래 명령어는 압축을 푼 디렉터리에서 실행합니다. 등록 URL과 단기 토큰은 현재 설정 페이지에서 확인하세요.

read -r -p "Repository or organization URL: " RUNNER_URL
read -r -s -p "Registration token: " RUNNER_TOKEN
printf '\n'
./config.sh \
  --url "$RUNNER_URL" \
  --token "$RUNNER_TOKEN" \
  --labels armvnc,macos,arm64
unset RUNNER_TOKEN
./svc.sh install
./svc.sh start
./svc.sh status

워크플로에서는 runs-on: [self-hosted, macOS, ARM64, armvnc]를 사용하고 플랫폼에 표시된 실제 레이블을 확인하세요. 사용자 서비스의 시작 여부는 로그인 세션에 영향을 받습니다. 설치 후 다시 로그인하거나 재시동한 뒤에도 서비스가 복구되는지 검증하고, 등록이 성공했다고 모든 상태에서 작업이 실행된다고 간주하지 마세요.

GitLab Runner: shell executor 등록

먼저 프로젝트 또는 그룹 설정에서 runner를 만들고 인증 토큰을 받으세요. Homebrew가 설정되어 있으면 runner를 설치한 뒤 대화형 안내에 따라 등록할 수 있습니다. 서비스는 현재 사용자로 실행되므로 빌드 파일과 인증 정보도 해당 사용자가 관리해야 합니다.

brew install gitlab-runner
read -r -p "CI server URL: " CI_SERVER_URL
read -r -s -p "Runner authentication token: " RUNNER_TOKEN
printf '\n'
gitlab-runner register \
  --url "$CI_SERVER_URL" \
  --token "$RUNNER_TOKEN" \
  --executor shell \
  --description "ArmVNC macOS ARM64"
unset RUNNER_TOKEN
gitlab-runner install
gitlab-runner start
gitlab-runner status
gitlab-runner verify

플랫폼 설정에서 레이블과 보호 브랜치 정책을 구성하고, 파이프라인의 tags가 runner 레이블과 일치하는지 확인하세요. 사용자 서비스는 보통 로그인 세션에 의존합니다. 사용 중인 runner 버전의 안내에 따라 LaunchAgent와 시작 동작을 점검하고, 다른 서비스 관리 방식으로 같은 인스턴스를 중복 실행하지 마세요.

CI 첫 작업에 다음 네 가지를 추가하세요

  1. 다음을 출력하고 whoami , xcode-select -p 및 xcodebuild -version을 확인해 작업이 다른 환경에서 실행되고 있지 않은지 점검하세요.
  2. 툴체인 PATH를 명시적으로 불러오세요. 백그라운드 서비스는 대화형 터미널의 셸 설정을 읽지 않을 수 있습니다.
  3. 먼저 서명 없는 빌드를 실행한 다음, 통제된 키체인과 서명 단계를 설정하세요. 로그에 키, 비밀번호, 토큰을 출력하지 마세요.
  4. 결과물 전송 및 정리 정책을 설정하세요. 공개 출처의 검토되지 않은 코드를 서명 자료가 있는 runner에서 바로 실행하지 마세요.

노드는 연중 365일 운영되지만 CI 프로세스는 직접 관리해야 합니다. 로그아웃, 시스템 업데이트, 재시동 후 runner 서비스, 네트워크, 서명 환경이 모두 복구되었는지 확인하세요. 임대를 종료하기 전에 플랫폼에서 등록을 해제하고 인증 정보를 폐기한 뒤 결과물을 가져오세요.

용어를 실제 작업으로 이해하기

8가지 용어로 알아보는 제공 및 연결

개념의 중요도를 판단할 때는 리소스 소유, 연결 방식, 작업 실행, 여러 장비 간 협업 중 어떤 작업에 영향을 주는지 먼저 살펴보세요.

물리 노드
데이터센터에 있는 실제 Mac입니다. 콘솔은 이 장비의 연결 정보를 제공하며, 로컬 컴퓨터의 개발 환경을 제공하는 것은 아닙니다.
독립형 물리 머신
주문 하나가 Mac 한 대의 컴퓨팅 및 스토리지 리소스 전체를 단독으로 사용합니다. 작업 동시 실행, 의존성, 캐시는 직접 관리해야 합니다.
가상 머신이 아님
실제 물리 장비로 제공되며 네이티브 macOS를 사용합니다. 그래픽 인터페이스와 명령줄 모두 워크플로에 활용할 수 있습니다.
VNC
원격 그래픽 연결 프로토콜입니다. 다양한 운영체제에서 Mac 데스크톱을 보고 조작할 수 있으며, 사용 경험은 네트워크와 화질 설정에 따라 달라집니다.
화면 공유
macOS에 내장된 그래픽 원격 연결 방식입니다. Mac 클라이언트로 제공 정보를 사용해 노드 데스크톱에 연결할 수 있습니다.
self-hosted runner
직접 등록하고 관리하는 CI 실행 노드입니다. 코드 플랫폼이 작업을 전달하면 클라우드 Mac의 runner 프로세스가 빌드를 실행합니다.
통합 메모리
Apple Silicon에서 CPU와 GPU가 공유하는 메모리입니다. 모델, 빌드 작업, 시스템 프로세스가 함께 사용합니다.
Thunderbolt 5 연결 구성
Thunderbolt 5로 여러 장비를 연결하는 추가 구성으로, 장비별로 요금이 부과됩니다. 여러 Mac의 메모리를 하나의 주소 공간으로 자동 통합하지 않으며, 작업은 직접 오케스트레이션해야 합니다.
다음 단계 / 검증 결과에 따라 진행

빌드에 성공했다면 워크플로를 고정하세요

검증한 Xcode 버전, 의존성 잠금 파일, 빌드 명령어를 저장소에 기록하세요. 문제가 발생하면 연결, 툴체인, 프로젝트 중 어느 계층에서 생겼는지 먼저 파악한 뒤 최소 재현 정보를 준비해 문의하세요.

그래픽 연결 설정

VNC, 화면 공유, SSH의 적절한 사용 방법을 확인하고 해상도, 터널, 연결 끊김 후 재연결을 점검하세요. 연결 안내일 뿐, 원격 조작 기능을 제공하는 것은 아닙니다.

원격 연결 안내 읽기

장기 설정 결정

실제 프로젝트의 메모리 및 디스크 사용량을 확인하고, 4가지 임대 기간과 스토리지 추가 옵션을 비교해 상시 CI에 적합한 임대 방식을 정하세요.

임대 옵션 확인

실패한 단계 찾기

개통, 연결, 결제, 가동률 문제를 확인하세요. 지원 티켓에는 주문 번호, 노드 ID, 장애 시간대, 민감 정보를 삭제한 로그를 첨부하고 비밀번호는 포함하지 마세요.

도움말 센터 열기

실제 프로젝트로 첫 검증을 완료하세요

일 단위 임대로 시작해 연결, 의존성, archive를 먼저 확인하세요. USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원하며 USD로 결제됩니다.