작업별 준비 사항과 완료 여부 확인

주문부터 첫 데스크톱 접속까지

아시아·태평양과 북미에 있는 팀원이 함께 사용할 수 있는 작업 가이드입니다. 먼저 주문과 노드를 확인한 다음 전용 물리 Mac에 연결하세요. 작업이 진행되지 않으면 발생 시각과 오류 메시지를 기록하고 해당 단계부터 확인하세요.

주문한 사용자는 콘솔에서 인스턴스 상세 정보를 확인할 수 있습니다. 처음 이용할 때는 최신 브라우저와 안정적인 네트워크를 준비하세요.

첫 연결

주문, 노드, 데스크톱이 일치하는지 확인하세요

결제가 완료되면 인스턴스 과금이 시작됩니다. 데스크톱에 접속하기 전에 인스턴스 정보를 확인하세요. 결제 완료 화면만으로 데스크톱에 연결할 수 있다고 판단하지 마세요.

  1. 주문한 계정으로 로그인

    준비 사항: 주문을 완료했고 주문에 사용한 이메일에 접근할 수 있어야 합니다. 콘솔을 열어 해당 이메일로 로그인한 다음 인스턴스 목록으로 이동하세요.

    완료 기준: 해당 주문과 인스턴스를 찾을 수 있어야 합니다. 목록이 예상과 다르면 현재 로그인한 이메일, 결제 결과, 주문 내역을 먼저 확인하세요. 문의를 제출하기 전에 주문 번호를 기록하고, 문제 해결을 위해 중복 주문은 하지 마세요.

  2. 지역 및 상태 확인

    준비 사항: 인스턴스가 목록에 표시되어야 합니다. 상세 정보에서 인스턴스 ID, 선택한 노드, 현재 상태를 확인하세요. 사용 가능 여부는 콘솔에 실시간으로 표시되는 상태를 기준으로 판단하세요.

    완료 기준: 노드가 주문 내역과 일치하고 상세 정보에 연결 방법이 표시되어야 합니다. 인스턴스가 준비되지 않았다면 상태 안내를 먼저 확인하세요. 상태가 주문과 다르면 안내 문구와 시각을 기록하고 여러 작업을 연달아 실행하지 마세요.

  3. 브라우저에서 macOS에 접속

    준비 사항: 인스턴스 상세 정보에서 연결할 수 있어야 합니다. ‘데스크톱 열기’를 클릭하고 브라우저에서 새 탭을 열도록 허용하세요. 새 탭에서 macOS 전체를 조작할 수 있으며 데스크톱 클라이언트는 설치할 필요가 없습니다.

    완료 기준: 데스크톱 화면이 표시되고 키보드와 마우스가 반응해야 합니다. 새 탭이 열리지 않으면 브라우저가 팝업을 차단했는지 확인하세요. 페이지는 열리지만 연결되지 않으면 안내 문구를 기록한 뒤 아래 네트워크 문제 해결 단계를 확인하세요.

명령줄 작업

빌드와 스크립트에는 SSH를 사용하세요

브라우저 데스크톱은 그래픽 작업에, SSH는 터미널 명령과 빌드 스크립트 실행, 로그 확인에 적합합니다. 두 방식 모두 동일한 전용 물리 Mac에 연결되며 서로 분리된 환경이 아닙니다.

인스턴스 상세 정보에서 연결 매개변수 확인

콘솔에 로그인해 대상 인스턴스의 상세 정보를 열고 현재 연결 주소, 사용자 이름, 포트, 인증 정보를 확인하세요. 다른 인스턴스의 주소나 이전 연결 기록, 예시 명령을 현재 인스턴스의 매개변수로 사용하지 마세요.

로컬 터미널에서 실제 매개변수를 넣어 오른쪽 형식의 명령을 실행하세요. 꺾쇠괄호 안의 값은 꺾쇠괄호를 포함해 전체를 바꿔 입력해야 합니다. 사용할 인증 방식은 인스턴스 상세 정보에 표시된 내용을 따르세요.

처음 연결할 때 호스트 신원을 확인하라는 메시지가 표시되면 인스턴스와 연결 정보를 먼저 대조하세요. 저장된 호스트 정보가 갑자기 바뀌었다면 확인 절차를 건너뛰지 마세요. 연결 대상이 맞는지 확인한 뒤 터미널 안내에 따라 진행하세요.

