엔지니어링 지원 매뉴얼

클라우드 Mac을 연결부터 안정적인 운영까지

자격 증명 확인, VNC 원격 데스크톱 연결, 환경 마이그레이션 및 빌드 진단을 실제 작업 순서에 따라 진행하세요. 각 단계에서 확인 결과와 다음 조치를 제시해 문제를 모호한 설명으로 남기지 않습니다.

대상 사용자
전용 물리 Mac mini
일반적인 제공 시간
약 4분
지원 방법
콘솔 티켓 또는 이메일
RUN / CONNECT-01

최초 연결 확인 목록

실행 가능
자격 증명 확인 완료 콘솔 인스턴스 상세 정보
01
네트워크 연결 가능 대상 주소 및 포트 연결 가능
02
데스크톱 접속 완료 VNC 세션에 macOS 그래픽 인터페이스가 표시됨
03
검수 결과

모델, 메모리, 스토리지가 선택한 노드와 일치하는지 확인한 후 프로젝트와 빌드 캐시를 동기화하세요.

문제별로 이동

6개 도움말 주제에서 작업 경로를 바로 찾으세요

현재 단계와 가장 가까운 주제를 먼저 선택하세요. 연결 실패는 자격 증명과 네트워크부터, 빌드 실패는 환경과 로그부터 확인하고, 주문 및 노드 상태는 콘솔에서 실시간 결과를 확인합니다.

최초 연결 가이드

연결을 먼저 검수한 뒤 프로젝트를 마이그레이션하세요

저장소, 모델 또는 미디어 파일을 동기화하기 전에 네 가지 검사를 완료하는 것이 좋습니다. 그러면 제공 문제, 네트워크 문제 및 프로젝트 환경 문제를 분리해 처리할 수 있습니다.

  1. 01

    콘솔에서 최신 자격 증명 가져오기

    인스턴스 상세 정보에서 노드 번호, 모델, VNC 주소, 포트, 사용자 이름 및 임시 비밀번호를 확인하세요. 이전 티켓이나 과거 스크린샷의 연결 정보를 사용하지 말고 전체 자격 증명을 다른 사람에게 전달하지 마세요.

    노드 번호가 주문과 일치함 주소와 포트가 현재 인스턴스에서 제공됨 자격 증명에 불필요한 공백이 없음
  2. 02

    VNC 원격 데스크톱 연결 설정

    신뢰할 수 있는 네트워크에서 호환되는 VNC 클라이언트를 열고 콘솔에 표시된 주소와 포트로 연결하세요. 핸드셰이크에 실패하면 먼저 로컬 네트워크, 프록시, 방화벽 및 대상 포트를 확인하고 잘못된 비밀번호를 반복해서 시도하지 마세요.

    로컬 네트워크에서 외부 서비스에 정상적으로 연결됨 프록시가 대상 포트를 변경하지 않음 클라이언트에 현재 주소가 저장됨
  3. 03

    계정 보안 설정 변경

    그래픽 인터페이스에 처음 접속한 즉시 임시 로그인 비밀번호를 변경하고 화면 잠금, 자동 로그인 및 원격 접근 설정이 팀 규칙에 맞는지 확인하세요. 팀에서 사용할 경우 권한이 있는 구성원별로 추적 가능한 로컬 계정을 만들어야 합니다.

    임시 비밀번호가 변경됨 화면 잠금 정책 확인 완료 권한이 있는 구성원 범위가 기록됨
  4. 04

    시스템 및 주문 구성 검증

    macOS 버전, M4 칩, 메모리, 스토리지 용량, 사용 가능한 디스크 공간, 시스템 시간 및 네트워크 외부 연결을 확인하세요. SureVM M4 Core에는 M4, 16GB, 256GB가 표시되어야 하며, SureVM M4 Plus에는 M4, 24GB, 512GB가 표시되어야 합니다.

    칩과 메모리가 선택한 요금제와 일치함 디스크 용량이 추가 옵션과 일치함 시간 및 네트워크 상태 정상
마이그레이션 경로

로컬 Mac에서 클라우드 Mac으로 3단계 마이그레이션

