작업별 문제 해결 시작

연결, 설정, 빌드 또는 네트워크 문제라면 해당 점검표부터 시작하세요

BerryVM은 한 대 전체를 독점 사용하는 클라우드 Mac 물리 노드를 제공합니다. 막연한 도움말 목록을 헤매지 말고 먼저 문제가 발생한 계층을 확인한 다음 순서대로 결과를 수집하세요. 대부분의 환경 문제는 지원 요청 전에 연결, 시스템, 종속성, 빌드 또는 네트워크 계층 중 하나로 좁힐 수 있습니다.

서비스 형태
독점 물리 머신, 가상 머신 아님
노드 지역
싱가포르, 도쿄, 서울, 홍콩, 미국 동부
지원 자료
주문 ID, 노드, 시간, 단계, 비식별화 로그
최초 접속

네 가지 확인을 마친 후 프로젝트 환경을 설치하세요

접속 정보는 최초 세션을 설정하는 데만 사용합니다. 연결에 성공했다고 인도가 완료된 것은 아닙니다. 먼저 자격 증명을 갱신하고 기기 구성과 노드를 확인한 뒤 코드, 키 또는 빌드 작업을 머신에 배치하세요.

인도 자료

주문 및 접속 정보 확인

주문 ID, 할당된 노드, 기기 이름, 연결 방식과 자료 업데이트 시간이 일치하는지 확인하세요. 접속 정보를 공개 채널로 전달하거나 자격 증명을 프로젝트 저장소에 기록하지 마세요.

  • 주문 ID가 콘솔 기록과 일치함
  • 노드가 이번 주문의 선택 범위에 포함됨
  • 기기 이름이 인도 기록과 일치함
접근 제어

최초 접속 후 자격 증명 갱신

인도 자료로 세션을 설정한 즉시 팀이 관리하는 강력한 자격 증명으로 교체하세요. 구성원마다 통제된 접속 방식을 사용해 하나의 비밀을 장기간 공유하지 않도록 하세요.

  • 초기 로그인 자격 증명 갱신
  • 더 이상 사용하지 않는 접근 권한 제거
  • 복구 자료를 통제된 보관 시스템에 저장
기기 확인

물리 기기와 시스템 정보 확인

칩, 메모리, 저장 용량, macOS 버전, 시간대와 남은 디스크 공간을 확인하세요. 기본형은 M4, 16GB, 256GB여야 하며, 고메모리형은 M4 Pro, 64GB, 2TB여야 합니다.

  • 사양이 선택한 모델과 항목별로 일치함
  • 시간대가 팀 작업 일정에 적합함
  • 시스템 디스크에 빌드 및 캐시 공간이 남아 있음
세션 확인

복구 가능한 보안 세션 설정

그래픽 인터페이스와 명령줄 경로를 각각 확인하고 로컬 네트워크, 연결 프로토콜 및 테스트 시간을 기록하세요. 장시간 작업은 복구 가능한 세션이나 Runner에서 실행하고 단일 포그라운드 창의 연결 유지에 의존하지 마세요.

  • 그래픽 인터페이스와 명령줄 모두 사용 가능함
  • 잠자기 및 전원 정책이 작업 요구 사항에 맞음
  • 한 번 연결을 끊었다가 다시 연결해 복구 경로 확인
환경 초기화

현재 세션에서만 실행되는 환경이 아니라 재현 가능한 도구 체인을 만드세요

먼저 시스템과 도구 버전을 고정한 다음 종속성, 캐시와 Runner를 복원하세요. 각 단계를 반복 실행 가능한 목록으로 남겨 두면 이후 마이그레이션, 재구축 또는 기기 확장 시 개인 기억에 의존하지 않아도 됩니다.

초기화 시트

개발 환경 기준선

MAC / 기준선
Xcode

프로젝트에 필요한 주 버전, 명령줄 도구 선택 경로, 사용 가능한 SDK와 빌드 대상을 확인하세요. 업그레이드 전 기존 파이프라인과 종속성의 호환성을 먼저 점검하세요.

버전부터 고정
명령줄 도구

컴파일러, Git, Shell, Ruby, Python 및 Node.js의 실제 경로를 확인해 대화형 세션과 Runner가 서로 다른 환경을 읽지 않도록 하세요.

경로 확인
Homebrew

formula, 그래픽 앱과 비공개 저장소 목록을 내보내고 프로젝트 요구에 따라 나누어 복원하세요. 마이그레이션 후 버전을 하나씩 확인하고 출처가 불분명한 전체 디렉터리를 그대로 복사하지 마세요.

목록 복원
Swift

프로젝트 선언을 기준으로 Swift와 SDK 조합을 확인하고, 최소 프로젝트 하나로 컴파일·테스트·아카이브 경로를 검증한 후 전체 프로젝트를 실행하세요.

최소 검증
CI Runner

