인스턴스 및 청구 문제
SSH 연결 실패, 인스턴스 이상, 갱신, 결제 확인 또는 노드 측 기록 확인이 필요한 경우에 적합합니다. 인스턴스 ID, 시작 시각, 영향 범위와 이미 확인한 사항을 함께 적어 주세요.
최초 응답 목표: 높은 우선순위는 4시간 이내, 일반 요청은 영업일 기준 1일 이내입니다.
클라우드 Mac 기술 지원
문제가 생겼다면 여기서 시작하세요
먼저 증상별로 직접 확인해 보세요. 인스턴스, 청구 또는 노드 확인이 필요하면 콘솔에 로그인해 티켓을 제출하세요. 아직 임대 전이라면 요금제부터 살펴볼 수 있습니다.
문의 방법 선택
영향 범위를 먼저 알리고 우선순위를 선택하세요
지원 채널은 콘솔 티켓과 이메일뿐입니다. 긴급 장애도 티켓으로 접수하고 긴급 우선순위를 선택하세요. 다른 연락 방법을 찾을 필요는 없습니다.
도입 전 문의 및 자료 상담
아직 인스턴스가 없거나 적합한 모델 및 팀 구매 절차를 확인하려면 support@zshmac.com으로 이메일을 보내 주세요. 사용 목적, 예상 수량, 원하는 노드와 사용 기간을 적어 주세요.
최초 응답 목표: 영업일 기준 1일 이내에 답변합니다. 기존 인스턴스의 장애는 인스턴스 ID와 함께 티켓으로 접수해 주세요.
인스턴스 전체 중단 또는 노드 장애
인스턴스에 전혀 연결할 수 없거나 여러 연결 방식이 동시에 실패하는 경우, 또는 노드 수준의 장애가 의심되면 콘솔에서 티켓을 만들고 긴급 우선순위를 선택하세요. 데이터 상태를 확인할 수 없는 상황에서 재설치를 반복 요청하지 마세요.
최초 응답 목표: 긴급 우선순위는 1시간 이내입니다. 마지막으로 정상 접속한 시각도 함께 적어 주세요.
응답 시간은 처리 목표이며, 해당 시간 내 장애가 복구된다는 뜻은 아닙니다. 같은 문제로 이메일을 반복해서 보내는 것보다 티켓에 인스턴스 정보를 적어 주시면 원인 파악에 도움이 됩니다.
서비스 가동률
월간 목표와 실제 영향을 함께 확인하세요
판매 중인 모든 노드는 연중무휴 365일 운영됩니다. 가동률은 달력 기준 월별로 산정합니다. 연결이 끊기면 노드 측 기록을 확인할 수 있도록 티켓에 발생 시간대, 인스턴스 ID와 증상을 남겨 주세요.
해당 월 가동률이 99.9% 미만이면 서비스 이용 불가 시간에 따라 계정 잔액으로 보상합니다. 월말 후 7일 이내에 콘솔 티켓으로 신청해 주세요. 불가항력 및 사용자 조작으로 발생한 영향은 서비스 측 이용 불가 시간에 포함되지 않습니다.
월간 가동률 목표
99.9%
목표치를 보여 주는 예시이며 과거 운영 기록이 아닙니다. 최근 90일간의 실제 이벤트와 영향 설명은 콘솔의 서비스 공지 및 티켓 기록을 확인하세요.
산정 기준: 달력 기준 월
신청 방법: 콘솔 티켓
먼저 확인할 5가지
재현 가능한 증상부터 점검하세요
표에 나온 순서대로 확인하고 문제가 발생한 시각과 실제 오류 메시지를 기록하세요. 도움이 필요하면 같은 티켓에 결과를 붙여 처음부터 다시 확인하는 일을 줄여 주세요.
| 증상 | 권장 점검 순서 및 제출 정보 |
|---|---|
| SSH 연결 시간 초과 | 먼저 콘솔에서 인스턴스 실행 상태와 현재 연결 주소를 확인한 뒤, 로컬 네트워크에서 포트에 연결되는지 테스트하세요. 로컬 VPN, 프록시 및 방화벽 규칙도 확인합니다. 포트 연결은 되지만 인증에 실패한다면 사용자 이름, 키 권한 및 최근 자격 증명 변경을 확인하세요. 티켓에는 연결 시각, 외부 네트워크 정보와 전체 오류 메시지를 첨부해 주세요. |
| VNC 검은 화면 또는 해상도 이상 | 먼저 SSH 연결이 되는지 확인해 데스크톱 세션 문제인지 인스턴스 전체 연결 문제인지 구분하세요. 화면 공유 연결을 다시 설정하고 클라이언트의 해상도와 색상 설정을 확인합니다. 다시 연결해도 검은 화면이면 클라이언트 종류, 발생 시각, SSH 명령 실행 가능 여부를 기록하세요. 먼저 시스템을 재설치하지 마세요. |
| Xcode 인증서 또는 프로비저닝 프로파일 오류 | 선택한 Xcode 버전, 빌드 대상 및 서명 설정을 확인하세요. 인증서 유효 기간, 키체인 잠금 해제 여부, 프로비저닝 프로파일의 앱 ID와 기기 범위도 확인합니다. CI 환경에서는 runner 계정이 필요한 키체인에 접근할 수 있는지도 확인하세요. 티켓에는 민감 정보를 제거한 빌드 로그를 첨부하고 개인 키는 제출하지 마세요. |
| 디스크 공간 부족 | 먼저 df -h 를 실행해 볼륨의 남은 공간을 확인한 다음 DerivedData, 시뮬레이터 기기, 아카이브 파일 및 컨테이너 이미지를 점검하세요. 삭제하기 전에 빌드 캐시나 전달 기록으로 보관해야 하는지 확인하세요. 계속 증가하는 워크로드에는 스토리지 확장 및 모델 옵션을 확인해 보세요. |
| Self-hosted runner 오프라인 | 먼저 인스턴스가 온라인이고 코드 호스팅 서비스에 접근할 수 있는지 확인하세요. 이어서 runner 프로세스, 서비스 계정 권한, 등록 토큰 상태 및 작업 대기열을 점검합니다. 빌드 작업만 실패했다면 작업 로그와 종료 코드를 보관하세요. 인스턴스에도 연결할 수 없다면 SSH 연결 장애 경로로 티켓을 제출하세요. |
표의 단계는 문제 위치를 찾기 위한 것이며 인스턴스를 자동으로 변경하지 않습니다. 연결 자격 증명, 인증서 개인 키 및 전체 결제 정보를 공개 페이지에 붙여 넣지 마세요.
데이터가 변경되는 작업
재시동과 재설치는 다른 작업입니다
두 작업 모두 로그인 후 인스턴스 상세 페이지에서 시작합니다. 다음 단계를 진행하기 전에 현재 시스템 상태를 보존해야 하는지 판단하세요.
문제를 확인한 뒤 재시동
콘솔에서 대상 인스턴스로 이동해 모델과 노드를 확인하고, 진행 중인 빌드·업로드·파일 쓰기 작업이 없는지 확인한 다음 재시동하세요. 재시동 중에는 SSH, VNC 및 실행 중인 작업이 중단됩니다. 시스템이 복구되면 다시 연결해 서비스가 정상인지 확인하세요.
소요 시간은 시스템 종료 상태와 현재 작업에 따라 달라집니다. 인스턴스가 오랫동안 복구되지 않으면 작업 시각을 기록해 티켓을 제출하세요.
백업을 마친 뒤 재설치
먼저 코드 저장소, 인증서, 설정 파일 및 빌드 결과물을 인스턴스 외부에 백업하세요. 그런 다음 콘솔에서 인스턴스를 확인하고 macOS 재설치를 진행하세요. 재설치하면 인스턴스의 데이터가 모두 삭제되며 기존 환경, 캐시 및 로컬 설정을 다시 구성해야 합니다.
재설치 시간은 시스템 설치 및 인스턴스 제공 상태에 따라 달라집니다. 콘솔에 표시되는 진행 상황과 최종 자격 증명을 확인하고, 진행 중에는 작업을 반복해서 제출하지 마세요.
만료 전 확인
갱신 전 인스턴스, 사용 기간 및 청구 내역을 확인하세요. 해제를 결정했다면 먼저 외부 백업을 마치고 이 컴퓨터에 의존하는 파이프라인을 중지하세요. 해제 후에는 디스크가 삭제되므로 인스턴스를 장기 백업 공간으로 사용하지 마세요. 해제 상태나 청구 기록을 확인하려면 콘솔에 로그인해 티켓을 제출하세요.
계속 읽기
작업 단계별 자료 찾기
아래 항목은 지식 베이스의 참고 자료이며 장애 티켓이 아닙니다. 개인 인스턴스 로그 확인, 청구 변경 또는 노드 이벤트 확인이 필요하면 콘솔에서 진행하세요.
자격 증명부터 첫 연결까지
SSH 키, 명령줄 도구 및 화면 공유를 설정한 뒤 그래픽 인터페이스에 정상적으로 연결되는지 확인하세요.
시작 가이드 읽기Xcode 빌드 체인 점검
도구 체인 버전, DerivedData 캐시, 빌드 매개변수와 runner 서비스 상태를 구분하고 재현 가능한 작업 로그를 보관하세요.
기술 자료 보기서명 자료 정리
키체인 접근 권한, 인증서 유효 기간 및 프로비저닝 프로파일의 일치 여부를 확인하세요. 로그를 공유하기 전에 민감한 정보를 삭제하세요.
기술 자료 보기리소스 사용량 확인
컨테이너와 빌드 작업을 동시에 실행할 때는 통합 메모리, 디스크 및 백그라운드 프로세스의 사용량을 각각 확인하세요.
기술 자료 보기로컬 추론 워크로드 검토
먼저 모델과 컨텍스트 윈도우에 필요한 통합 메모리를 확인한 뒤 적합한 모델과 사용 기간을 선택하세요.
모델 구성 확인
후속 조치
응답 목표 시간이 지났다면 어떻게 해야 하나요?
기존 티켓에 최신 영향 범위, 최초 문의 시각 및 새로 확보한 증거를 추가하고 아직 최초 응답을 받지 못했다고 명확히 적어 주세요. 같은 티켓을 계속 사용하면 문제 해결에 필요한 맥락을 유지할 수 있습니다. 같은 장애로 티켓을 여러 개 만들지 마세요.
노드 수준의 장애가 의심되면 콘솔에 로그인한 뒤 서비스 공지를 확인하고, 티켓 업데이트를 통해 내 인스턴스의 영향 여부를 확인하세요. 공지에서는 공통 장애를 안내하며 인스턴스 복구 및 보상 확인은 티켓에서 진행합니다.
다음 단계
첫 클라우드 Mac을 준비 중이신가요?
주문부터 연결 자격 증명 발급, 첫 빌드까지 시작 가이드를 따라 단계별로 진행하세요. 도입 전 제품 선택에 관한 문의는 팀에 직접 이메일로 보내 주세요.