마이그레이션의 목표는 기존 컴퓨터 전체를 복제하는 것이 아니라 검증 가능하고 재사용 가능한 작업 환경을 다시 구축하는 것입니다. 필요한 데이터를 먼저 동기화하고, 도구 체인을 재현한 다음 자동화 작업을 연결하세요.

01 데이터 동기화

프로젝트에 필요한 항목만 마이그레이션

코드 저장소, 구성 템플릿, 필요한 리소스 및 재사용이 확인된 캐시를 우선 동기화하세요. 대용량 파일은 먼저 압축하거나 나누어 전송해 한 번에 디스크가 가득 차지 않도록 하세요.

  • 버전 관리로 코드와 서브모듈 가져오기
  • 민감한 변수를 별도로 주입하고 저장소에 커밋하지 않기
  • 리소스, 모델 및 빌드 산출물의 저장 경로 기록
  • 동기화 후 주요 파일 수와 체크섬 검증
제공 결과 프로젝트 데이터를 읽을 수 있고 디렉터리 경계가 명확함
02 도구 체인 재현

버전 목록에 따라 개발 환경 재구축

먼저 Xcode, 명령줄 도구, 언어 런타임 및 패키지 관리자의 버전을 확인한 다음 프로젝트 의존성을 설치하세요. 출처를 추적할 수 없는 기존 컴퓨터의 전역 디렉터리를 그대로 복사하지 마세요.

  • Xcode 및 Command Line Tools 버전 고정
  • Ruby, Node.js, Python 및 Java 버전 기록
  • 잠금 파일에서 CocoaPods, SwiftPM 및 npm 의존성 복원
  • 클린 빌드를 한 번 실행하고 전체 로그 저장
제공 결과 동일한 커밋이 새 노드에서 안정적으로 빌드됨
03 CI 연결 및 검증

추적 가능한 큐에 노드 추가

Runner에 독립 작업 디렉터리와 최소 권한을 설정하고 캐시 정리 정책을 수립하세요. 테스트 브랜치에서 가져오기, 빌드, 아카이브 및 로그 반환을 검증하세요.

  • Runner가 접근할 수 있는 저장소와 실행 계정 제한
  • 캐시 디렉터리와 빌드 산출물 디렉터리 분리
  • 실패한 작업이 종료 코드와 로그를 반환하는지 검증
  • 노드 번호, 작업 번호 및 커밋 해시 기록
제공 결과 자동화 작업을 재현·추적·인계할 수 있음
Xcode 및 CI

빌드 실패 시 증거 체계에 따라 문제를 진단하세요

먼저 모든 캐시를 삭제하거나 도구를 전부 다시 설치하지 마세요. 실패 로그를 보존한 뒤 인증서, 서명, Keychain, Runner 권한, 캐시 및 구체적인 오류를 순서대로 확인해 범위를 좁히세요.

서명 체인

인증서, 프로비저닝 프로파일 및 Keychain

  1. 인증서 용도와 유효 상태 확인

    빌드 대상에서 사용하는 인증서 유형, 팀 설정 및 유효 기간을 확인해 개발 환경과 배포 환경을 혼용하지 않도록 하세요.

  2. 서명 설정 출처 확인

    프로젝트 구성, 빌드 매개변수 및 CI 환경 변수가 동일한 서명 정책을 가리키는지 확인하세요.

  3. Keychain에 작업이 접근할 수 있는지 확인

    대화형 로그인에 성공했다고 백그라운드 Runner에서도 사용할 수 있는 것은 아닙니다. Runner 실행 계정으로 잠금 해제 및 읽기 권한을 확인하세요.

실행 환경

Runner 권한, 캐시 및 로그

  1. Runner의 실제 실행 계정 확인

    작업 디렉터리, Shell, PATH 및 읽기·쓰기 권한을 확인하세요. 원격 데스크톱의 대화형 터미널에서만 검증하지 마세요.

  2. 의존성 캐시와 파생 데이터 격리

    CocoaPods, SwiftPM, npm 및 DerivedData에 명확한 디렉터리를 지정하고 문제가 있는 캐시만 우선 정리하세요.

  3. 첫 번째 전체 실패 로그 보관

    작업 번호, 커밋 해시, Xcode 버전, 종료 코드 및 최초 오류를 기록하세요. 마지막 몇 줄의 요약만 제출하지 마세요.