실행 사용자, 작업 디렉터리, 환경 변수 출처, 캐시 위치, 동시 실행 수와 로그 보존 정책을 확인하세요. 민감한 값은 통제된 변수로 주입합니다.

독립 컨텍스트
마이그레이션 순서

먼저 선언하고, 설치한 뒤, 마지막으로 검증하세요

  1. 목록 내보내기:버전, 종속성, 저장소, Runner 태그와 프로젝트 스크립트.
  2. 기반 계층 복원:Xcode, 명령줄 도구와 패키지 관리자.
  3. 프로젝트 계층 복원:잠금 파일, 비공개 저장소, 캐시와 환경 변수.
  4. 실행 검증:컴파일, 테스트, 아카이브와 산출물 검증을 각각 실행합니다.
비밀 정보를 그대로 복사하지 마세요

자격 증명과 프로젝트 파일을 분리해 마이그레이션하세요

코드 저장소, 빌드 캐시, 서명 자료와 접속 자격 증명은 서로 다른 유형의 데이터입니다. 최소 권한 원칙에 따라 각각 마이그레이션하고, 로그에는 문제 해결에 필요한 필드만 남기며 지원 요청 전 비식별화하세요.

보안 조치 확인
문제 위치 파악

문제 계층별로 확인하고 모든 변수를 동시에 바꾸지 마세요

먼저 문제를 재현하고 실패 상태를 보존한 뒤 조건 하나만 변경하세요. 다음 다섯 경로는 연결, 빌드, 디스크, 종속성과 노드 네트워크 문제를 다루며, 각각 지원 요청 전에 확보해야 할 증거를 제시합니다.

A

원격 연결을 설정할 수 없음

먼저 주문이 유효한 대여 기간인지, 접속 정보가 갱신되었는지, 대상 노드와 프로토콜이 올바른지 확인하세요. 그런 다음 다른 로컬 네트워크에서 테스트해 클라이언트 설정, 로컬 출구와 노드 경로 문제를 구분하세요.

  • 클라이언트 오류 전문과 발생 시간을 보관
  • 로컬 네트워크 유형, 프로토콜과 대상 노드 기록
  • 동일한 자료를 다른 통제된 클라이언트에서 테스트한 결과 확인
출력: 연결 계층 결론
B

빌드 실패 또는 아카이브 중단

동일한 커밋, 동일한 도구 버전과 동일한 명령으로 다시 실행하세요. 문제와 무관한 동시 작업을 먼저 중지하고 대화형 세션과 Runner의 사용자, 경로, 환경 변수와 권한 차이를 비교하세요.

  • 실패한 명령, 종료 코드와 첫 번째 유효 오류 첨부
  • Xcode, SDK, Swift와 종속성 버전 기록
  • Runner에서만 또는 대화형 세션에서만 재현되는지 설명
출력: 도구 체인 차이
C

디스크 공간 부족

프로젝트 작업 영역, 빌드 산출물, 시뮬레이터 데이터, 패키지 관리자 캐시와 Runner 캐시를 각각 확인하세요. 루트 디렉터리의 총량만 보지 말고 가장 빠르게 증가한 디렉터리를 찾아 안전하게 재생성할 수 있는지 확인하세요.

  • 남은 용량과 주요 디렉터리 사용량 기록
  • 소스 파일, 재생성 가능한 캐시와 최종 산출물 구분
  • 정리 전에 최근 비정상적으로 증가한 경로 정보 보관
출력: 공간 원인
D

종속성 설치 또는 버전 확인 이상

잠금 파일, 패키지 저장소, 프록시, 아키텍처와 실행 사용자를 확인하세요. 캐시를 지우기 전에 실패 출력을 저장하세요. 모든 캐시를 무차별 삭제하면 비교 가능한 상태가 사라지고 다운로드 및 확인 변수가 늘어날 수 있습니다.

  • 커밋에 따라 잠금 파일이 변경되었는지 확인
  • 실제로 읽은 패키지 저장소와 도구 경로 기록
  • 최소 종속성 집합으로 네트워크 및 확인 기능 검증
출력: 종속성 계층 결론
E

노드 네트워크 변동

동일한 출처와 프로토콜, 비슷한 시간대에 연속으로 샘플링하고 다른 네트워크 출구와 비교하세요. 단 한 번의 ping으로 빌드 산출물 업로드, 저장소 가져오기 또는 원격 데스크톱 세션의 전체 경로를 판단할 수 없습니다.

  • 출발 네트워크, 대상 노드, 프로토콜과 샘플 수 기록
  • 지연 시간, 패킷 손실과 애플리케이션 계층 오류를 함께 보관
  • 영향을 받은 대상이 연결, 저장소, 종속성 소스 또는 산출물 목적지인지 설명
출력: 경로 비교
서비스 연속성

99.9% 가동률 목표를 해석하는 방법

