첫 실행 경로

노드 선택부터 첫 빌드 실행까지

이 시작 가이드는 주문, 연결, 마이그레이션과 검수를 확인 가능한 작업으로 나눕니다. 먼저 구성과 접근 범위를 확인한 다음 코드와 빌드 도구를 배포해, 환경을 확인하기 전에 민감한 데이터를 기록하지 않도록 하세요.

01 용도와 구성 확인
02 제공 정보 검증
03 마이그레이션 후 빌드 실행
04 검수 및 보안 마무리
시작 전 준비

6가지 입력 정보를 먼저 정리한 후 머신을 선택하세요

지역, 메모리와 대여 기간은 이후 마이그레이션 방식에 직접 영향을 줍니다. 주문 후 조건을 급히 보완하기보다 간단한 실행 계획을 먼저 작성하는 편이 안전합니다.

워크플로와 지역

주요 작업이 Xcode 빌드, self-hosted runner, 로컬 모델 추론 또는 미디어 처리인지 명확히 적으세요. 그런 다음 싱가포르, 일본 도쿄, 한국 서울, 홍콩 네 노드 중 팀 또는 의존 서비스에 더 가까운 위치를 선택하세요.

검증 결과 용도와 목표 지역이 각각 명확하게 정해져 있습니다

모델과 대여 기간

단기 적용과 경량 빌드는 BookaMac M4를 먼저 검토할 수 있습니다. 고메모리 동시 작업, 모델 추론과 고부하 미디어 작업에는 BookaMac M4 Pro를 검토하세요. 대여 기간은 일, 주, 월 또는 분기 단위로 선택할 수 있습니다.

검증 결과 칩, 메모리, 저장 장치와 결제 주기가 기록되어 있습니다

연결 클라이언트 및 SSH 공개 키

사용 가능한 SSH 클라이언트와 VNC 클라이언트를 준비하고, 로컬에서 별도의 SSH 키 쌍을 생성한 뒤 공개 키만 제출하세요. 개인 키는 관리되는 장치에 보관하고 이메일이나 지원 요청으로 전송하지 마세요.

검증 결과 로컬 공개 키를 읽을 수 있고 개인 키 권한이 제한되어 있습니다
선택 및 주문

리소스 부하에 따라 두 가지 구성을 선택하고 모호한 라벨에 의존하지 마세요

두 플랜 모두 전용 물리 Mac mini이며 가상 머신이 아닙니다. 주문 생성 전에 모델, 노드, 대여 기간과 추가 저장 장치를 확인하세요. 콘솔은 현재 가용성과 최종 주문 정보를 실시간으로 반환합니다.

  • 모든 금액이 미국 달러(USD)로 결제되는지 확인하세요.
  • 지역이 팀 네트워크 경로 및 의존 서비스 위치와 일치하는지 확인하세요.
  • 대여 기간이 환경 설정, 작업 실행과 데이터 반출에 필요한 시간을 포함하는지 확인하세요.
  • 추가 저장 장치 또는 Thunderbolt 5 병렬 연결이 필요하다면 주문에서 별도로 확인하세요.
경량 및 단기 작업

BookaMac M4

$21.5/일
M4
메모리
16GB
저장 장치
256GB SSD
BookaMac M4 선택
고메모리 워크플로

BookaMac M4 Pro

$59.2/일
M4 Pro
메모리
64GB
저장 장치
2TB SSD
BookaMac M4 Pro 선택
수령 및 검증

연결하기 전에 제공 정보를 항목별로 대조하세요

제공 완료가 곧바로 데이터 기록을 시작해도 된다는 뜻은 아닙니다. 먼저 구성과 연결 범위를 검증한 후 비공개 저장소를 가져오거나 서명 자료를 가져오세요.

DELIVERY CHECK

노드 제공 검증 체크리스트

사용자 확인 필요
A

노드 지역

주문 선택 지역과 제공 페이지에 표시된 지역이 일치하는지 확인하세요. 연결 속도만으로 노드 위치를 판단하지 마세요.

B

장치 구성

시스템 정보에서 칩, 메모리와 저장 장치 용량을 확인하고 주문 확인 페이지와 항목별로 대조하세요.

C

연결 주소

SSH 주소, 포트, 사용자 이름과 호스트 지문의 출처를 확인하고 첫 연결 시 검증 결과를 저장하세요.

D

초기 접근 안내