로그 확인 순서

첫 번째 실패를 먼저 찾고 연쇄 오류를 확인하세요

빌드 로그 끝부분에는 후속 실패가 많이 포함되는 경우가 많습니다. 첫 번째 0이 아닌 종료 코드, 최초 서명 오류 또는 최초 의존성 확인 오류부터 시작해 작업 시작 시간과 함께 실제 원인을 판단하세요.

01 작업 컨텍스트

노드 번호, 작업 번호, 커밋 해시, 브랜치.

02 환경 컨텍스트

macOS, Xcode, 런타임 및 의존성 버전.

03 실패 컨텍스트

최초 오류, 종료 코드, 관련 명령 및 시간.

MLX 및 개발 환경

현재 세션에서만 작동하지 않고 실험 환경을 재구축할 수 있게 하세요

Python 환경, 모델 파일, 매개변수 및 출력 기록을 분리해 관리하세요. 디스크 사용량을 제어하면서 의존성 업그레이드 후 실험 차이도 빠르게 비교할 수 있습니다.

환경 실행 시트

권장 디렉터리 및 기록 기준

ENV
Python 환경 격리

프로젝트마다 독립 가상 환경을 사용하고 Python 버전을 고정하세요. 의존성 목록은 프로젝트 버전 관리에 포함하세요.

DEP
의존성 설치

잠금 파일에서 의존성을 설치하고 MLX 및 주요 라이브러리 버전을 기록하세요. 업그레이드 전에 환경 목록과 기준 결과를 복사해 두세요.

MODEL
모델 파일 관리

모델, 양자화 버전 및 임시 다운로드 디렉터리를 분리하고 출처, 체크섬 및 디스크 사용량을 기록해 중복 사본을 방지하세요.

RUN
실행 기록 보관

각 실험에서 커밋 해시, 매개변수, 의존성 버전, 입력 요약, 소요 시간 및 출력 경로를 저장하세요. 민감한 원본 데이터는 기록하지 마세요.

시작 전

디스크 예산 확인

모델 파일, 가상 환경, 캐시 및 출력이 동시에 공간을 사용합니다. 다운로드 전에 사용 가능한 용량을 확인하고 임시 파일을 위한 여유 공간을 확보하세요.

  • 모델 디렉터리에는 필요한 버전만 보관
  • 캐시 정리 주기를 명확히 설정
  • 결과를 보관한 후 임시 파일 삭제
변경 후

최소 샘플로 검증

의존성이나 모델을 변경한 후에는 먼저 고정 입력의 소규모 샘플을 실행하세요. 종료 코드, 출력 구조 및 리소스 사용량을 비교한 뒤 전체 작업을 재개하세요.

  • 변경 전후 환경 목록 보관
  • 실패한 명령과 최초 오류 기록
  • 출력 경로에 쓰기 권한과 충분한 용량이 있는지 확인
연결 진단 트리

자격 증명부터 노드 상태까지 단계별로 배제하세요

각 단계에서는 하나의 질문만 확인하세요. 이전 단계가 통과되지 않았는데 다음 단계로 넘어가 소프트웨어를 다시 설치하지 마세요. 불필요한 변경을 줄이고 티켓에 명확한 증거를 남길 수 있습니다.

01
자격 증명

주소, 포트, 사용자 이름 및 비밀번호가 현재 인스턴스에서 제공된 것인가요?

통과하지 못한 경우

콘솔 인스턴스 상세 정보를 다시 열고 현재 연결 정보를 직접 복사한 뒤 앞뒤 공백과 이전 클라이언트 기록을 확인하세요.

02
네트워크

로컬 네트워크가 대상 주소와 포트에 도달할 수 있나요?

통과하지 못한 경우

