GPUMini 도움말 센터

문제를 먼저 특정한 다음 증거를 바탕으로 하나씩 점검하세요

GPUMini 클라우드 Mac의 독점 물리 노드 연결, 빌드, 네트워크, 스토리지 및 청구 문제를 다룹니다. 오류 메시지, 도구 이름 또는 청구 항목을 입력하면 가장 관련성 높은 해결 경로를 안내합니다.

6개자주 찾는 문제
5단계표준 점검 순서
2가지지원 문의 방법
진단 작업표 SUPPORT / 01
A

대상 확인노드, 계정, 주문 또는 빌드 작업

B

증거 보존시간, 명령어, 오류 행 및 비식별화 로그

C

범위 좁히기네트워크, 자격 증명, 디스크 또는 도구 체인

SG · JP · KR · HK 지원 독점 물리 노드
작업별로 시작하기

6가지 문제 유형, 각기 다른 첫 점검 항목

연결 실패가 반드시 네트워크 문제인 것은 아니며, 빌드 실패가 반드시 Xcode 문제인 것도 아닙니다. 먼저 작업에 맞는 항목을 선택한 다음 해당 문제를 구분하는 핵심 증거를 확인하세요.

연결

원격 연결

노드 주소, 포트, 클라이언트 네트워크, 호스트 검증 및 원격 Mac 데스크톱 설정을 확인합니다. 시간 초과, 검은 화면, 클립보드 동기화 문제와 입력 지연에 적합합니다.

연결 점검 경로 보기
계정

계정 및 권한

로그인 이메일, 인스턴스 소유 관계, 임시 자격 증명 업데이트 여부와 명령어 또는 디렉터리에 필요한 로컬 권한을 확인합니다. 지원 요청에 비밀번호를 제출하지 마세요.

권한 확인 항목 보기
빌드

Xcode 빌드

Xcode 경로, SDK, Scheme, 워크스페이스, 종속성 캐시 및 디스크 공간을 확인하고 xcodebuild의 전체 종료 코드와 최초 오류 위치를 보존하세요.

빌드 진단 방법 보기
자동화

Fastlane

Ruby 환경, Bundler, lane 매개변수, 환경 변수 및 서명 자료 문제를 구분합니다. 마지막 줄만 잘라내기보다 실패한 단계 이름을 우선 기록하세요.

자동화 로그 핵심 보기
네트워크

네트워크 진단

지연 시간, 지터, 패킷 손실 및 대상 포트 연결성을 각각 측정합니다. ping 한 번만으로 회선을 판단하지 말고 로컬 네트워크와 다른 접속 네트워크도 비교하세요.

네트워크 측정 순서 보기
청구

스토리지 및 청구

기본 요금제, 대여 기간, 노드, 스토리지 확장 및 Thunderbolt 5 병렬 연결 항목을 구분하고 주문 확인 페이지와 청구서의 각 금액을 대조하세요.

청구 대조 방법 보기
지식 경로

추측이 아니라 증상에서 시작하세요

아래 6개 경로는 페이지에 모두 표시됩니다. 분류 버튼은 위치 지정과 강조 표시만 수행하며 다른 콘텐츠를 숨기지 않으므로 인접한 문제를 함께 비교할 수 있습니다.

SSH 시간 초과 또는 원격 Mac 데스크톱 세션을 시작할 수 없음

먼저 콘솔에서 인스턴스가 연결 가능한 상태인지 확인하고 노드 주소와 포트를 한 글자씩 대조하세요. 그런 다음 로컬에서 포트 연결성 테스트를 실행합니다. 포트에 연결할 수 없다면 로컬 네트워크를 한 번 변경해 노드 문제와 접속 회선 문제를 구분하세요. SSH 최초 연결 시 호스트 지문을 확인하고, 자격 증명 오류가 발생하면 사용자 이름, 키 경로 및 파일 권한을 점검하세요. 그래픽 세션이 연결되었지만 검은 화면이 나타나면 먼저 해상도와 동적 효과를 낮춘 뒤 기존 세션을 종료하고 다시 연결하세요.

  • 클라이언트 운영체제, 연결 도구 이름 및 버전을 기록하세요.
  • 시간 초과, 연결 거부 또는 인증 실패의 전체 오류 행을 보존하세요.
  • 지연 시간이 높을 때는 ping의 중앙값, 지터 및 패킷 손실을 함께 기록하고 단일 결과만 제출하지 마세요.