임시 자격 증명의 사용 범위, 교체 절차와 접근 경로를 확인하고 여러 사람이 사용하는 채널에 전체 자격 증명을 전달하지 마세요.

마이그레이션 경로

데이터, 도구 체인, CI의 세 단계로 진행하세요

각 단계에 입력, 작업과 검증 결과를 정의하세요. 이전 단계가 통과하지 않았다면 더 많은 저장소, 자격 증명 또는 작업을 노드로 옮기지 않는 것이 좋습니다.

  1. 01 데이터 단계

    작업에 필요한 저장소와 리소스만 동기화

    먼저 독립적으로 빌드할 수 있는 저장소 하나를 가져오고 브랜치, 커밋 해시, 서브모듈과 대용량 리소스를 검증하세요. 의존성 캐시는 필요할 때 다시 생성하고 출처가 불명확한 전체 머신 캐시를 그대로 복사하지 마세요.

    입력
    저장소 주소, 대상 커밋, 리소스 목록
    작업
    가져오기, 해시 검증, 파일 권한 확인
    통과 조건
    코드와 필수 리소스가 완전하며 관련 없는 데이터가 추가로 유입되지 않음
  2. 02 도구 체인 단계

    Xcode, 의존성과 명령 버전 재현

    현재 개발자 디렉터리를 확인하고 프로젝트에 명시된 명령줄 도구를 설치한 다음 잠금 파일로 의존성을 복원하세요. 먼저 모든 도구를 전역 업그레이드한 뒤 빌드 차이를 설명하려 하지 마세요.

    입력
    Xcode 기준 버전, 잠금 파일, 빌드 스크립트
    작업
    도구 체인 선택, 의존성 복원, 클린 빌드 실행
    통과 조건
    버전이 기준과 일치하고 최소 대상 빌드가 성공함
  3. 03 CI 단계

    runner를 등록한 후 검증 작업을 실행하세요

    노드에 명확한 라벨을 설정하고 작업 디렉터리를 격리하며 동시 실행 수를 제한하세요. 먼저 릴리스 작업이 없는 검증 파이프라인을 실행하세요. 로그에 키, 토큰 또는 전체 서명 자료를 출력해서는 안 됩니다.

    입력
    runner 등록 정보, 라벨, 검증 작업
    작업
    등록, 디렉터리 격리, 테스트 파이프라인 실행
    통과 조건
    작업을 반복 실행할 수 있고 종료 코드와 산출물 경로가 명확함
첫 빌드

짧은 명령 몇 개로 연결, 도구 체인과 릴리스 환경을 확인하세요

오른쪽 기록에는 사용 문서의 예시 주소가 표시됩니다. 실제 작업에서는 제공 페이지의 연결 주소, 사용자 이름, 프로젝트 작업 공간과 빌드 대상을 기준으로 삼으세요.

  • SSH로 처음 연결하기 전에 호스트 지문을 확인하고 이상 알림을 건너뛰지 마세요.
  • 먼저 현재 개발자 디렉터리를 확인한 후 Xcode 전환 여부를 결정하세요.
  • 첫 빌드에서는 전체 로그와 종료 코드를 보존하고 마지막 몇 줄만 저장하지 마세요.
  • fastlane 환경 확인은 구성 파일을 읽을 수 있는지만 검증하며 릴리스 작업을 직접 실행하지 않습니다.
연결 및 빌드 문서 보기
first-build.session
$ ssh build@203.0.113.24
The authenticity of host is confirmed.
Connected to dedicated Mac node

$ xcode-select -p
/Applications/Xcode.app/Contents/Developer

$ xcodebuild \
  -workspace Sample.xcworkspace \
  -scheme Sample \
  -configuration Debug \
  build
** BUILD SUCCEEDED **

$ bundle exec fastlane env
System Locale: zh_CN
Xcode Path: /Applications/Xcode.app
Environment check completed
그래픽 인터페이스 액세스

원격 데스크톱은 그래픽 인터페이스가 필요한 작업에만 사용하세요

일상적인 자동화에는 SSH를 우선 사용하고, Xcode 인터페이스, 시뮬레이터 또는 그래픽 도구를 확인해야 할 때만 VNC 클라이언트로 세션을 연결하세요.

01 / 클라이언트

제공된 매개변수로 연결 구성

신뢰할 수 있는 VNC 클라이언트를 사용해 제공 페이지의 주소, 포트와 자격 증명을 입력하세요. 연결 구성을 공용 동기화 디렉터리로 내보내거나 클라이언트가 공유 자격 증명을 영구 저장하도록 하지 마세요.