트래픽을 변경하는 프록시를 일시적으로 비활성화하고 회사 외부 연결 정책을 확인한 뒤 다른 신뢰할 수 있는 네트워크로 교차 검증하세요.

03
원격 데스크톱 서비스

네트워크에는 연결되지만 VNC 세션이 핸드셰이크 단계에서 실패하나요?

통과하지 못한 경우

클라이언트 이름, 버전, 오류 원문 및 발생 시간을 기록하고 잘못된 자격 증명을 반복 제출하지 마세요.

04
시스템 부하

연결은 되었지만 화면이 느리다면 고부하 작업이 리소스를 점유하고 있나요?

확인할 항목

CPU, 메모리, 디스크 여유 공간 및 실행 중인 빌드·추론 작업을 확인하고 불필요한 큐를 일시 중지한 뒤 다시 테스트하세요.

05
노드 상태

콘솔이 현재 인스턴스의 정상 실행 상태를 반환하나요?

상태가 비정상인 경우

작업을 임의로 반복 재시작하지 마세요. 노드 번호, 콘솔 상태, 발생 시간 및 앞서 확인한 결과를 기록한 뒤 티켓을 제출하세요.

서비스 상태 기준

실시간 결과는 콘솔 반환값을 기준으로 합니다

모든 노드는 연중 365일 정상 운영을 전제로 설계됩니다. 인스턴스 상태, 연결 결과 및 로컬 확인 결과가 일치하지 않으면 해당 노드와 시간 범위를 지원 팀에 제출해 확인받으세요.

먼저 기록
노드 번호 및 발생 시간
다음으로 대조
콘솔 상태 및 로컬 현상
마지막으로 제출
비식별화한 로그 및 재현 절차
지원 요청 제출

지원 팀이 문제를 직접 재현할 수 있도록 하세요

완전한 티켓에는 대상, 시간, 작업 및 결과를 명시해야 합니다. 먼저 로그의 저장소 주소, 토큰, 개인 키, 개인 데이터 및 업무 내용을 비식별화하세요.

TICKET / REQUIRED

티켓에 포함할 5가지 정보

비식별화 후 제출
NODE
노드 번호 및 지역

콘솔에 표시된 노드 번호를 입력하고 싱가포르, 일본(도쿄), 한국(서울), 홍콩 또는 미국 서부를 명시하세요.

MODEL
모델 및 구성

SureVM M4 Core 또는 SureVM M4 Plus를 명시하고 추가 스토리지 또는 Thunderbolt 5 병렬 연결 사용 여부를 알려 주세요.

TIME
발생 시간 및 시간대

최초 발생 시간, 최근 재현 시간 및 시간대를 제공하세요. ‘방금’이나 ‘어제쯤’처럼 작성하지 마세요.

STEPS
최단 재현 단계

정상 상태에서 시작해 실행 작업, 입력 조건, 예상 결과 및 실제 결과를 순서대로 작성하세요.

LOG
비식별화한 로그 및 오류 원문

시간, 종료 코드 및 오류 컨텍스트는 남기고 비밀번호, 액세스 토큰, 개인 키, 전체 결제 자격 증명 및 업무상 민감한 데이터는 삭제하세요.

주문 완료 사용자

콘솔에서 노드 티켓 제출

콘솔 티켓은 인스턴스, 주문 및 노드 상태를 연결할 수 있어 연결, 시스템, 청구 및 지속적인 기술 문제를 처리하는 데 적합합니다.

로그인 후 티켓 제출
로그인할 수 없거나 구매 전 문의인 경우

지원 팀으로 이메일 보내기

답장을 받을 수 있는 이메일 주소로 문의 요약을 보내세요. 외부 지원 이메일은 support@surevm.com 하나뿐이며, 이메일로 계정 비밀번호나 개인 키를 보내지 마세요.

support@surevm.com
다음 단계

문제가 있다면 증거를 제출하고, 노드가 필요하다면 바로 구성하세요

콘솔은 인스턴스 관리와 지원 티켓에 사용하며, 주문 페이지에서는 2가지 M4 구성, 대여 기간 및 이용 가능한 5개 노드를 선택할 수 있습니다.