완료 기준: 원격 세션에 접속해 기본 명령을 실행하고 현재 사용자와 작업 디렉터리를 확인할 수 있어야 합니다. 장시간 작업을 시작하기 전에 인스턴스 이용 가능 시간과 로그 저장 위치를 확인하세요.

연결 명령 형식

ssh -p <포트> <사용자 이름>@<연결 주소>

로그인 후 실행 환경을 확인하세요:

whoami
pwd
sw_vers
xcode-select -p

이 명령은 사용자, 디렉터리, 시스템 버전, 명령줄 도구 경로를 확인하며 소프트웨어를 설치하지 않습니다. 빌드가 실패하면 관련 출력과 오류 로그를 함께 보관하세요. 스크린샷에 비밀번호, 개인 키 또는 기타 연결 인증 정보가 노출되지 않도록 주의하세요.

어디에서 연결이 느려지는지 먼저 확인하세요

거리, 접속 네트워크, 이전 순서대로 확인하세요

화면 끊김, 파일 전송 속도 저하, 빌드 시간 증가는 서로 다른 문제입니다. 먼저 느려지는 작업을 기록한 뒤 한 번에 한 가지 조건만 바꿔 비교하세요. 네트워크와 도구를 동시에 바꾸거나 프로젝트를 수정하지 마세요.

  1. 사용자와 노드 사이의 거리 확인

    데스크톱을 직접 조작하는 팀원의 위치를 기준으로 삼으세요. 회사 등록 지역만 기준으로 판단하지 마세요. 선택 가능한 노드는 싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 서부 등 총 5곳입니다.

    그래픽 작업이 많다면 가까운 노드를 우선 고려하세요. 빌드가 주된 작업이라면 코드, 종속성, 빌드 결과물의 전송 경로도 확인해야 합니다. 노드별 구간은 참고용이며 실제 성능은 접속 네트워크에 따라 달라집니다. 측정하지 않은 지연 시간 수치는 제공하지 않습니다.

  2. 로컬 네트워크 조건을 하나씩 바꿔 보세요

    대용량 업로드·다운로드와 대역폭을 사용하는 다른 작업을 잠시 중단하세요. 같은 인스턴스, 같은 브라우저, 같은 작업을 유지한 채 데스크톱 반응을 확인하세요. 가능하다면 신뢰할 수 있는 다른 네트워크와 비교해 보세요.

    네트워크 유형, 프록시 사용 여부, 끊김이 발생한 시간대, SSH에도 영향이 있는지를 변경 전후로 기록하세요. 특정 브라우저 탭에서만 문제가 발생하면 브라우저 안내를 먼저 확인하세요. 컴파일만 느리다면 빌드 로그와 프로젝트 작업을 확인하세요.

  3. 대상 노드에서 새 인스턴스 확인

    주 사용자가 다른 지역으로 장기간 옮긴 경우 가까운 노드에 새 인스턴스를 만들고 이전 체크리스트에 따라 프로젝트를 옮긴 뒤 데스크톱과 빌드를 확인하세요. 노드 변경은 기존 인스턴스를 한 번에 다른 지역으로 옮기는 기능이 아닙니다.

    새 인스턴스 검증이 끝날 때까지 기존 데이터와 복구 경로를 유지하세요. 코드, 도구 버전, 빌드 결과물이 서로 일치하는지 확인한 뒤 인수인계를 진행하세요. 인스턴스는 각각 별도로 과금되므로 추가하기 전에 예산을 확인하세요.

로컬 환경을 클라우드로 이전

데이터 이전, 도구 버전 통일, CI 연동 순으로 진행하세요

이전 완료 여부는 ‘파일 전송 완료’만으로 판단할 수 없습니다. 대상 컴퓨터에서 지정된 커밋으로 검증 가능한 결과물을 생성할 수 있어야 합니다. 세 단계를 순서대로 확인하고 앞 단계가 완료된 뒤 다음 단계로 넘어가세요.

01 · 데이터

프로젝트와 서명 자료를 대상 Mac으로 옮기기

준비 사항: 이전할 코드를 로컬에서 커밋했고 관련 서명 자료를 사용할 권한이 있어야 합니다. 먼저 저장소 주소, 브랜치, 커밋 ID, 저장소에 포함되지 않은 리소스의 위치를 기록하세요.

  • 프로젝트 저장소를 가져온 뒤 브랜치와 커밋 ID를 확인하세요.
  • 프로젝트에 필요한 리소스, 서명 인증서, 프로비저닝 프로파일을 이전하세요.
  • 민감한 자료는 접근이 통제된 방식으로 전달하고 공개 저장소나 문의 스크린샷에 포함하지 마세요.