원격 Mac 연결 가이드 열기

노드에는 로그인되지만 명령어, 디렉터리 또는 프로젝트 작업이 거부됨

실패가 콘솔 로그인, 로컬 로그인 또는 특정 명령어의 권한 검사 중 어디에서 발생했는지 먼저 판단하세요. 콘솔에서는 주문, 인스턴스, 청구서 및 티켓을 확인하고, 노드 내부의 로컬 권한은 현재 사용자, 디렉터리 소유자 및 명령어 요구 사항에 따라 결정됩니다. Permission denied가 표시되면 대상 경로, 실행한 명령어 및 현재 사용자를 기록하세요. 프로젝트 디렉터리 전체의 권한을 반복해서 변경하지 마세요. 임시 자격 증명으로 최초 로그인한 후에는 즉시 업데이트하고 공용 기기에 연결 정보를 저장하지 마세요.

  • 현재 작업이 올바른 인스턴스와 로그인 이메일에 해당하는지 확인하세요.
  • 다음 명령어를 사용해 whoamipwd 와 디렉터리 권한 정보를 확인하여 실행 컨텍스트를 파악하세요.
  • 지원팀에 정보를 제출할 때 비밀번호, 개인 키 또는 비식별화하지 않은 액세스 토큰을 첨부하지 마세요.
콘솔에서 인스턴스 확인

xcodebuild에서 Scheme, SDK 또는 대상 기기를 찾지 못함

먼저 명령어가 프로젝트 루트 디렉터리에서 실행되는지 확인하고 .xcodeproj.xcworkspace를 구분하세요. 그런 다음 Xcode 선택 경로와 사용 가능한 SDK를 출력하고 Scheme의 공유 여부 및 이름의 대소문자가 일치하는지 확인하세요. 종속성 업데이트 후 문제가 발생했다면 먼저 모든 캐시를 삭제하지 말고 최초 실패 로그를 보존한 뒤 명확한 첫 오류를 찾고 DerivedData를 정리하거나 종속성을 다시 확인할지 결정하세요.

  • 전체 명령어, 작업 디렉터리, Xcode 버전 및 종료 코드를 기록하세요.
  • 목록 명령어로 워크스페이스, Scheme 및 사용 가능한 destination을 확인하세요.
  • 빌드가 갑자기 중단되면 남은 디스크 공간, 임시 디렉터리 및 종속성 캐시 크기를 확인하세요.
최초 환경 확인 순서 보기

Fastlane이 종속성 로드, lane 실행 또는 내보내기 단계에서 중단됨

먼저 프로젝트 규칙에서 시스템 명령어를 사용하는지 bundle exec fastlane을 사용하는지 확인하고 Ruby, Bundler 및 Gemfile.lock이 서로 맞는지 점검하세요. 로그의 마지막 줄은 대개 프로세스 종료 안내일 뿐이며 실제 원인은 더 앞에 나타납니다. 첫 오류 블록부터 위쪽 컨텍스트를 보존하고 실패한 lane, action 및 매개변수 출처를 표시하세요. 환경 변수는 이름과 존재 여부만 제출하고 실제 값은 제출하지 마세요.

  • 종속성 단계에서 실패하면 Ruby, Bundler 및 Fastlane 버전을 기록하세요.
  • 빌드 action이 실패하면 하위 xcodebuild 종료 코드도 함께 보존하세요.
  • 반복 작업에서는 매번 같은 단계에서 중단되는지, 캐시를 정리한 뒤 변화가 있는지 기록하세요.
지원 체크리스트에 따라 문제 정리

연결 속도가 느려지거나 화면이 끊기거나 파일 전송이 불안정함

원격 사용 환경은 지연 시간, 지터, 패킷 손실 및 가용 대역폭의 영향을 함께 받습니다. 먼저 평소 사용하는 위치에서 싱가포르, 일본 도쿄, 한국 서울 및 홍콩 노드를 각각 테스트하고 중앙 지연 시간이 낮으며 지터가 작은 경로를 선택하세요. 테스트 시 로컬 네트워크, 시간대 및 샘플 수를 고정하세요. 무선 네트워크 결과의 변동이 크다면 유선 네트워크나 다른 접속 네트워크로 다시 테스트하세요. 그래픽 세션에서는 해상도, 색 품질 및 동적 효과를 낮추고, 명령어와 장시간 작업은 SSH로 분리하는 것이 좋습니다.

  • 단일 최저 지연 시간이 아니라 연속 샘플을 한 세트 이상 보존하세요.
  • 웹 접속, SSH, 데스크톱 세션 및 파일 전송 중 어떤 항목에서 문제가 발생했는지 각각 설명하세요.
  • 로컬 접속 지역, 네트워크 유형, 대상 노드 및 문제가 발생한 시간대를 기록하세요.