02 / 디스플레이

안정적인 설정부터 시작한 후 화질을 높이세요

첫 연결은 적절한 해상도와 색상 품질로 시작하세요. 작업 지연이 뚜렷하면 먼저 화질을 낮추고 로컬 네트워크를 확인하세요. 빌드 시간과 화면 새로 고침 지연을 같은 문제로 보지 마세요.

03 / 클립보드

필요한 비민감 텍스트만 복사하세요

클립보드 동기화는 짧은 명령과 일반 텍스트에 적합하며 개인 키, 전체 액세스 토큰 또는 비식별화되지 않은 자격 증명을 전송해서는 안 됩니다. 민감한 구성이 포함되면 관리되는 파일 절차를 사용하고 권한을 확인하세요.

04 / 종료

유휴 상태에서는 세션을 종료하고 화면을 잠그세요

그래픽 작업을 마친 후 관련 도구를 종료하고 macOS 그래픽 인터페이스를 잠근 다음 VNC 세션을 끊으세요. 장시간 작업은 계속 열어 둔 데스크톱 창에 의존하지 말고 스크립트나 runner가 관리해야 합니다.

첫 작업 검수

반복 가능한 결과로 노드 사용 가능 여부를 판단하세요

로그인할 수 있다는 것은 연결이 통과했다는 뜻일 뿐입니다. 실제 검수는 코드, 의존성, 빌드, 로그와 네트워크의 다섯 가지 측면을 포함하고 다음에 재사용할 수 있는 기준을 남겨야 합니다.

항목 하나가 실패하면 먼저 명령, 종료 코드, 시점과 관련 로그를 기록한 다음 변수를 줄이세요. Xcode, 의존성 버전과 네트워크 구성을 동시에 바꾸면 실제 원인을 판단하기 어렵습니다.

PASS 01

코드 가져오기

대상 브랜치와 커밋 해시가 정확하고 서브모듈과 대용량 리소스가 완전합니다.

PASS 02

의존성 설치

잠금 파일이 적용되고 설치 명령을 반복 실행할 수 있으며 주요 의존성이 예기치 않게 업그레이드되지 않았습니다.

PASS 03

빌드 산출물

지정한 대상이 성공적으로 빌드되고 산출물 위치, 크기와 생성 방식을 추적할 수 있습니다.

PASS 04

로그 보관

전체 로그가 보관되고 민감한 필드가 비식별화되었으며 종료 코드와 작업 식별자가 명확합니다.

PASS 05

네트워크 액세스

프로젝트에 필요한 저장소와 의존성 엔드포인트에 연결할 수 있고 작업과 무관한 접근 범위가 열려 있지 않습니다.

제공 후 보안 체크리스트

노드를 일상적으로 사용하기 전에 보안을 마무리하세요

첫 검수 직후 보안 설정을 완료하고 팀 인계, runner 조정과 대여 기간 종료 전에 다시 확인하세요.

임시 자격 증명 교체

첫 검증이 완료되면 임시 비밀번호나 액세스 자격 증명을 교체하고 이전 자격 증명을 더 이상 사용할 수 없는지 확인하세요.

키 기반 로그인 활성화

별도의 SSH 공개 키를 사용하고 authorized_keys를 확인하며 로컬 개인 키 파일 권한을 제한하세요.

공유 계정 제한

구성원에게 추적 가능한 접근 방식을 할당하고 여러 사람이 동일한 관리자 계정을 장기간 공유하지 않도록 하세요.

불필요한 파일 삭제

테스트 아카이브, 임시 다운로드, 만료된 캐시와 더 이상 사용하지 않는 자격 증명 사본을 정리하고 남은 용량을 다시 확인하세요.

환경 변경 기록

Xcode 전환, 의존성 업그레이드, runner 라벨과 네트워크 변경을 기록해 다음 문제 해결의 근거를 남기세요.

종료 계획 준비

빌드 산출물, 저장소 변경 사항과 필요한 로그를 반출할 위치를 정하고 데이터 정리를 대여 기간 종료 후로 미루지 마세요.

시작할 준비

구성을 선택한 후 체크리스트에 따라 첫 실행을 완료하세요

주문, 갱신과 호스트 관리는 모두 콘솔에서 처리합니다. 결제는 USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원하며 모든 금액은 미국 달러(USD)로 결제됩니다. 실제 사용 가능한 결제 게이트웨이는 백엔드 응답을 따릅니다.