완료 기준: 프로젝트가 열리고 리소스가 모두 있으며 빌드 프로세스가 서명 자료를 인식해야 합니다.

02 · 도구 체인

로컬과 클라우드의 버전을 일치시키세요

준비 사항: 로컬에서 사용할 수 있는 Xcode, 명령줄 도구, 종속성 관리자의 버전을 기록해야 합니다. 최신 버전이라는 이유만으로 선택하지 말고 클라우드 환경을 먼저 확인한 다음 필요한 버전을 설치하거나 전환하세요.

  • Xcode 버전과 명령줄 도구 선택 경로를 확인하세요.
  • 프로젝트 요구 사항에 맞는 종속성 관리자와 실행 환경을 준비하세요.
  • 종속성 잠금 파일을 그대로 사용하고 전체 빌드 로그를 저장하세요.

완료 기준: 대상 컴퓨터에서 동일한 커밋을 수동으로 빌드할 수 있고 로그에서 도구 버전과 결과물을 확인할 수 있어야 합니다.

03 · CI 연동

검증을 마친 컴퓨터를 빌드 머신으로 등록하세요

준비 사항: 수동 빌드가 성공했고 팀 CI 시스템을 설정할 권한이 있어야 합니다. 팀에서 사용하는 CI 도구에 빌드 머신을 등록하고 자동화 작업이 대상 환경을 사용하도록 설정하세요.

  • 실행 사용자, 작업 디렉터리, 필요한 환경 변수를 설정하세요.
  • 인증 정보 접근 방식, 작업 태그, 결과물 경로를 설정하세요.
  • 검증 작업을 먼저 실행한 뒤 정식 파이프라인에 추가하세요.

완료 기준: CI 작업이 완료되고 로그, 결과물, 커밋 ID를 추적할 수 있으며 다음 팀원이 같은 작업을 재현할 수 있어야 합니다.

시간대별 인수인계

다음 담당자가 이어서 작업할 수 있도록 맥락을 남기세요

각 Mac mini는 한 고객에게만 할당되며 CPU와 메모리를 다른 고객과 공유하지 않습니다. 다만 팀 내부에서는 작업 순서를 조율해야 합니다. 전용 머신이라고 해서 여러 팀원이 같은 환경을 서로 간섭 없이 수정할 수 있는 것은 아닙니다.

시간대가 다른 팀원 간 작업 인수인계를 설명하기 위해 계획과 기록을 정리하는 작업대 장면
인수인계 기록은 작업에 맞춰 업데이트하세요. ‘머신 사용 가능’이라는 한마디만 남기지 마세요.

자리를 비우기 전에 네 가지를 기록하세요

  • 코드 위치:완료한 변경 사항을 커밋하고 저장소, 브랜치, 커밋 ID를 적으세요. 커밋하지 않은 파일은 따로 나열해 다음 담당자가 실수로 덮어쓰지 않도록 하세요.
  • 실행 중인 작업:진행 중인 빌드, 스크립트, 프로세스와 로그 위치를 기록하고 중단할 수 있는지 설명하세요. 브라우저를 닫았다고 작업도 중단된 것은 아닙니다.
  • 환경 변경:Xcode, 종속성, 환경 변수, 작업 디렉터리의 변경 사항을 기록하세요. 전역 도구 경로를 바꾸기 전에 다른 작업이 기존 경로에 의존하지 않는지 확인하세요.
  • 다음 담당자의 작업:다음에 실행할 명령, 예상 결과물, 확인 방법을 적고 인수인계가 이루어진 시간대를 표시하세요.

발생 시각은 ‘년·월·일, 시:분, UTC 오프셋’ 형식으로 온전히 적어 주세요. ‘어젯밤’이나 ‘아침’처럼 모호한 표현은 피하세요. 아시아·태평양과 미국 서부에 있는 팀원이 자주 동시에 작업한다면 각자 가까운 인스턴스를 사용할 수 있습니다. 버전 기록을 통해 환경은 일관되게 유지하세요.

서비스 기간 및 청구

만료 전에 갱신하고 변경 전에는 비용을 확인하세요

