최초 개통
주문 확인부터 최초 검수까지
선택한 모델, 리전 및 이용 기간을 확인하고 자동 준비와 자격 증명 발급을 기다리세요. 처음 접속한 뒤 노드 정보를 기록하고 명령줄, 그래픽 인터페이스 및 Xcode 환경을 각각 확인하세요.
- 주문 상태 및 만료 시간 확인
- 호스트 지문을 확인한 후 첫 세션 생성
- 검수 결과를 저장하되 평문 자격 증명은 저장하지 않기
작업별 문제 찾기
클라우드 Mac 도움말 센터: 연결부터 빌드까지 단계별 점검
문제가 개통, 연결, 도구 체인, 파이프라인, 스토리지 또는 이용 기간 중 어디에 해당하는지 먼저 확인한 뒤 노드 정보, 자격 증명, 포트, 디스크와 시스템 작업을 차례로 점검하세요. 각 경로에는 확인 대상, 실행할 작업과 지원 티켓에 필요한 정보가 안내되어 있습니다.
- 6가지 작업
- 개통, 연결, 도구, CI/CD, 스토리지, 이용 기간
- 5단계 진단
- 노드 범위에서 특정 작업까지 좁히기
- 지원 창구 2가지
- 콘솔 티켓 및 지원 이메일
진단 기록판
순서대로 점검
사실을 먼저 기록한 후 설정 변경
-
01
주문 노드 확인 리전, 호스트 이름 및 주문 상태 기록
-
02
자격 증명 상태 확인 키, 유효 기간 및 최근 교체 확인
-
03
네트워크 경로 확인 DNS, 포트 및 로컬 네트워크 문제 구분
-
04
리소스 잔여량 확인 디스크 공간, 메모리 및 백그라운드 작업 확인
-
05
민감 정보 제거 증거 보관 시간, 명령, 종료 코드 및 로그 일부 수집
권장 기록
노드 · 시간 · 명령 · 종료 코드
작업 경로
현재 수행할 작업에 맞는 경로로 이동
모든 문서를 처음부터 읽을 필요는 없습니다. 가장 가까운 작업을 먼저 선택한 뒤 카드의 확인 순서대로 진행하세요. 주문 상태, 만료 시간 및 자격 증명 관련 사실은 콘솔에 현재 표시된 내용을 기준으로 합니다.
원격 연결
SSH 또는 VNC 세션 생성
SSH는 명령줄, 자동화 및 터널 작업에 적합하고 VNC는 macOS 그래픽 인터페이스가 필요한 작업에 적합합니다. 먼저 노드와 자격 증명을 확인한 후 로컬 네트워크와 포트를 점검하세요.
- 최초 연결 시 호스트 지문 확인
- 연결이 끊기면 먼저 로컬 네트워크와 노드 세션 구분
- 공용 기기에 민감한 연결 정보 저장 금지
개발 도구
Xcode 및 빌드 환경 확인
명령으로 Xcode 버전, 활성 개발자 디렉터리 및 도구 체인 상태를 기록하세요. 버전을 변경하기 전에 현재 출력을 보관하여 프로젝트 문제와 환경 변화를 섞지 않도록 하세요.
- 기록
xcodebuild -version출력 - 프로젝트, 의존성 및 캐시가 있는 디스크 확인
- 정리 전에 전체 오류 요약 보관
CI/CD
self-hosted runner 확인
먼저 runner의 온라인 상태, 태그 일치 여부 및 작업 디렉터리 권한을 확인한 뒤 최소 테스트 작업을 실행하세요. 처음부터 전체 파이프라인을 다시 실행하면 실패 지점을 찾기 어렵습니다.
- runner 태그 및 작업 조건 확인
- 작업 디렉터리와 캐시 디렉터리 권한 확인
- 실패한 작업의 종료 코드와 민감 정보 제거 로그 보관
스토리지 관리
공간, 캐시 및 확장 요구 사항 처리
프로젝트 파일, 의존성 캐시, 빌드 산출물 및 로그 사용량을 먼저 구분하세요. 공간이 계속 증가하면 실제 증가량에 따라 +1TB SSD, +2TB SSD를 선택하거나 정리 정책을 조정하세요.
- 남은 공간과 가장 큰 디렉터리 확인
- 재생성 가능한 캐시와 업무 데이터 구분
- 확장 전에 중요 데이터 백업 완료
이용 기간 관리
갱신, 만료 및 반출 확인
콘솔의 주문 만료 시간이 작업 기준입니다. 갱신 후 상태를 다시 확인하고, 대여를 종료할 계획이라면 코드, 키, 인증서, 로그 및 업무 데이터를 미리 반출하세요.
- 현재 만료 시간과 필요한 기간 기록
- 갱신 완료 후 주문 상태 재확인
- 종료 전에 백업, 키 폐기 및 정리 실행
빠른 진단기
현재 실패한 점검 항목 선택
외부에서 내부 순서로 점검하세요. 가장 먼저 실패한 항목을 클릭하면 기록판에서 우선 처리 경로를 안내합니다. 이전 항목을 확인하지 않았다면 이후 단계로 건너뛰어 시스템 설정을 직접 변경하지 않는 것이 좋습니다.
진단 전 준비
- 문제 발생 시간과 노드 리전 기록
- 원본 명령, 종료 코드 및 민감 정보 제거 로그 보관
- 한 번에 변수 하나만 변경하고 결과 기록
점검 순서
01—05
처리 경로
01번부터 점검 시작
먼저 콘솔에서 주문 상태, 대상 모델 및 리전을 확인하세요. 기록이 일치하는 것을 확인한 후 자격 증명, 포트, 디스크 및 시스템 작업을 계속 점검하세요.
기록: 노드 / 시간 / 현상 / 최근 변경
빌드 문제
도구 체인을 먼저 고정한 뒤 프로젝트 상태 처리
빌드 실패는 대개 단일 변수로 발생하지 않습니다. 먼저 도구 버전과 실행 환경을 기록한 뒤 서명, 캐시, 자동화 로그 및 runner 조건을 처리하면 정리 작업으로 실제 오류 증거가 덮어쓰이는 일을 피할 수 있습니다.
Xcode 버전 확인
버전 조회를 실행하고 활성 개발자 디렉터리를 기록하세요. 프로젝트 지정 버전과 현재 환경이 다르면 전환하기 전에 호환 범위를 확인하세요.
xcodebuild -version
xcode-select -p
swift --version검수: 버전, 경로 및 프로젝트 요구 사항 일치
서명 환경 확인
빌드 작업이 필요한 인증서, 프로비저닝 프로파일 및 환경 변수를 읽을 수 있는지 확인하세요. 티켓과 로그에는 이름, 시간 및 오류 요약만 남기고 유효한 키는 제출하지 마세요.
security find-identity -v -p codesigning
env | sort검수: 대상 서명 항목이 표시되고 권한이 올바름
DerivedData를 범위 내에서 정리
먼저 최초 실패 출력을 저장한 뒤 대상 프로젝트와 관련된 디렉터리만 정리하세요. 전체 디스크 정리를 첫 단계로 수행하면 다음 빌드 시간이 늘고 비교 정보가 사라질 수 있습니다.
du -sh ~/Library/Developer/Xcode/DerivedData
df -h검수: 공간 확보 후 오류가 안정적으로 재현되거나 사라짐
Fastlane 실패 단계 찾기
lane, action 및 하위 명령의 3개 계층으로 로그를 나누세요. 마지막 요약 한 줄만 잘라내지 말고 최초의 실제 오류, 종료 코드 및 실행 디렉터리를 기록하세요.
bundle exec fastlane lane_name --verbose
echo $?검수: 실패한 action과 최초 오류를 특정할 수 있음
runner 태그 및 권한 확인
self-hosted runner가 온라인인지 확인하고 작업 태그와 runner 태그가 완전히 일치하는지 확인하세요. 또한 실행 사용자가 작업, 캐시 및 빌드 디렉터리에 올바른 권한을 갖는지 검증하세요.
whoami
pwd
ls -ld .
df -h검수: 최소 테스트 작업을 수신하고 완료할 수 있음
이용 기간 및 리소스
만료 시간, 스토리지 증가 및 병렬 연결 요구 사항을 분리해 관리
갱신은 사용 기간을 해결하고, 스토리지 확장은 용량을 해결하며, Thunderbolt 5 병렬 연결은 특정 다중 기기 워크플로를 해결합니다. 세 가지는 독립적인 옵션이므로 작업 전에 현재 상태와 목표 결과를 각각 기록하세요.
갱신 및 만료 시간
콘솔의 주문 기록에서 현재 만료 시간을 확인하고 갱신 기간을 선택한 후 결제를 완료하세요. 갱신 후 주문을 다시 열어 상태와 새 만료 시간을 확인하고 로컬 캘린더 알림으로 주문 정보를 대신하지 마세요.
- 작업 위치
- 콘솔의 주문 및 이용 기간 기록
- 작업 전
- 현재 만료 시간과 필요한 기간 기록
- 작업 후
- 주문 상태 및 갱신된 만료 시간 확인
스토리지 확장
먼저 디렉터리 사용량과 증가 속도로 필요량을 판단하세요. 재생성 가능한 캐시는 우선 정리하고, 코드, 서명 자료, 빌드 산출물 및 업무 데이터는 먼저 백업한 뒤 용량 증설 여부를 결정하세요.
- +1TB SSD
- 계속 증가하는 의존성, 캐시 및 빌드 산출물
- +2TB SSD
- 여러 프로젝트, 대형 자산 또는 장기 보관
- 작업 위치
- 콘솔 주문에서 이용 가능한 추가 옵션
Thunderbolt 5 병렬 연결
여러 기기의 협업이 명확히 필요한 워크플로에 적합합니다. 주문 전에 기기 수, 연결 대상, 데이터 경로 및 검수 방법을 기록하세요. 병렬 연결 옵션은 기기별로 별도 요금이 부과됩니다.
- 확인 대상
- 병렬 연결에 참여하는 각 물리 노드
- 검수 조건
- 대상 기기 인식, 안정적인 연결 및 작업 실행 가능
- 작업 위치
- 주문 구성 시 해당 추가 옵션 선택
| 추가 옵션 | 일일 | 주간 | 월간 | 분기 |
|---|---|---|---|---|
| +1TB SSD | $2.9 | $7.9 | $14.6 | $39.7 |
| +2TB SSD | $5.8 | $15.8 | $29.2 | $79.4 |
| Thunderbolt 5 병렬 연결(기기당) | $1.1 | $2.9 | $5.3 | $14.4 |
용어 미니 사전
자주 쓰는 용어 8가지, 운영 범위 중심 설명
용어의 가치는 팀이 작업 범위를 통일하는 데 있습니다. 아래 정의는 실제 사용에 초점을 맞추며 제품명, 연결 프로토콜 및 자동화 역할을 혼동하지 않도록 설명합니다.
- 클라우드 Mac
- 네트워크를 통해 원격으로 사용하는 Mac 리소스입니다. ArmCLI 클라우드 Mac은 원격 연결이 가능한 Apple Silicon 물리 노드로, 개발, 빌드, 테스트 및 실험에 사용할 수 있습니다.
- 물리 노드
- 실제로 제공되는 하드웨어 한 대입니다. 노드 정보에는 리전, 호스트 이름, 연결 정보 및 주문 상태가 포함되며 문제 해결 시 먼저 작업 대상을 확인해야 합니다.
- 전용
- 주문 하나가 전용 물리 Mac 한 대에 해당하며 테넌트 간에 운영 체제 인스턴스를 공유하지 않습니다. 사용자는 자체 프로세스, 권한, 키 및 업무 데이터를 관리해야 합니다.
- 가상 머신 아님
- 컴퓨팅 작업은 다른 테넌트와 동일한 가상화 운영 체제 인스턴스를 공유하지 않고 대여한 물리 노드에서 직접 실행됩니다.
- VNC
- macOS 그래픽 인터페이스를 원격으로 보고 조작하는 연결 방식입니다. 창, 시뮬레이터 또는 그래픽 도구가 필요한 작업에 적합하며 연결 정보는 콘솔 주문에서 확인합니다.
- SSH
- 명령줄 연결, 파일 전송, 포트 포워딩 및 자동화 작업에 사용하는 프로토콜입니다. 최초 연결 시 호스트 지문을 확인하고 키 인증을 우선 사용하세요.
- self-hosted runner
- 팀이 직접 등록하고 클라우드 Mac에서 실행하는 파이프라인 실행기입니다. 작업 수신 여부는 온라인 상태, 태그 조건, 권한 및 작업 디렉터리 설정에 따라 결정됩니다.
- 빌드 캐시
- 반복 다운로드와 컴파일을 줄이기 위해 보관하는 중간 데이터입니다. 캐시는 반복 작업의 효율을 높이지만 용량 예산, 만료 정책 및 정기 점검이 필요합니다.
자격 증명 및 보안
연결을 복구한 후 자격 증명 정리까지 완료
액세스 복구가 문제 해결의 끝은 아닙니다. 비정상 세션을 확인하고 노출 가능성이 있는 키를 교체하며 임시 파일을 삭제하세요. 종료 전에 데이터 반출과 권한 철회가 완료되었는지도 확인해야 합니다.
안정성 및 보안 안내 보기- 01 키 교체 인원 변경, 기기 분실, 자격 증명 오전달 또는 비정상 로그인 징후가 있으면 기존 키를 폐기하고 새 키를 발급하세요.
- 02 권한 최소화 빌드 작업에는 업무 완료에 필요한 디렉터리, 명령 및 환경 변수 권한만 부여하고 장기 고권한 자격 증명으로 설정을 대신하지 마세요.
- 03 비정상 세션 종료 현재 사용자, 활성 터미널 및 백그라운드 프로세스를 확인하고 설명할 수 없는 세션을 종료한 뒤 시간과 관련 작업을 기록하세요.
- 04 민감 정보 제거 로그 명령, 시간, 종료 코드 및 오류 상황은 남기고 액세스 토큰, 개인 키, 인증서 내용, 업무 데이터 및 내부 주소는 삭제하세요.
- 05 종료 정리 완료 코드와 업무 데이터를 반출하고 원격 키를 폐기하며 임시 캐시와 민감 파일을 삭제한 뒤 콘솔에서 이용 기간 상태를 확인하세요.
지원 요청 경로
재현 가능하고 확인 가능한 문제를 3단계로 제출
정보가 완전할수록 반복 확인을 줄이기 쉽습니다. 먼저 작업 문서의 최소 점검을 완료한 뒤 노드, 시간, 명령 및 민감 정보 제거 로그를 제출하세요.
-
01
해당 작업 문서 먼저 실행
문제가 연결, 도구 체인, CI/CD, 스토리지 또는 이용 기간 중 어디에 해당하는지 확인하세요. 완료한 단계와 각 결과를 기록하고 한 번의 테스트에서 여러 변수를 동시에 변경하지 마세요.
-
02
최소 문제 패키지 준비
노드와 리전, 발생 시간, 실행 명령, 종료 코드, 최초 오류, 최근 변경 및 시도한 단계를 포함하세요. 로그는 반드시 먼저 민감 정보를 제거해야 합니다.
-
03
콘솔에서 티켓 제출
주문이 있는 경우 콘솔 티켓을 우선 사용하여 문제를 노드 및 서비스 기록과 연결하세요. 구매 전 문제이거나 콘솔에 들어갈 수 없는 경우 서비스 팀에 문의할 수 있습니다.
긴급 문제 설명 방법
제목에 “연결할 수 없음”, “빌드 차단” 또는 “주문 상태 이상”을 명시하고 본문에 노드, 시작 시간, 영향받는 작업 및 민감 정보 제거 증거를 제공하세요. 공개 채널로 유효한 자격 증명을 보내지 마세요.
시작하기
작업 규모를 정한 후 전용 물리 Mac 바로 구성
3가지 판매 모델이 싱가포르, 일본(도쿄), 한국(서울), 홍콩 및 미국 동부의 5개 리전에 제공됩니다. 실제 이용 가능 여부는 콘솔의 실시간 결과를 기준으로 합니다.