01
주문 확인 약 45초
모델, 노드 지역, 대여 기간, 추가 옵션이 계획과 일치하는지 확인하세요. 기본 구성은 M4, 16GB, 256GB이며 고메모리 구성은 M4 Pro, 64GB, 2TB입니다. 구성이 다르면 후속 작업을 중단하고 지원 요청을 제출하세요.
- 주문 번호와 노드 지역을 기록하세요.
- 스토리지 확장과 Thunderbolt 5 연결 필요성을 확인하세요.
02
노드 정보 수신 약 2분
자동 할당과 시스템 점검이 완료될 때까지 기다린 뒤 콘솔에서 노드 주소와 연결 정보를 확인하세요. 연결 정보를 공개 채널에 전달하거나 저장소에 평문 자격 증명을 저장하지 마세요.
- 주소와 주문에 지정된 지역이 일치하는지 확인하세요.
- 초기 정보를 팀에서 승인한 자격 증명 관리 도구에 보관하세요.
03
접근 자격 증명 변경 약 1분
처음 연결한 뒤 즉시 자격 증명을 변경하고 자동화 작업용 키를 별도로 설정하세요. 대화형 계정과 CI 실행 계정을 분리해 스크립트에 불필요한 시스템 권한이 부여되지 않도록 하세요.
- 초기 암호를 변경하고 새 자격 증명이 작동하는지 확인하세요.
- 명령줄 접속용 키를 준비하고 호스트 지문을 확인하세요.
04
시스템 및 네트워크 확인 약 15초

macOS와 Xcode 버전을 기록하고 기본 경로, DNS 조회, 사용 가능한 디스크 공간, 작업 디렉터리 쓰기 권한을 확인하세요. 작은 빌드나 추론 요청을 실행해 환경이 검증 가능한 결과를 내는지 점검하세요.

전체 연결 단계 보기

개발 환경

Xcode 및 서명 환경의 기준부터 고정하세요

반복 가능한 빌드에는 명확한 버전, 접근 가능한 키체인, 일관된 명령줄 도구가 필요합니다. GUI에서 프로젝트가 열린다는 이유만으로 명령줄 검증을 생략하지 마세요.

설정 순서

01
Xcode 버전 확인
전체 버전과 빌드 번호를 기록하고 프로젝트에 필요한 SDK, 시뮬레이터 런타임, 최소 시스템 버전이 모두 준비되어 있는지 확인하세요.
02
인증서 및 프로비저닝 프로파일 가져오기
현재 프로젝트에 필요한 항목만 가져오세요. 이름에 프로젝트와 용도를 표시해 담당자가 바뀌어도 출처를 확인할 수 있게 하세요.
03
키체인 권한 확인
실행 대상 계정으로 개인 키를 읽을 수 있는지 확인하세요. 자동화 빌드는 권한 확인 창에서 큐가 멈추지 않도록 먼저 비대화형 코드 서명 테스트를 완료해야 합니다.
04
명령줄 도구 선택
현재 선택된 도구가 사용할 Xcode를 가리키는지 확인하고 결과를 프로젝트 환경 기록에 남기세요. 버전을 바꾼 뒤에는 의존성과 서명을 다시 점검해야 합니다.
05
첫 빌드 검증
기존 결과물을 정리한 뒤 테스트, 아카이브, 서명 검증을 실행하세요. 명령어, 종료 코드, 로그 경로, 최종 결과물의 체크섬을 보관하세요.

지속적 통합

러너를 임시 디렉터리가 아닌 고정 리소스로 관리하세요

전용 물리 머신은 고정된 하드웨어 자원을 제공하지만 캐시 오염, 과도한 동시 실행, 로그 부족으로 작업이 실패할 수 있습니다. 연결 전에 디렉터리 구성과 정리 책임을 정하세요.

자체 호스팅 러너 설치

러너 전용 시스템 계정과 서비스 디렉터리를 만들고 빌드에 필요한 권한만 부여하세요. 등록 후 서명 없는 간단한 작업을 실행해 큐, 네트워크, 종료 상태를 확인하세요.

완료 기준: 재시작 후 자동으로 작업 수신

작업 디렉터리 계획

소스 체크아웃, 의존성 캐시, 임시 빌드, 아카이브 결과물, 장기 보관 로그를 분리하세요. 작업 후에는 임시 디렉터리만 정리하고 다음 작업에 필요한 공유 캐시는 삭제하지 마세요.

완료 기준: 디렉터리 소유자와 정리 규칙 명확

동시 실행 수 제한

단일 작업으로 메모리, 디스크, 실행 시간 기준을 마련한 뒤 동시 실행 수를 늘리세요. Xcode 빌드와 MLX 추론을 함께 실행할 때는 메모리 사용량과 디스크 쓰기의 최고치를 각각 확인하세요.

