주문 항목부터 빌드 로그까지, 작업별로 사용 문제를 해결하세요
이 설명서를 처음부터 끝까지 읽을 필요는 없습니다. 현재 작업에 맞는 장으로 이동해 이용 기간, 노드, 연결 정보, 개발 환경과 로그 증거를 차례로 확인하세요. 그래도 원인을 찾지 못했다면 전체 상황을 포함해 콘솔 문의를 제출하세요.
어느 단계에서 막혔는지 먼저 알려주세요
작업, 상태 필드 또는 오류 현상을 입력하면 검색 결과가 이 페이지의 해당 체크리스트로 바로 연결됩니다. 다섯 가지 입구에서 시작할 수도 있으며, 장을 순서대로 읽을 필요는 없습니다.
먼저 주문에 정의된 내용을 확인한 다음 인스턴스 이상 여부를 판단하세요
주문은 칩, 메모리, 스토리지, 노드와 대여 기간을 결정합니다. 콘솔의 상태 필드는 현재 제공 또는 실행 단계를 나타내므로 두 항목을 혼동하면 안 됩니다. 카탈로그 조합의 실제 이용 가능 여부는 콘솔의 실시간 응답을 기준으로 합니다.
다섯 가지 필드를 하나씩 일치시켜야 합니다
- 대여 기간
- 일, 주, 월 또는 분기 단위로 과금됩니다. 현재 기간과 프로젝트 지속 시간을 확인하고 서로 다른 기간의 금액을 하나의 예산에 섞지 마세요.
- 물리 노드
- 싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 동부 등 총 5개 노드입니다. 팀의 접속 경로, 코드 소스 위치와 데이터 흐름을 우선 고려하세요.
- 기본 구성
- ArmVMS M4는 M4, 16GB RAM, 256GB SSD이며, ArmVMS Pro(M4 Pro)는 M4 Pro, 64GB RAM, 2TB SSD입니다.
- 추가 옵션
- +1TB SSD, +2TB SSD 또는 Thunderbolt 5 병렬 연결을 별도로 확인하고, 추가 항목과 기본 구성이 동일한 주문 기간에 포함되어 있는지 확인하세요.
- 결제 방식
- USDT-TRC20 및 Visa / Mastercard / Amex(Stripe 결제)만 지원하며, 모두 미국 달러(USD)로 결제됩니다. 실제 이용 가능한 결제 게이트웨이는 백엔드 응답을 기준으로 합니다.
처리 중 및 연결 가능
“처리 중”은 일반적으로 주문 정보가 아직 제공 절차에 있음을 의미하고, “연결 가능”은 연결 정보가 생성되었음을 의미합니다. 상태가 변경되면 먼저 주문 상세를 새로 고친 다음 상세 페이지의 최신 연결 필드를 사용하세요.
주문이 정상이어도 환경이 준비된 것은 아닙니다
구성과 노드가 정확해도 시스템 계정, 디스크 여유 공간, Xcode 버전과 프로젝트 의존성을 확인해야 합니다. 환경 문제를 해결하기 위해 주문을 반복해서 생성하지 마세요.
구성 및 가격 확인| 필드 | 의미 | 사용자가 확인할 내용 | 불일치 시 기록할 내용 |
|---|---|---|---|
| ORDER ID | 주문의 고유 연결 식별자 | 문의, 청구서 및 인스턴스가 같은 번호를 참조하는지 확인 | 전체 주문 번호 |
| REGION | 물리 노드가 위치한 지역 | 주문 시 선택한 노드와 일치하는지 확인 | 노드 코드 및 표시 이름 |
| TERM | 현재 대여 기간 | 일·주·월·분기 및 시작·종료 정보 | 기간 이름 및 주문 스크린샷 |
| ACCESS | 연결 정보가 생성되었는지 여부 | 주소, 계정 및 연결 방식이 모두 준비되었는지 확인 | 누락된 필드 이름 |
| STATE | 인스턴스의 현재 실행 단계 | 새로 고친 후 상태가 바뀌는지, 연결이 복구되는지 확인 | 상태 원문 및 발생 시각 |
먼저 프로젝트를 재현 가능하게 빌드한 뒤 추가 속도를 고려하세요
클라우드 Mac으로 이전할 때는 도구 체인, 의존성 및 프로젝트 경로의 일관성을 먼저 복원하세요. 처음부터 기존 환경 전체를 복사하지 말고 체크리스트로 다시 구성하면 아키텍처 비호환, 경로 잔여물과 캐시 오염을 줄일 수 있습니다.
Xcode 프로젝트 준비
프로젝트에 필요한 Xcode 메이저 버전, 프로젝트 또는 워크스페이스 진입점, 빌드 Scheme, 대상 플랫폼과 최소 시스템 버전을 기록하세요. 처음 연 뒤 의존성 해석을 완료하고 전체 빌드를 실행하세요.
- 프로젝트 파일과 서브모듈이 모두 포함되었는지 확인
- Scheme을 명령줄 빌드에 사용할 수 있는지 확인
- 서명 구성과 코드 버전을 분리해 확인
명령줄 도구
먼저 현재 선택된 개발자 디렉터리를 확인한 다음 컴파일러, 버전 관리 도구와 스크립트 인터프리터를 점검하세요. 자동화 작업은 실제 도구 경로와 버전을 출력해야 하며, 대화형 세션과 실행기가 서로 다른 환경을 사용하지 않도록 하세요.
- 현재 Xcode 선택 결과 기록
- shell 초기화 파일이 대화형 입력으로 중단되지 않는지 확인
- 스크립트에 명확한 경로 또는 제어 가능한 환경 변수 사용
의존성 관리
잠금 파일과 소프트웨어 목록을 기준으로 의존성을 복원하세요. 설치 후 Apple Silicon 아키텍처, 바이너리 출처와 명령어 검색 경로를 확인하고, 기존 환경의 사전 컴파일 파일이 여전히 적합하다고 가정하지 마세요.
- 의존성 잠금 파일과 설치 로그 보관
- 스크립트에 이전 시스템 디렉터리가 하드코딩되어 있는지 확인
- 비공개 의존성 자격 증명을 제어된 변수에 저장
빌드 캐시
캐시에는 다시 생성할 수 있는 데이터만 저장하세요. 먼저 캐시 없이 빌드해 기준선을 확인한 뒤 의존성 캐시와 파생 데이터를 단계적으로 복원하세요. 설명하기 어려운 컴파일 차이가 발생하면 프로젝트 데이터를 모두 삭제하지 말고 현재 작업의 캐시를 먼저 정리하세요.
- 의존성 캐시, 컴파일 캐시와 최종 아티팩트 구분
- 캐시 키에 도구 체인과 의존성 버전 포함
- 캐시 용량과 디스크 여유 공간 정기 점검
실행기를 감사 가능한 물리 노드로 사용하세요
자동화 작업은 누가 실행했는지, 어떤 코드 버전을 사용했는지, 어떤 자격 증명을 읽었는지, 어떤 아티팩트를 생성했는지, 작업 종료 후 무엇을 정리했는지를 설명할 수 있어야 합니다. 전용 리소스는 리소스 경쟁을 줄이지만 파이프라인 자체의 권한 제어를 대신하지는 않습니다.
-
01
CREDENTIALS
최소 권한 자격 증명 주입
저장소, 의존성 출처와 배포 대상별로 자격 증명을 분리하고 현재 작업에 필요한 권한만 부여하세요. 자격 증명은 제어된 변수로 전달하며 저장소, 빌드 스크립트 또는 로그에 기록하지 마세요.
-
02
CONTEXT
실행 컨텍스트 고정
커밋 버전, 브랜치, Scheme, 대상 플랫폼, Xcode 버전과 의존성 요약을 기록하세요. 병렬 작업은 독립된 작업 디렉터리를 사용해 파생 데이터를 서로 덮어쓰지 않도록 하세요.
-
03
ARTIFACTS
추적 가능한 아티팩트 내보내기
아카이브, 테스트 보고서, 심볼 파일과 빌드 로그에는 작업 식별자를 포함하고 내보내기 전에 무결성을 확인하세요. 실패한 작업도 원인 파악에 필요한 충분한 로그를 보관해야 합니다.
-
04
CLEANUP
작업 환경 정리
임시 자격 증명, 마운트 파일, 임시 작업 영역과 더 이상 필요하지 않은 중간 아티팩트를 제거하세요. 장기 재사용 캐시는 지정된 디렉터리에 저장하고 프로젝트 소스나 민감한 자료와 섞지 마세요.
모델, 스토리지와 세션을 먼저 계획한 뒤 장시간 작업을 시작하세요
AI 실험의 주요 위험은 대개 시작 명령이 아니라 모델 파일 중복, 디스크 증가, 세션 중단과 결과 미내보내기입니다. 시작 전에 데이터 경계를 정하면 작업 도중 공간 부족을 발견하는 일을 줄일 수 있습니다.
모델 파일을 세 가지 디렉터리 계층으로 구성하세요
출처, 버전, 라이선스 정보와 체크섬 요약을 보관하세요. 원본 파일은 한 부만 저장해 여러 실험 디렉터리에 중복 복사하지 않도록 합니다.
다운로드 캐시, 변환 캐시와 임시 청크는 별도 디렉터리에 저장하세요. 공간이 부족하면 삭제 후 다시 생성할 수 있습니다.
체크포인트, 메트릭, 로그와 내보낸 파일을 작업 번호별로 보관하고 작업 완료 후 장기 보관 위치로 옮기세요.
장시간 작업 세션
학습, 변환 또는 대량 추론 작업은 임시 그래픽 세션과 분리해 실행해야 합니다. 시작 후 프로세스 식별자, 작업 디렉터리, 로그 경로와 복구 방법을 기록하고 연결이 끊긴 뒤에도 작업이 계속되는지 테스트하세요.
- 로그를 파일에 계속 기록
- 체크포인트 간격을 명확하게 설정
- 출력 디렉터리에 증가 여유 공간 확보
백업 범위
코드, 모델 출처 정보, 재생성할 수 없는 체크포인트와 최종 결과는 별도로 백업해야 합니다. 다운로드 캐시, 임시 청크와 반복 생성 가능한 중간 파일에 동일한 수준의 백업 리소스를 할당할 필요는 없습니다.
AI 워크로드 구성 상담계층별로 확인하고 여러 변수를 동시에 변경하지 마세요
각 계층의 확인을 마칠 때마다 조건 하나만 바꾸고 결과를 기록하세요. 네트워크, 자격 증명, 시스템, 디스크와 빌드 로그에는 명확한 순서가 있습니다. 사전 확인을 건너뛰면 연결 문제를 개발 환경 문제로 오판하기 쉽습니다.
로컬 네트워크에서 연결 주소에 도달할 수 있나요?
주소가 완전한지, 현재 네트워크가 관련 연결을 제한하는지, 네트워크를 바꾼 뒤에도 같은 현상인지 확인하세요. 클라이언트 시스템, 네트워크 유형과 오류 발생 시각을 기록하세요.
연결 자격 증명이 현재 주문 상세에서 제공된 것인가요?
콘솔의 주문 상세를 다시 열어 계정, 주소와 자격 증명 입력 방식을 한 글자씩 확인하세요. 이전 스크린샷, 브라우저 기록 또는 다른 인스턴스의 연결 정보를 사용하지 마세요.
인스턴스 상태에서 세션을 시작할 수 있나요?
인스턴스 상세를 새로 고쳐 상태 필드가 변경되었는지 확인하세요. 상태와 실제 연결 결과가 일치하지 않으면 주문 번호, 노드, 상태 원문과 최초 발견 시각을 기록하세요.
디스크에 작업 공간이 충분한가요?
프로젝트 디렉터리, 파생 데이터, 의존성 캐시, 모델 파일과 임시 아티팩트를 확인하세요. 공간 문제가 확인되면 재생성 가능한 캐시를 먼저 정리하고 아직 내보내지 않은 빌드 결과는 삭제하지 마세요.
빌드 로그에서 최초의 실제 오류를 찾을 수 있나요?
작업 종료 상태에서 앞쪽으로 이동해 첫 번째 오류를 찾고 마지막 한 줄만 잘라내지 마세요. 명령, 도구 체인 버전, 커밋 버전과 오류 컨텍스트를 보관하되 토큰, 비밀 키와 기타 민감한 정보는 제거하세요.
직접 해결할 수 없다면 바로 문제 해결을 시작할 수 있는 상황을 제출하세요
기존 주문과 관련된 문제는 콘솔 문의를 통해 주문과 연결하는 것이 우선입니다. 구매 전 구성 상담이나 콘솔에 접속할 수 없는 경우 support@armvms.com으로 이메일을 보내세요. 같은 대화에서 자료를 계속 추가해 동일한 문제로 요청을 반복 생성하지 않도록 하세요.
주문 및 노드 정보
전체 주문 번호, 노드 이름, 기본 구성과 추가 옵션을 제공하세요. 특정 인스턴스에서 문제가 발생했다면 콘솔에 표시된 현재 상태 필드를 알려주세요.
첫 번째 실패 작업을 설명하세요
발생 시각, 작업 단계, 예상 결과와 실제 결과를 작성하세요. 여러 번 시도했다면 어떤 조건을 변경했고 어떤 조건을 유지했는지 알려주세요.
오류 원문과 마스킹한 로그 첨부
전체 오류 메시지를 복사하고 관련 빌드 단계와 컨텍스트를 첨부하세요. 스크린샷에는 필드 이름이 포함되어야 하지만 모든 민감한 자격 증명과 프로젝트 비밀은 가려야 합니다.
제출 후 새 로그나 재현 결과를 어떻게 추가하나요?
같은 문의 또는 같은 이메일 대화에서 계속 답장하며 새 테스트의 실행 시각, 변경한 조건과 결과를 명시하세요. 그러면 서비스 팀이 시간순으로 비교할 수 있어 컨텍스트를 다시 만들 필요가 없습니다.
언제 콘솔 문의를 우선 사용해야 하나요?
주문 상태, 청구, 노드, 인스턴스 연결과 제공 필드 등 기존 주문과 관련된 문제는 콘솔 문의를 우선 사용하세요. 문의에 주문 번호를 연결할 수 있어 반복 확인을 줄일 수 있습니다.
구매 전 구성 상담을 위해 어떤 정보를 준비해야 하나요?
프로젝트 유형, 동시 작업 수, 필요한 Xcode 환경, 예상 스토리지, 대여 기간과 대상 노드를 알려주세요. 대규모 프로젝트나 대형 모델 추론이라면 최대 메모리와 모델 파일 규모를 함께 설명하면 좋습니다.
주문을 연결해 문의를 제출하고 문제를 올바른 컨텍스트에서 바로 시작하세요
주문 번호, 노드, 발생 시각, 재현 단계와 마스킹한 로그를 첨부하세요. 구매 전 상담이라면 두 가지 구성부터 확인한 후 프로젝트 지속 시간과 리소스 요구 사항을 제출할 수 있습니다.