리전과 연결 진입점 확인
주문서의 SG, JP, KR 또는 HK 노드 코드를 확인하고 인도 주소를 기록하세요. 노드는 액세스 경로에 영향을 주지만, 네트워크 문제를 감추기 위해 프로젝트 의존성을 변경해서는 안 됩니다.
- 검증 포인트
- 주문 노드와 인도 노드가 일치함
- 기록 항목
- 노드 코드, 테스트에 사용한 네트워크
사실 확인부터 문제 해결
인도, 연결 및 빌드 문제를 실행 가능한 단계로 나누기
먼저 물리 노드, 구성, 이용 기간과 인증 정보를 확인한 다음 네트워크, 개발 환경과 작업 로그를 점검하세요. 각 단계에 입력값, 검증 포인트와 완료 기준을 제시하므로 최초 설정, 일상적인 빌드와 문제 파악에 활용할 수 있습니다.
연결 방법이 필요하다면 먼저원격 액세스 절차를 확인하세요. 기존 주문에 관한 문의라면 주문 번호와 노드 코드를 티켓에 첨부해 주세요.
작업 탑승 전 체크리스트
BUILD SUPPORT / 04
점검 순서 준비 완료
입력
검증
복구
머신 및 노드
구성, 리전, 이용 기간을 주문과 항목별로 대조
먼저 확인
계정 및 세션
주소, 시스템 계정과 일회용 인증 정보를 분리 보관
그다음 연결
툴체인 및 runner
버전, 태그, 동시 실행, 캐시와 종료 후 정리
이후 실행
타임라인 및 로그
시간대를 통일하고 장애 전후의 핵심 기록을 캡처
문제 파악용
완료 기준
문제가 재현되고 범위를 설명할 수 있으며 로그에서 민감 정보가 제거됨
6가지 진입점
문제가 발생한 단계에 따라 점검 경로를 선택하세요
환경 재설치부터 시작하지 마세요. 문제가 인도, 연결, 툴체인, 작업 실행, 데이터 입출력 또는 결제 정보 중 어디에서 발생했는지 먼저 판단하면 불필요한 변경을 크게 줄일 수 있습니다.
01
최초 인도
노드, 머신 구성, 시스템 계정, 액세스 인증 정보, 이용 시작·종료 시간과 보안 설정을 확인합니다.
완료 기준: 주문 정보와 머신의 실제 구성이 일치 02원격 연결
주소 연결 가능 여부, 포트 정책, 계정 상태, 네트워크 지터, 키보드 레이아웃과 세션 복구를 순서대로 확인합니다.
완료 기준: 안정적으로 재연결하고 입력 가능 03개발 환경
Xcode, 명령줄 도구, 인증서, 프로비저닝 프로파일, 의존성 캐시와 프로젝트 디렉터리 권한을 기록합니다.
완료 기준: 로컬과 원격 기준선을 비교 가능 04CI/CD
runner 등록, 태그 라우팅, 동시 실행 한도, 캐시 디렉터리, 키 주입과 작업 후 정리를 확인합니다.
완료 기준: 작업을 반복 실행해도 환경이 섞이지 않음 05스토리지
시스템 디스크, 프로젝트 디렉터리, 빌드 캐시와 팀 스토리지를 구분하고 공간, 권한과 동기화 상태부터 확인합니다.
완료 기준: 데이터 경로와 반출 책임이 명확함 06청구
머신 모델, 이용 기간, 노드, SSD 추가 구매와 Thunderbolt 5 병렬 연결 수를 확인한 뒤 청구 항목과 대조합니다.
완료 기준: 각 비용을 구성까지 추적 가능
인도 전 6가지 확인
최초 로그인 전에 인도 기준선을 저장하세요
기준선은 이후 변화가 주문, 시스템 설정 또는 프로젝트 툴체인에서 비롯되었는지 판단하는 데 사용합니다. 확인 시 필요한 정보만 기록하고 비밀번호, 개인 키 또는 전체 토큰을 팀 문서에 작성하지 마세요.
칩, 메모리와 디스크 확인
시스템 정보에서 주문에 해당하는 M4 또는 M4 Pro, 메모리 용량과 시스템 디스크 용량을 확인하세요. 외부 또는 추가 구매 스토리지는 마운트 위치를 별도로 기록합니다.
- 검증 포인트
- 구성과 주문이 필드별로 일치함
- 기록 항목
- 칩, RAM, SSD
관리자 계정과 작업 계정 구분
초기 시스템 계정으로 로그인할 수 있는지 확인한 뒤 자동화 작업에는 최소 권한 계정을 사용하세요. 일상적인 runner가 불필요한 고권한 계정을 계속 사용하지 않도록 합니다.
- 검증 포인트
- 계정에 로그인할 수 있고 용도에 맞는 권한을 가짐
- 기록 항목
- 계정 역할, 비밀번호는 기록하지 않음
최초 사용 후 일회용 인증 정보 업데이트
원격 주소, 시스템 사용자 이름과 세션 인증 정보를 각각 보관하세요. 업데이트 후 한 번 로그아웃하고 재연결하여 새 인증 정보가 예상한 방식으로 적용되는지 확인합니다.
- 검증 포인트
- 이전 인증 정보는 무효화되고 새 인증 정보로 재연결 가능
- 기록 항목
- 변경 시간과 담당자
시작·종료 시간과 팀 시간대 통일
이용 시작·종료 시간을 프로젝트 캘린더에 기록하고 적용한 시간대를 표시하세요. 장시간 작업은 만료 전에 저장, 산출물 동기화와 환경 정리를 위한 확인 지점을 마련해야 합니다.
- 검증 포인트
- 팀 구성원이 동일한 시간을 확인함
- 기록 항목
- 시작·종료 시간, 시간대, 담당자
진입점을 먼저 제한한 후 도구 설치
공유 계정, 원격 액세스 범위, 디렉터리 권한과 키 보관 위치를 확인하세요. 설치 스크립트는 검토할 수 있어야 하며 민감한 변수는 작업 실행 중에만 주입합니다.
- 검증 포인트
- 최소 권한과 액세스 경계가 명확함
- 기록 항목
- 허용된 출처, 디렉터리와 로테이션 책임
핵심 용어
먼저 8개 용어를 통일해 소통의 오해를 줄이세요
이 용어는 리소스 소유, 연결 방식과 빌드 환경을 설명합니다. 문제를 제출할 때 해당 명칭을 그대로 사용하면 지원 담당자가 문제 계층을 더 쉽게 판단할 수 있습니다.
- 물리 노드
- 클라우드 Mac을 호스팅하는 실제 장비와 위치한 리전입니다. SoarMac은 지정 노드의 Apple Silicon 물리 머신을 제공하며, 추상화된 공유 컴퓨팅 인스턴스가 아닙니다.
- 전용
- 이용 기간 동안 한 주문이 머신 리소스를 사용하며 다른 주문과 시스템 환경을 공유하지 않습니다. 팀 내부에서는 계정, 디렉터리와 작업 권한을 직접 설계해야 합니다.
- 비가상 머신
- 시스템이 해당 물리 머신에서 직접 실행됩니다. 성능이나 장치 기능을 점검할 때는 가상 머신 사양 개념이 아니라 실제 구성, 현재 작업과 스토리지 상태를 먼저 확인해야 합니다.
- VNC
- macOS 그래픽 인터페이스에 액세스하는 원격 세션 방식입니다. 화면 조작과 시각적 확인에 적합하지만 파일 동기화와 같지 않으며 자동화 작업 로그를 대신해서도 안 됩니다.
- self-hosted runner
- 팀 CI/CD 플랫폼에 등록되어 클라우드 Mac에서 실제로 작업을 실행하는 실행기입니다. 태그, 동시 실행 제한, 작업 디렉터리와 종료 후 정리 규칙을 명확히 설정해야 합니다.
- 빌드 캐시
- 반복 다운로드와 컴파일을 줄이기 위해 보관하는 의존성 또는 중간 산출물입니다. 캐시에는 식별 가능한 키, 용량 한도와 만료 조건이 필요하며 프로젝트 소스 파일과 섞어 보관해서는 안 됩니다.
- 서명 환경
- 서명 검사를 실행하는 데 필요한 도구 버전, 인증서, 프로비저닝 프로파일, 권한과 작업 변수의 집합입니다. 출처와 로테이션 책임을 기록하고 일반 로그에 민감한 내용을 출력하지 마세요.
- 세션 인증 정보
- 원격 세션을 설정하는 데 사용하는 주소, 사용자 이름과 임시 인증 정보입니다. 프로젝트 키나 코드 저장소 토큰과는 다른 정보이므로 분리해 보관하고 로테이션해야 합니다.
CI/CD 연결
runner가 한 번이 아니라 반복해서 실행되도록 설정
연결 순서는 등록, 라우팅, 속도 제한, 캐시, 키와 정리로 고정해야 합니다. Xcode, 의존성 또는 서명 자료를 변경할 때마다 동일한 최소 파이프라인으로 다시 검증하세요.
runner 등록
프로젝트 또는 조직에서 요구하는 등록 방식으로 실행기를 만들고 runner 이름, 범위와 서비스 시작 방식을 기록하세요. 완료 후 민감한 변수가 없는 진단 작업을 먼저 실행합니다.
태그 설계
태그에는 시스템, 칩 제품군, Xcode 기준선과 용도(예: 빌드, 테스트 또는 미디어 처리)를 최소한으로 표현하세요. 일반 태그가 고부하 작업을 경량 큐로 잘못 라우팅하지 않도록 합니다.
동시 실행 제한
먼저 단일 작업으로 CPU, 메모리, 디스크 쓰기와 Derived Data 디렉터리를 검증한 뒤 동시 실행 수를 점진적으로 늘리세요. 지터가 발생하면 최종 실패 코드만 보지 말고 큐 길이와 작업 타임라인을 보존합니다.
캐시 디렉터리 분리
의존성 캐시, 빌드 중간 산출물과 내보내기 파일을 각각 저장하세요. 캐시에 용량 경계, 키 규칙과 정리 조건을 설정해 이전 아키텍처나 툴체인 산출물이 잘못 재사용되지 않도록 합니다.
키 주입
민감한 변수는 작업 실행 단계에만 환경에 주입하고 로그에서 명령 에코를 끄며 읽을 수 있는 작업을 제한하세요. 검증 실패 시 변수 존재 여부만 확인하고 원문은 출력하지 않습니다.
작업 후 정리
종료 시 임시 파일을 삭제하고 임시 마운트를 해제하며 남은 프로세스를 종료하고 단기 인증 정보를 삭제하세요. 이전 단계가 실패해도 정리는 실행되어야 하며 검토 가능한 결과 코드를 보존합니다.
최소 검증 작업
도구 버전 → 의존성 가져오기 → 컴파일 → 테스트 → 요약 내보내기
보존해야 할 항목
runner 태그, 커밋 식별자, 작업 시간, 종료 코드, 비식별화 로그
로그에 포함하면 안 되는 항목
비밀번호, 개인 키, 전체 토큰, 서명 자료 원문
개발 환경 기준선
먼저 버전을 기록한 뒤 환경 차이인지 프로젝트 문제인지 판단
원격 빌드 실패가 곧 머신 이상을 의미하지는 않습니다. 도구 버전, 의존성 확인, 디렉터리 권한과 서명 자료를 분리해 검증해야 실제로 변경된 계층을 찾을 수 있습니다.
Xcode 버전 확인
전체 버전, 빌드 번호와 현재 선택 경로를 기록하세요. 파이프라인에서 버전을 명시적으로 선택해 그래픽 인터페이스와 명령줄이 서로 다른 툴체인을 호출하지 않도록 합니다.
명령줄 도구
컴파일러, 패키지 관리자와 스크립트 인터프리터의 실제 경로를 확인하세요. 설치 화면만으로 버전을 판단하지 말고 작업 로그에는 민감하지 않은 버전 요약을 출력합니다.
인증서와 프로비저닝 프로파일
유효 범위, 용도와 읽기 권한을 확인하세요. 로그에는 식별자와 검사 결과만 기록하고 인증서의 비밀 내용을 출력하지 않습니다. 로테이션 후 최소 서명 검증을 한 번 실행합니다.
의존성 캐시
캐시 키에는 의존성 잠금 파일, 도구 버전과 아키텍처 정보가 포함되어야 합니다. 설명하기 어려운 컴파일 차이가 발생하면 프로젝트 데이터를 모두 삭제하지 말고 빈 캐시로 검증하세요.
프로젝트 디렉터리 권한
runner가 소스, 캐시와 내보내기 디렉터리에 각각 필요한 권한을 보유하는지 확인하세요. 단일 디렉터리 문제를 전역 권한 완화로 해결하지 말고 디렉터리 소유자 변경을 기록합니다.
스토리지 경로
시스템, 프로젝트, 캐시와 인도 파일을 분리 관리
디스크 문제는 대개 경로 혼용, 캐시 한도 미설정, 권한 변경 또는 동기화 미완료에서 발생합니다. 먼저 데이터가 어느 계층에 속하는지 확인한 뒤 정리, 확장 또는 이전을 결정하세요.
여유 공간 확보
사용 가능한 공간을 계속 확인해 빌드 중간 산출물이 시스템 실행에 필요한 용량을 잠식하지 않도록 하세요. 시스템 디렉터리를 팀 공유 산출물 저장소로 사용하지 않습니다.
소유자 명확화
소스와 구성은 지정된 작업 계정이 관리합니다. 디렉터리를 이전한 후 권한, 심볼릭 링크와 스크립트의 절대 경로를 다시 확인하세요.
만료 조건 설정
프로젝트, 아키텍처와 도구 버전별로 캐시를 나누고 용량과 보존 기간에 대한 정리 규칙을 설정해 이전 산출물이 새 작업에 영향을 주지 않도록 합니다.
동기화 후 정리
내보낸 산출물의 무결성을 먼저 확인한 후 팀 스토리지로 동기화하세요. 이용 기간이 끝나기 전에 반출을 완료하고 인수인계 기록을 보존합니다.
연결 문제 해결 순서
한 번에 하나의 조건만 변경하고 결과를 기록하세요
먼저 로컬 네트워크와 대상 주소를 확인한 후 인증과 세션 계층으로 이동하세요. 화면, 키보드와 클립보드는 세션 사용성 문제이므로 주소 연결 불가 문제와 같은 단계에서 처리하지 않습니다.
| 현상 | 첫 단계 | 두 번째 단계 | 여전히 복구되지 않을 때 보존할 정보 |
|---|---|---|---|
| 세션을 시작할 수 없음 | 노드, 주소와 로컬 네트워크가 사용 가능한지 확인하고 회사 네트워크 정책 차단을 배제합니다. | 정상 작동이 확인된 다른 네트워크에서 재시험하되 계정과 연결 매개변수를 동시에 변경하지 않습니다. | 노드, 발생 시간, 출발 네트워크, 오류 원문과 연속 테스트 결과 |
| 화면 지연 | 해상도와 색 품질을 낮추고 로컬 대용량 업로드를 일시 중지합니다. | 다른 네트워크에서 왕복 지연과 지터를 비교해 문제가 지속되는지 확인합니다. | 노드, 해상도, 네트워크 유형, 지연 샘플과 문제 시간대 |
| 키보드 레이아웃 이상 | 로컬 입력기, 세션 키보드 레이아웃과 시스템 지역 설정을 확인합니다. | 일반 텍스트 편집기에서 수정 키, 기호 키와 단축키를 테스트합니다. | 로컬 시스템, 키보드 레이아웃, 이상 키와 재현 단계 |
| 클립보드 동기화 안 됨 | 세션 도구에서 클립보드 전송을 허용했는지 확인하고 짧은 일반 텍스트로 테스트합니다. | 세션을 다시 설정한 후 재시험하고 대용량 파일이나 서식 있는 텍스트는 먼저 복사하지 않습니다. | 세션 도구, 콘텐츠 유형, 방향과 재현 가능한 최소 텍스트 |
| 재연결 실패 | 기존 세션을 완전히 종료하고 연결 해제를 기다린 다음 같은 주소로 다시 시도합니다. | 시스템 계정이 여전히 유효한지 확인하고 짧은 간격으로 연결을 반복하지 않습니다. | 연결 해제 원인, 재시도 간격, 오류 원문과 최근 정상 연결 시간 |
| 인증 정보 만료 | 최신 시스템 사용자 이름과 세션 인증 정보를 사용하고 있는지, 이전 기록을 혼용하지 않았는지 확인합니다. | 권한이 있는 담당자가 최근 변경 및 로테이션 시간을 확인합니다. | 주문 번호, 노드, 사용자 이름, 만료 시간. 비밀번호는 첨부하지 마세요. |
| 대용량 파일 전송 중단 | 검증과 재개가 가능한 파일 동기화 절차를 사용하고 클립보드에 의존하지 않습니다. | 원본과 대상 파일의 크기 및 검증 결과를 비교합니다. | 파일 크기, 전송 방향, 시작 시간, 실패 단계와 검증 요약 |
서비스 목표
99.9% 가용성 목표, 이벤트 기록으로 확인
모든 노드는 연중 365일 정상 운영됩니다. 이상 이벤트가 발생하면 콘솔 타임라인에 시작 시간, 영향 범위, 복구 과정과 종료 시간이 기록됩니다. 보상 자격과 산정 방식은 서비스 약관을 따릅니다.
최근 90일
30일 확인 기간 3개
실제 기록은 타임라인을 기준으로 합니다
D−90 — D−61
일별 상태, 이상 시작 시간과 영향 범위
D−60 — D−31
복구 조치, 단계별 업데이트와 노드 범위
D−30 — D−1
종료 시간, 지속 시간과 후속 안내
- 산정 기준
- 영향받은 서비스 기록과 주문 타임라인
- 신청 경로
- 콘솔 티켓
- 제출 자료
- 주문 번호, 노드, 시간과 영향 설명
청구 확인
구성 항목별로 한 줄씩 대조하고 총액으로 역산하지 마세요
주문 비용은 머신 등급, 이용 기간, 노드, SSD 추가 구매와 Thunderbolt 5 병렬 연결 수로 구성됩니다. 이용 기간이나 추가 항목을 변경할 때마다 주문 요약을 다시 확인하세요.
머신 및 이용 기간
먼저 SoarMac M4 Air, SoarMac M4 Plus 또는 SoarMac M4 Pro를 확인한 다음 일·주·월·분기 이용 기간을 확인합니다.
노드 및 추가 항목
SG, JP, KR 또는 HK 노드와 +1TB SSD, +2TB SSD 또는 Thunderbolt 5 병렬 연결 대수를 확인합니다.
결제 기록
모든 가격은 USD로 결제되며 USDT-TRC20 및 Visa / Mastercard / Amex(Stripe 경유)만 지원됩니다. 실제 이용 가능한 결제 게이트웨이는 시스템 응답을 따릅니다.
제출 전 준비
첫 번째 문의부터 문제 파악에 필요한 정보를 갖추세요
“사용할 수 없습니다”라고만 작성하면 문제 해결이 정보 보충 단계에서 멈춥니다. 아래 순서대로 사실을 제공하고 로그에서 비밀번호, 개인 키, 전체 토큰과 서명 자료를 제거하세요.
01
주문 번호
머신 모델, 이용 기간과 인도 기록을 연결하는 데 사용하며 결제 인증 정보는 첨부하지 마세요.
02
노드
SG, JP, KR 또는 HK와 연결을 시작한 대략적인 네트워크 지역을 명시하세요.
03
발생 시간
시간대가 포함된 시간을 사용하고 최초 발생, 최근 재현과 마지막 정상 실행 시간을 표시하세요.
04
재현 단계
초기 상태부터 입력, 작업, 예상 결과와 실제 결과를 단계별로 설명하세요.
05
비식별화 로그
오류 원문, 종료 코드와 전후 맥락은 보존하되 비밀번호, 개인 키, 전체 토큰과 개인 데이터를 제거하세요.
작업을 준비한 뒤 적합한 물리 노드를 선택하세요
3가지 Apple Silicon 전용 물리 머신 요금제는 모두 비가상 머신이며 싱가포르, 일본 도쿄, 한국 서울과 홍콩 노드에서 이용할 수 있습니다. 주문 전에 워크로드, 메모리, 스토리지, 이용 기간과 연결 경로를 확인하세요.