과금 주기는 일간, 주간, 월간, 분기별 중에서 선택할 수 있으며 결제가 완료되면 인스턴스 과금이 시작됩니다. 5개 노드의 요금은 동일합니다. 구성과 추가 옵션의 가격은 요금제 목록을 기준으로 하며 결제 전에 주문 내역을 다시 확인하세요.

갱신 및 데이터 준비

콘솔에서 인스턴스 만료 시각과 갱신 옵션을 확인하고 만료 전에 결제를 완료한 뒤 서비스 기간이 업데이트되었는지 확인하세요. 청구서가 생성된 것만으로 갱신이 완료된 것은 아닙니다.

다음 과금 주기를 변경하려면 먼저 콘솔에서 제공하는 옵션을 확인하세요. 확인하기 어렵다면 인스턴스 ID와 원하는 주기를 적어 문의를 제출하세요. 만료 전에 코드, 서명 자료, 빌드 결과물을 직접 백업하세요. 인스턴스 디스크를 유일한 백업으로 사용하지 마세요.

이용 기간 중 옵션 추가 및 구성 변경

선택 가능한 추가 옵션에는 +1TB SSD, +2TB SSD, Thunderbolt 5 병렬 연결이 포함됩니다. 추가 옵션은 호스트와 동일한 주기로 과금됩니다. 실제 선택 가능 옵션과 적용 정보는 콘솔에 표시되는 내용을 기준으로 확인하세요.

이용 기간 중 옵션 추가, 추가 항목 취소, 구성 변경을 신청할 때는 주문 금액과 적용 일정을 먼저 확인하세요. 남은 일수만큼 자동으로 정산된다고 가정하지 말고 취소 신청을 즉시 환불로 해석하지 마세요. 변경으로 데이터에 영향을 줄 수 있다면 먼저 백업하세요.

결제, 거래 내역 및 청구서 문의

결제 수단은 USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원하며 모든 금액은 미국 달러(USD)로 결제됩니다. 실제 이용 가능한 결제 게이트웨이는 백엔드에서 반환하는 정보를 기준으로 합니다.

결제에 문제가 발생하면 주문 번호, 금액, 결제 시각, 거래 내역을 보관하고 청구 상태를 확인한 뒤 문의를 제출하세요. 청구서나 결제 관련 자료가 필요하면 해당 주문과 필요한 청구서 정보를 함께 알려 주세요. 지원팀이 제공 가능한 자료를 확인합니다. 카드 번호 전체나 카드 보안 코드는 보내지 마세요.

문제 해결 기록을 함께 보내세요

당시 상황을 파악할 수 있도록 문의를 작성하세요

콘솔에 로그인해 문의를 제출하고 아래 순서에 따라 정보를 정리하세요. 문의는 접수된 순서대로 처리됩니다. 확인되지 않은 응답 시간은 약속하지 않습니다.

제출 전에 다음 정보를 확인하세요

인스턴스 및 노드
인스턴스 ID, 선택한 노드, 관련 주문 번호를 적으세요. 모델명만 적지 마세요.
발생 시간대
시작 시각, 문제가 계속되는지 여부, 가장 최근에 재현된 시각을 적고 UTC 오프셋을 표시하세요.
작업 내용 및 예상 결과
어떤 페이지나 명령에서 시작했는지, 예상한 결과와 실제로 확인한 내용을 적으세요.
오류 및 스크린샷
오류 메시지 원문, 필요한 로그, 스크린샷을 보관하세요. 비밀번호, 키, 민감한 프로젝트 정보는 가리세요.
이미 확인한 사항
접속 네트워크 변경 여부, 인스턴스 상태 확인 여부, 재현 명령을 적어 같은 작업을 반복하지 않도록 하세요.

가동률은 99.9%를 보장하며 30일 기준 허용 중단 시간은 약 43분입니다. 서비스 시간 보상을 신청하려면 콘솔 문의에 인스턴스 ID와 중단 시간을 함께 첨부하세요. 허용 시간을 초과한 중단 시간은 비례 계산해 서비스 시간으로 보상합니다.

인스턴스와 발생 시간대를 문의에 포함하세요

주문 후 발생한 문제는 콘솔에서 문의로 제출하세요. 구매 전 노드 상담이 필요하거나 로그인할 수 없다면 연락 안내를 확인하고 support@macudp.com으로 문의하세요.