완료 기준: 부하가 높은 시간에도 스왑 발생이나 디스크 부족 없음

실패 증거 보관

실패한 작업의 작업 ID, 커밋 버전, 러너 버전, 시작 시각, 종료 코드, 주요 로그, 결과물 경로를 보관하세요. 로그를 업로드하기 전에 토큰과 서명 자료를 삭제하세요.

완료 기준: 다른 팀원이 독립적으로 재현 가능

캐시 정리 범위

프로젝트, 브랜치, 도구 버전을 기준으로 캐시 키를 설정하세요. 정기적인 전체 디스크 삭제로 용량 관리를 대신하지 마세요. 정리하기 전에 실행 중인 빌드나 아카이브 작업이 없는지 확인하세요.

AI 및 MLX

부하 테스트, 모니터링, 복구가 가능한 추론 서비스

단일 요청부터 성공시킨 다음 컨텍스트 길이와 동시 실행 수를 늘리세요. 의존성을 업데이트할 때 모델 파일까지 영향을 받지 않도록 모델 디렉터리, 실행 환경, 서비스 로그를 분리하세요.

MLX 서비스 구성 단일 요청 기준부터 시작

Apple Silicon

환경 분리: 서비스마다 독립된 Python 환경을 사용하고 의존성 버전을 고정한 뒤 설치 목록을 저장하세요.
모델 디렉터리: 모델 파일을 소스 코드와 분리하고 모델 이름, 양자화 형식, 체크섬, 사용 공간을 기록하세요.
리스닝 범위: 기본적으로 작업에 필요한 인터페이스와 주소에서만 리스닝하고 디버그 엔드포인트를 관련 없는 네트워크에 노출하지 마세요.
동시 요청 부하 테스트: 동시 요청 1개, 2개, 4개를 차례로 테스트하고 첫 토큰 지연 시간, 총 소요 시간, 실패율, 메모리 최고치를 기록하세요.
메모리 모니터링: 상주 모델, 컨텍스트 증가, 요청 캐시를 구분해 관찰하세요. 안정적인 메모리 한도에 가까워지기 전에 부하 증가를 멈추세요.
재시작 정책: 시작 명령, 작업 디렉터리, 환경 변수, 로그 경로를 서비스 설정에 기록하고 비정상 종료 후 복구되는지 확인하세요.

용량 및 연결

프로젝트 이름으로 짐작하지 말고 작업 세트에 맞춰 스토리지를 선택하세요

소스 코드, 의존성, 모델, 빌드 결과물, 로그, 임시 파일의 최대 사용량을 합산한 뒤 정리와 롤백을 위한 여유 공간을 남겨 두세요. 기본 SSD 용량은 선택한 모델에 따라 다릅니다.

ArmMesh M4

기본 SSD 256GB

코드 체크아웃, 일반적인 의존성 캐시, 단일 프로젝트 빌드, 단기 릴리스 작업에 적합합니다. 대형 모델, 여러 버전의 Xcode 런타임, 대용량 동영상 파일은 최대 사용량을 먼저 계산하세요.

ArmMesh M4 Pro

기본 SSD 2TB

대형 모델 저장소, 장기 빌드 캐시, 병렬 프로젝트, 오디오·비디오 내보내기에 적합합니다. 용량이 넉넉해도 정리 정책은 필요하므로 로그와 결과물의 보관 기간을 설정하세요.

스토리지 및 Thunderbolt 5 추가 옵션 가격(USD)
추가 옵션	일간	주간	월간	분기	권장 확인 사항
+1TB SSD	$2.4	$6.4	$11.9	$32.4	의존성 캐시, 빌드 아카이브, 중간 규모 모델이 기본 용량을 초과할 때 적합합니다.
+2TB SSD	$4.8	$12.8	$23.8	$64.8	대형 모델, 장기 결과물 보관, 오디오·비디오 작업에 더 넓은 작업 공간이 필요할 때 적합합니다.
Thunderbolt 5 연결(장비 1대당)	$1.2	$3.2	$5.9	$16	여러 장비를 연동하기 전에 작업 분할, 데이터 동기화, 실패 복구, 결과 취합 방식을 먼저 확인하세요.

여러 장비 연결 전 점검할 5가지

작업을 서로 독립적이고 재시도 가능한 단위로 나눌 수 있나요?
입력 데이터의 단일 원본이 있나요? 여러 장비가 동시에 기록하나요?
모델, 의존성, 도구 버전을 일관되게 유지할 수 있나요?
실패한 노드의 작업을 결과 중복 없이 안전하게 옮길 수 있나요?
결과물의 이름 지정, 체크섬, 취합 위치가 통일되어 있나요?

문제 해결

범위를 좁힌 뒤 설정을 변경하세요

한 번에 조건 하나만 변경하고 전후 결과를 기록하세요. 계속 재설치하거나 캐시를 반복해서 지우고 네트워크와 도구 체인을 동시에 바꾸면 실제 원인을 찾기 어렵습니다.

