프로젝트 및 구성
원본 파일과 자동화 구성은 팀의 자체 버전 관리 및 백업 절차에 보관해야 합니다. 클라우드 Mac의 작업 사본이 유일한 버전이 되어서는 안 됩니다.
엔지니어링 문제 해결 가이드
클라우드 Mac에 문제가 생기면 순서대로 범위를 좁혀 보세요
첫 연결, macOS 사용, Xcode 빌드, MLX 추론, 스토리지 확장 및 주문 문제를 한곳에서 다룹니다. 해당 점검을 먼저 완료한 뒤 주문 ID, 발생 시간과 민감정보를 삭제한 로그를 제출하면 지원팀의 반복 확인을 줄일 수 있습니다.
- 지원 범위
- 6가지 문제
- 판매 구성
- 3가지 모델
- 서비스 노드
- 4개 노드
문제 해결 요청
먼저 계층을 찾고 증거를 수집하세요
티켓 제출 가능
A
연결 전
진입 단계
제공 상태, 노드, 연결 정보 및 로컬 네트워크를 확인하세요.
B
작업 중
실행 단계
버전, 종속성, 디스크, 메모리 및 로그를 차례로 점검하세요.
C
제출 전
증거 단계
시간순 기록과 재현 절차를 남기고 비밀번호, 개인 키 및 민감한 내용을 삭제하세요.
권장 자료
주문 ID + 모델 + 노드 + 시간 + 비식별화 로그
문제가 발생한 단계부터 점검하세요
6가지 진입점을 한눈에 확인할 수 있습니다. 현재 현상에 가장 가까운 항목을 선택하고, 연결 실패·빌드 오류·주문 문제를 한 설명에 섞지 마세요.
주문 전 자가 점검
용도, 구성 및 연결 조건을 먼저 명확히 하세요
아직 주문을 생성하지 않았다면 다음 6가지를 먼저 확인하세요. 용도와 리소스 범위가 명확할수록 판매 중인 3가지 구성 중에서 쉽게 선택할 수 있고, 스토리지 용량·네트워크 조건·대여 기간을 장비 문제로 오인하는 일도 줄어듭니다.
노드 목록
싱가포르, 일본(도쿄), 한국(서울), 홍콩에서 모두 3가지 모델을 제공합니다. 최종 사용 가능 여부는 콘솔의 실시간 결과를 기준으로 합니다.
주문 준비 체크리스트
6 / 6 항목
- 용도 명확히 하기빌드, 테스트, 지속적 통합 또는 MLX 추론
- 모델 선택M4 16GB, M4 24GB 또는 M4 Pro 64GB
- 노드 선택팀의 시간대와 데이터 전송 경로를 기준으로 판단
- 청구 주기 확인일·주·월 또는 분기 단위로 주문 확인
- 스토리지 요구 사항 확인시스템, 프로젝트, 종속성 캐시 및 모델 파일을 구분
- 원격 연결 환경 준비로컬 네트워크가 필요한 연결을 허용하고 안정적으로 유지
연결에 실패하면 제공 상태부터 확인하고 비밀번호를 반복해서 바꾸지 마세요
클라우드 Mac에 처음 접속할 때는 주문 상태, 연결 정보, 로컬 네트워크 또는 입력 과정에서 문제가 발생하는 경우가 많습니다. 아래 순서대로 확인하고 각 단계에서는 변수 하나만 바꾸세요.
-
01
주문 단계
주문이 연결 가능한 상태인지 확인
콘솔에 로그인해 현재 주문을 확인하세요. 아직 처리 중이라면 상태가 업데이트될 때까지 기다리고, 이전 스크린샷이나 다른 주문의 연결 정보로 시도하지 마세요.
-
02
정보 단계
연결 정보를 항목별로 읽기
노드, 호스트 주소, 연결 방식 및 계정이 같은 주문에 속하는지 확인하세요. 복사할 때 앞뒤 공백을 확인하고 실제 인증 정보를 채팅 기록, 스크린샷 파일명 또는 공개 저장소에 남기지 마세요.
-
03
네트워크 단계
로컬 네트워크 제한 배제
로컬 네트워크, 방화벽 또는 프록시가 연결을 차단하지 않는지 확인하세요. 신뢰할 수 있는 다른 네트워크로 한 번 비교 테스트할 수 있지만 계정, 클라이언트 및 네트워크를 동시에 바꾸지 마세요.
-
04
입력 단계
계정 입력 다시 확인
대소문자와 혼동하기 쉬운 문자를 구분하고 키보드 레이아웃이 올바른지 확인하세요. 문제가 재현되면 오류 유형과 발생 시간만 기록하고 비밀번호 원문은 기록하지 마세요.
Xcode 빌드 오류는 도구 체인부터 로그까지 순서대로 확인하세요
먼저 실제로 빌드를 실행한 환경을 확인한 뒤 종속성과 서명을 점검하세요. 모든 캐시를 바로 삭제하거나 Xcode 버전을 연속해서 바꾸면 원래 문제를 재현하기 어려워집니다.
-
1
Xcode 버전 고정
현재 선택한 Xcode 경로, 버전 및 프로젝트 요구 사항을 기록하고 명령줄 작업과 그래픽 인터페이스가 같은 도구 체인을 사용하는지 확인하세요.
-
2
서명 파일 확인
필요한 파일이 팀의 비밀정보 관리 절차를 통해 주입되고 경로와 권한이 올바른지 확인하세요. 서명 파일 내용을 지원 요청에 복사하지 마세요.
-
3
종속성 캐시 범위 좁히기
다운로드, 분석, 컴파일 또는 링크 중 어느 단계에서 실패했는지 먼저 확인하세요. 해당 종속성의 캐시만 정리하고 정리 전후 로그를 비교할 수 있도록 보관하세요.
-
4
디스크 공간 확인
프로젝트 디렉터리, 빌드 산출물, 아카이브 및 종속성 캐시의 사용량을 각각 확인하세요. 공간이 부족하면 필요한 산출물을 먼저 내보낸 뒤 다시 생성할 수 있는 내용을 정리하세요.
-
5
최소 로그 추출
첫 오류 전후의 필요한 줄, 실행 명령 및 종료 상태를 남기세요. 토큰, 사용자 이름, 내부 저장소 주소 및 서명 정보를 삭제하세요.
MLX 추론
모델 로드부터 확인한 뒤 서비스 동시 요청을 테스트하세요
MLX 추론 문제는 모델 형식, 통합 메모리, 서비스 수신 설정 및 요청 부하를 구분해야 합니다. 먼저 단일 요청으로 재현 가능한 기준을 만든 뒤 동시 요청을 단계적으로 늘려 로드 실패와 서비스 혼잡을 혼동하지 마세요.
FORMAT
모델 형식
먼저 확인
모델 파일이 완전하고 변환 방식이 일관적인지 확인한 뒤 사용한 프레임워크와 버전을 기록하세요.
MEMORY
통합 메모리 사용량
다음 측정
로드 전, 로드 후 및 첫 요청 후의 수치를 기록하고 순간적인 최고값만 보지 마세요.
LISTEN
서비스 수신 주소
진입점 확인
수신 범위와 포트가 액세스 설계에 맞는지 확인하고 필요한 접근 제어를 설정하세요.
LOAD
요청 동시성
단계적 테스트
단일 요청부터 시작해 입력을 고정하고 동시성을 단계적으로 높이면서 지연 시간과 실패 유형을 기록하세요.
LOG
모델 로드 로그
증거 보관
버전, 시작 인수 및 오류 맥락을 남기고 업무 입력과 민감한 경로를 삭제하세요.
데이터 역할에 따라 용량을 계획하고 노드를 유일한 백업으로 사용하지 마세요
시스템, 프로젝트 원본 파일, 종속성 캐시, 빌드 산출물 및 모델 가중치는 수명 주기가 서로 다릅니다. 먼저 그룹으로 나눈 뒤 스토리지 추가 옵션을 늘릴지 결정하세요.
종속성 및 빌드 캐시
캐시는 반복 작업의 효율을 높일 수 있지만 정리 범위를 정해야 합니다. 디스크 문제를 점검할 때는 먼저 디렉터리별 사용량을 확인하고 모든 내용을 바로 삭제하지 마세요.
모델 및 데이터 파일
모델 출처, 형식, 버전 및 사용 공간을 기록하세요. 대용량 파일을 업로드하기 전에 노드 경로를 확인하고 대여 종료 전에 내보낼 시간을 확보하세요.
아카이브 및 산출물
빌드 아카이브, 테스트 보고서 및 추론 출력은 작업 단위별로 이름을 지정하세요. 검수가 끝나면 보관이 필요한 내용을 팀이 관리하는 스토리지로 내보내세요.
주문 및 연장
주문 정보는 콘솔의 현재 페이지를 기준으로 합니다
로그인 후 현재 대여 기간, 이용 가능한 연장 옵션, 선택한 모델 및 노드 정보를 확인하세요. 노드는 365일 연중 지속 운영되며, 실제 주문 상태와 이용 가능한 옵션은 콘솔의 실시간 결과를 기준으로 합니다.
새 주문을 생성하려면 판매 중인 3가지 구성 중 하나를 선택하고 싱가포르, 일본(도쿄), 한국(서울), 홍콩의 4개 노드 중 원하는 노드를 확인하세요. 목록의 모든 조합을 주문할 수 있으며 실제 사용 가능 여부는 콘솔에서 확인할 수 있습니다.
첫 요청부터 진단에 필요한 정보를 포함하세요
요청 내용에는 어느 주문·장비·노드에서 언제 발생했는지, 어떻게 재현하는지, 로그에 무엇이 표시되는지가 포함되어야 합니다. “연결할 수 없음” 또는 “빌드 실패”만으로는 보통 문제를 찾기 어렵습니다.
주문 ID
콘솔의 주문 ID를 입력하고 사용자 지정 장비 별칭으로 대신하지 마세요.
모델 및 노드
VMCache M4 16, VMCache M4 24 또는 VMCache M4 Pro 64와 해당 노드를 명시하세요.
발생 시간
시간대를 명시하고 지속적·간헐적 발생인지 한 번만 발생했는지 설명하세요.
재현 절차
정상 상태에서 시작해 작업, 입력 유형, 예상 결과 및 실제 결과를 단계별로 작성하세요.
영향 범위
영향이 단일 작업, 단일 프로젝트 또는 전체 작업인지 설명하고 정상 작동하는 비교 항목도 적으세요.
비식별화 로그
오류 맥락, 버전 및 종료 상태를 남기고 비밀번호, 개인 키, 토큰 및 업무 데이터를 삭제하세요.
두 가지 연락 경로
지원 티켓 제출
기존 주문은 먼저 콘솔에 로그인해 티켓을 제출하세요. 콘솔에 들어갈 수 없거나 구매 전 문의라면 다음 주소로 이메일을 보낼 수 있습니다: support@vmcache.com.
다음 단계
점검을 완료한 뒤 증거를 지원팀에 전달하세요
새 리소스가 필요하면 3가지 구성을 비교하고, 기존 주문에 문제가 생겼다면 주문 ID, 노드, 발생 시간, 재현 절차 및 비식별화 로그를 첨부해 티켓을 제출하세요.