가동률은 단일 연결 속도가 아니며 특정 타사 네트워크 경로의 품질과도 다릅니다. 서비스 이벤트를 판단할 때는 노드 상태 기록, 주문 유효 기간, 영향 범위와 서비스 약관의 산정 기준을 함께 확인해야 합니다.

서비스 가동률 목표 99.9% 서비스 가동률 목표

모든 노드는 연중 365일 정상 운영됩니다. 적용 범위, 제외 사항, 신청 기한과 보상 방식은 서비스 약관을 따릅니다.

통계 및 보상 기준 확인
최근 90일 일별 상태 막대 각 칸은 하루를 나타냅니다
정상 상태
1~30일
31~60일
61~90일

상태 칸은 일별 기록을 빠르게 확인하기 위한 것입니다. 티켓 판단은 확인 가능한 노드 기록, 영향 시간대와 약관 적용 범위를 기준으로 합니다.

지식 문서

자주 쓰는 설정과 마이그레이션 작업을 재사용 가능한 단계로 나누세요

문서는 게시일 순으로 정렬되며 MLX, Homebrew, 배포 방식 비교, React Native 빌드, 원격 디버깅 준비와 데이터 보호 범위를 다룹니다.

새 문서 준비 중

지식 문서는 게시 후 날짜순으로 여기에 표시됩니다. 지금은 위 점검표부터 시작해 연결, 환경, 빌드와 네트워크 문제를 해결할 수 있습니다.

지원 요청 제출

추적 가능한 티켓에는 다음 정보가 포함되어야 합니다

지원 담당자는 먼저 문제를 재현하거나 문제 계층을 찾아야 합니다. 완전한 맥락은 추가 문의를 줄이지만 ‘완전하게’ 보내려는 목적으로 접속 비밀번호, 토큰, 개인 키 또는 비식별화되지 않은 프로젝트 데이터를 보내지는 마세요.

지원 요청

문제 맥락 체크리스트

필수 항목 5개
주문 ID
콘솔에서 확인할 수 있는 주문 ID를 입력하고 사용자 지정 프로젝트 코드로 대신하지 마세요.
노드
싱가포르, 도쿄, 서울, 홍콩 또는 미국 동부를 적고 해당 노드에만 영향을 미치는지 설명하세요.
문제 발생 시간
시간대가 포함된 시작 시간, 지속 시간과 마지막 정상 시간을 제공하세요.
재현 단계
초기 상태부터 첫 오류까지 작성하고 각 단계에 명령, 도구 버전과 실제 결과를 기재하세요.
비식별화 로그
오류 맥락, 종료 코드와 구성 요소 버전은 보존하고 자격 증명, 토큰, 개인 정보와 프로젝트 비밀은 제거하세요.
콘솔 티켓

실행 중인 주문은 티켓을 우선 이용하세요

티켓은 주문 및 노드 기록과 연결할 수 있어 연결 이상, 기기 상태, 빌드 환경, 청구와 서비스 이벤트에 적합합니다. 제출 후 같은 스레드에 비식별화 로그와 재현 결과를 추가할 수 있습니다.

콘솔에 로그인해 티켓 생성
문의 경로

일반 문의, 청구 문제와 운영 장애는 서로 다른 경로를 이용합니다

가장 많은 맥락을 연결할 수 있는 채널을 먼저 선택하세요. 실행 중인 기기 문제는 콘솔 티켓을 우선 이용하고, 아직 주문하지 않은 일반 문의는 지원 이메일로 문의할 수 있습니다.

일반 문의

구성, 노드와 사용 범위

대상 워크로드, 후보 구성, 예상 대여 기간과 팀 소재 지역을 설명하세요. 민감한 프로젝트 파일은 보내지 말고 작업 유형과 리소스 요구 사항만 알려 주세요.

연락 방법 확인
주문 및 청구

결제 상태, 청구서 또는 대여 기간 문제

콘솔에 로그인해 구체적인 주문을 연결하세요. BerryVM의 모든 결제는 USD로 처리되며 USDT-TRC20과 Visa / Mastercard / Amex(Stripe 경유)만 지원합니다.

청구 티켓 제출
운영 중 장애

연결, 기기 또는 노드 이상

주문 ID, 노드, 시간대가 포함된 문제 발생 시간, 영향 범위, 재현 단계와 비식별화 로그를 첨부하세요. 스크린샷만 제출하거나 접속 자격 증명을 보내지 마세요.

지금 장애 티켓 제출
바로 작업을 시작할 수 있는 클라우드 Mac이 필요하신가요?

작업에 맞는 구성과 기간을 선택한 후 5개 노드 중 하나에서 인도를 완료하세요

Berry M4는 가벼운 빌드와 일상적인 개발에 적합하며, Berry M4 Pro는 더 많은 메모리가 필요한 빌드와 MLX 실험을 위한 모델입니다. 주문 전 모델, 일·주·월·분기 대여 기간, 노드와 추가 저장 공간을 확인하세요.