연결 불가

로컬 네트워크부터 노드 상태까지 확인

로컬 네트워크가 작동하는지, 프록시나 방화벽이 연결을 차단하지 않는지 확인하세요.
노드 주소, 포트, 호스트 지문을 다시 확인하세요.
자격 증명이 업데이트되었는지, 복사할 때 공백이 들어갔는지 확인하세요.
콘솔에서 노드 상태를 확인한 뒤 클라이언트 버전과 오류 메시지 원문을 기록하세요.

속도 저하

지연 시간, 대역폭, 노드 부하를 구분해 확인

무선 네트워크의 변동을 배제할 수 있도록 동일한 네트워크에서 테스트를 반복하세요.
대화형 접속 지연과 파일 전송 속도를 따로 측정하세요.
빌드, 동기화, 추론 작업이 리소스를 사용하고 있는지 확인하세요.
접속 위치, 노드 지역, 시간대, 연속 테스트 결과를 기록하세요.

빌드 실패

코드 문제인지 환경 문제인지 먼저 확인

커밋 버전을 고정하고 동일한 빌드 명령을 다시 실행하세요.
Xcode, SDK, 의존성, 명령줄 도구 버전을 기록하세요.
서명 자료, 키체인 권한, 작업 디렉터리 권한을 확인하세요.
전체 디스크를 지우지 말고 현재 프로젝트의 임시 결과물만 정리한 뒤 다시 시도하세요.

디스크 공간 부족

증가 원인을 찾고 확장을 결정하세요

모델, 의존성 캐시, 아카이브, 로그, 임시 디렉터리의 사용량을 각각 확인하세요.
중복 모델, 오래된 아카이브, 끝나지 않은 작업의 잔여물이 있는지 확인하세요.
보관 규칙에 따라 다시 생성할 수 있는 파일을 정리하고 최대 사용량을 다시 기록하세요.
안전 여유 공간을 확보하기 어려운 경우 +1TB 또는 +2TB SSD를 선택하세요.

추론 프로세스 종료

요청 규모와 메모리 최고치 비교

시작, 모델 로드, 요청 처리 중 어느 단계에서 종료되었는지 확인하세요.
모델 형식, 컨텍스트 길이, 동시 요청 수가 바뀌었는지 확인하세요.
종료 직전의 메모리, 디스크 상태, 서비스 로그를 확인하세요.
단일 요청으로 기준 상태를 복구한 뒤 부하를 하나씩 늘리세요.

자격 증명 오류

재시도를 멈추고 변경 원인을 확인하세요

대화형 계정과 자동화 계정 중 어느 계정을 사용했는지 확인하세요.
최근 암호, 키, 사용자 권한을 변경했는지 확인하세요.
스크립트와 캐시에 남아 있는 이전 자격 증명을 삭제한 뒤 새 자격 증명을 테스트하세요.
변경 원인을 확인할 수 없다면 콘솔에서 지원 요청을 제출하세요.

지원 요청

바로 문제를 확인할 수 있도록 지원 요청에 정보를 담으세요

기술 문제는 주문 및 노드 정보와 연결할 수 있도록 콘솔에서 지원 요청을 제출하는 것이 좋습니다. 콘솔에 로그인할 수 없다면 이메일을 보내세요: support@armmesh.com.

제출 전 준비할 6가지 정보

01 주문 번호

문제가 발생한 주문 번호를 적으세요. 여러 노드에 문제가 생겼다면 각 주문 번호를 따로 기재하세요. 팀 이름만 적지 마세요.

02 노드 지역

실제로 사용 중인 지역을 적고 문제가 한 노드에서만 발생하는지 여러 노드에서 발생하는지 설명하세요.

03 macOS 버전

전체 버전과 빌드 번호를 기재하세요. 빌드 문제라면 Xcode와 명령줄 도구 버전도 함께 제공하세요.

04 발생 시각

시간대, 최초 및 최근 발생 시각, 문제를 안정적으로 재현할 수 있는지 기재하세요.

05 재현 단계

정상 상태에서 시작해 작업, 입력값, 예상 결과, 실제 결과를 순서대로 적으세요.

06 민감 정보를 가린 로그

타임스탬프, 오류 코드, 맥락은 유지하고 암호, 키, 토큰, 서명 자료, 프로젝트 기밀은 삭제하세요.

다음 단계

물리 노드를 선택하고 체크리스트에 따라 점검하세요

두 모델 모두 전용 물리 머신이며 가상 머신이 아닙니다. 일간, 주간, 월간, 분기 단위로 대여할 수 있습니다. 노드의 실제 사용 가능 여부는 콘솔의 실시간 응답을 기준으로 확인하세요.

클라우드 Mac 대여 구성 및 가격 보기