4개 노드 비교

기본 요금제, 대여 기간 및 추가 항목 대조

청구 대조는 주문 확인 페이지를 한 줄씩 기준으로 진행하세요. 먼저 GPUMini M4 Core 또는 GPUMini M4 Plus를 확인한 다음 일·주·월·분기 단위 기간, 대상 노드, 스토리지 확장 또는 Thunderbolt 5 병렬 연결 추가 여부를 대조하세요. 청구서의 총액만 비교하지 마세요. 총액이 같아도 기간과 추가 항목 조합이 다를 수 있습니다. 모든 금액은 미국 달러로 결제되며, 결제 방법은 USDT-TRC20 또는 Stripe를 통한 Visa, Mastercard, Amex입니다. 실제 이용 가능한 결제 게이트웨이는 결제 화면의 안내를 따릅니다.

  • 주문 번호, 청구 항목 이름 및 확인이 필요한 행을 기록하고 전체 결제 정보를 제출하지 마세요.
  • 인스턴스 디스크 부족은 운영 문제이므로 남은 공간과 주요 디렉터리 사용량도 함께 제출하세요.
  • 청구 항목이 예상과 다르면 주문 확인 페이지와 청구서 행의 텍스트 정보를 첨부하세요.
요금제 및 추가 항목 기준 보기
명령어 증거

마지막 줄만 복사하지 말고 최초 실패 지점을 보존하세요

SSH, xcodebuild 및 Fastlane의 마지막 부분에는 ‘작업 실패’만 표시될 수 있습니다. 실제 판단에 필요한 정보는 대개 최초 오류 위치와 그 앞뒤 몇 줄에 있습니다.

gpumini-diagnostics — zsh 읽기 전용
$ ssh -v build@node.example
debug1: Connecting to node [port 22]
debug1: Server host key verified
Permission denied (publickey).
↑ 일반적인 실패 위치: 사용자 이름, 키 경로 또는 키 권한

$ xcodebuild -workspace App.xcworkspace -scheme App build
Resolve Package Graph
xcodebuild: error: The workspace does not contain scheme "App".
↑ 일반적인 실패 위치: 워크스페이스 선택 또는 Scheme 공유 여부

$ bundle exec fastlane build
[build] Running gym
Exit status: 65
↑ 위쪽에서 최초 xcodebuild 오류 블록을 계속 찾으세요
SSH

인증 실패

사용자 이름, 대상 노드, 포트, 호스트 검증 결과 및 전체 오류 행을 제출하세요. 개인 키 내용은 로그나 티켓에 포함하지 마세요.

xcodebuild

구성 실패

작업 디렉터리, workspace 또는 project, Scheme, destination, Xcode 버전 및 종료 코드를 제출하세요.

Fastlane

프로세스 실패

lane, action, 종속성 버전 및 최초 오류 블록을 제출하세요. 환경 변수는 이름과 존재 여부만 기재하세요.

표준 순서

5단계로 점검하여 여러 변수를 동시에 변경하지 마세요

한 단계를 완료한 뒤 다음 단계로 진행하고 결과를 기록하세요. 여러 설정을 한 번에 변경하면 문제가 일시적으로 사라져도 실제 원인을 확인할 수 없습니다.

  1. 01

    노드 상태 확인

    콘솔에 로그인해 인스턴스, 노드 코드 및 현재 상태를 확인하고 올바른 주문을 보고 있는지 점검하세요. 싱가포르, 도쿄, 서울 및 홍콩은 일반적으로 주문 가능한 노드이며 실제 이용 가능 여부는 콘솔의 실시간 상태를 따릅니다.

  2. 02

    네트워크 연결성 검증

    도메인 확인, 대상 포트, 지연 시간, 지터 및 패킷 손실을 점검하고 다른 접속 네트워크로 다시 테스트하세요. 포트 연결 불가와 인증 실패는 서로 다른 문제이므로 같은 방식으로 처리해서는 안 됩니다.

  3. 03

    로그인 자격 증명 확인

    사용자 이름, 키 경로, 파일 권한 및 호스트 지문을 한 글자씩 대조하세요. 여러 번 실패했다고 모든 자격 증명을 무작정 교체하지 말고 비밀번호나 개인 키를 지원팀에 보내지도 마세요.

  4. 04

    디스크 공간 확인

    시스템 볼륨의 남은 용량, DerivedData, 종속성 캐시, 아카이브 결과물 및 임시 디렉터리를 확인하세요. 디스크 부족은 빌드 중단, 내보내기 실패 또는 도구의 비정상 종료로 나타날 수 있습니다.

  5. 05

    빌드 로그 확인

    명확한 최초 오류를 기준으로 앞뒤 로그 컨텍스트를 확장하고 명령어, 디렉터리, 도구 버전, 종료 코드 및 재현 단계를 기록하세요. 마지막 줄만 제출하면 문제를 특정하기 어려운 경우가 많습니다.

서비스 상태 기준

노드는 연중 운영되며 문제 이벤트는 영향 범위에 따라 업데이트됩니다

GPUMini의 4개 노드는 365일 연중 정상 운영됩니다. 예기치 않은 노드 이벤트가 발생하면 영향을 받은 노드, 시작 시간, 현재 영향, 처리 진행 상황 및 복구 결과를 중심으로 상태 정보가 업데이트됩니다. 개별 사용자의 네트워크, 자격 증명, 디스크 또는 프로젝트 설정 문제를 전체 서비스 이벤트로 잘못 표시하지 않습니다.

상태를 확인할 때는 먼저 노드 코드와 인스턴스 상태를 확인한 뒤 직접 관찰한 시간 범위를 비교하세요. 문제가 계속되면 ‘연결할 수 없음’만 제출하지 말고 로컬 접속 지역, 연결 방식, 전체 오류, 최초 발생 시간 및 최근 재현 시간을 첨부하세요.

진단 정보 최소 항목 6개 항목
노드
SG, JP, KR 또는 HK
시간
시간대를 명시한 발생 시간
접속 경로
SSH, 원격 데스크톱 또는 빌드 작업
증상
전체 오류 텍스트 및 종료 코드
재현
반복 가능한 최소 작업 단계
로그
비밀번호, 개인 키 및 액세스 토큰 삭제

지원팀 개입이 필요한지 판단하는 방법:노드, 네트워크, 자격 증명, 디스크 및 로그 점검을 완료한 뒤에도 동일한 문제가 안정적으로 재현되거나 주문과 청구 항목 사이에 명확한 차이가 있다면 티켓을 제출하세요. 일반 문의는 support@gpumini.com으로 보내도 됩니다.

지원팀에 에스컬레이션

지원팀이 한 번에 판단할 수 있는 정보를 전달하세요

노드, 발생 시간, 재현 단계 및 비식별화 로그는 기술 문제 처리를 위한 네 가지 기본 정보입니다. 청구 문제에는 주문 번호와 확인이 필요한 청구서 행도 필요합니다.

콘솔 티켓

주문, 인스턴스, 청구 및 지속적인 장애에 적합

티켓은 현재 계정의 주문 및 인스턴스와 연결할 수 있으므로 노드 상태, 청구 항목을 확인하거나 지속적으로 추적해야 하는 기술 문제에 적합합니다.

  • 해당 인스턴스 또는 주문을 선택하세요.
  • 노드와 시간대가 포함된 발생 시간을 명시하세요.
  • 재현 단계와 비식별화 로그를 첨부하세요.
콘솔에 로그인해 티켓 생성
지원 이메일

도입 전 검토 및 일반 문의에 적합

이메일을 보내기 전에 워크로드, 대상 노드, 대여 기간, 동시 빌드 수, 메모리 및 스토리지 요구 사항을 정리하세요. 기술 문제에도 비밀번호나 개인 키를 첨부하지 마세요.

  • 외부 문의용 이메일은 support@gpumini.com 하나뿐입니다.
  • 제목에 문의 유형과 대상 노드를 명시하세요.
  • 본문에 원하는 결과와 현재 증상을 설명하세요.
전체 문의 방법 보기
문제 제출 준비

증거를 먼저 준비한 뒤 지원팀에 전달하세요

기술 문제에는 노드, 시간, 재현 단계 및 비식별화 로그를 준비하세요. 주문, 인스턴스 및 청구 문제는 콘솔 티켓으로 연결해 처리하는 것이 우선입니다.