클라우드 Mac 지원 센터

먼저 장애 계층을 파악한 후 진단 가능한 정보를 제출하세요

연결할 수 없거나 빌드가 실패하거나 러너가 대기열에서 멈췄더라도 환경 재설치부터 시작할 필요는 없습니다. 먼저 주문, 네트워크, 시스템, 툴체인의 네 계층을 점검한 뒤 핵심 로그를 지원 담당자에게 전달하세요.

  • VNC, SSH, Xcode 및 CI/CD를 পৃথ어 진단
  • 주문 번호, 노드, 시간 및 전체 오류 상황을 제출
  • 키, 토큰 및 서명 암호는 로그에서 반드시 삭제
클라우드 Mac 바로 대여 콘솔에서 지원 티켓 제출
진단 요청 BUILD-SUPPORT
점검 준비
01
서비스 제공 상태 확인 주문, 노드 주소 및 자격 증명 출처 일치
기본 계층
02
연결 경로 구분 VNC, SSH 및 로컬 네트워크를 각각 테스트
네트워크 계층
03
빌드 변수 축소 scheme, Xcode 버전 및 종속성 상태 고정
도구 계층
04
실패 상황 보존 시간, 명령, 로그 및 수행한 단계 기록
증거 계층
목표: 문제를 재현·파악하고 계속 처리할 수 있게 만들기 4계층 진단
문제 유형별로 시작

6가지 지원 경로, 6가지 점검 시작점

문제가 연결, 빌드, 자동화, 네트워크, 스토리지 또는 결제 중 어디에 해당하는지 먼저 판단하세요. 정확히 분류하면 여러 로그를 오가며 확인하는 일을 줄일 수 있습니다.

원격 연결

VNC 화면 및 세션

검은 화면, 시간 초과, 키보드 배열, 클립보드 및 세션 끊김을 다룹니다. 먼저 클라이언트 이름, 네트워크 출구 및 발생 시간을 기록하세요.

Xcode 빌드

서명, 종속성 및 아카이브

인증서, 프로비저닝 프로파일, Keychain 권한, DerivedData, 종속성 캐시, 디스크 여유 공간 및 내보내기 설정을 확인하세요.

CI/CD

러너 대기열 및 작업 디렉터리

레이블 일치, 서비스 프로세스, 프로젝트 권한, 동시 실행 수, 작업 디렉터리 권한 및 실패 작업 후 정리 동작을 확인하세요.

네트워크

저장소, 종속성 소스 및 원격 액세스

로컬 네트워크, 노드의 외부 연결, 코드 저장소 및 종속성 다운로드 소스를 구분하세요. 단일 서비스 시간 초과를 전체 시스템 오프라인으로 오판하지 마세요.

스토리지 추가 구매

용량 평가 및 확장 상담

먼저 프로젝트, DerivedData, 종속성 캐시, 아카이브 및 모델 파일의 사용량을 집계한 후 +1TB, +2TB SSD 또는 병렬 연결 요구 사항을 상담하세요.

청구

기간, 추가 항목 및 결제 기록

주문 번호, 결제 주기, 결제 유형 및 페이지 안내를 제공하세요. 공개 이메일에 전체 결제 정보나 민감한 정보를 보내지 마세요.

7단계 빠른 자가 점검

머신 연결을 확인한 후 툴체인으로 진행

순서대로 실행하세요. 이전 단계를 확인하지 않은 상태에서 캐시를 삭제하거나 종속성을 재설치하면 원래 장애 단서가 덮어써질 수 있습니다.

  1. 01

    주문 상태 확인

    콘솔에 로그인해 주문이 제공 완료되었는지 확인하고, 모델, 기간 및 노드가 현재 점검 대상과 일치하는지 확인하세요. 주문 정보가 이상하면 먼저 주문 번호와 페이지 안내를 기록하세요.

    주문 계층
  2. 02

    노드 주소 확인

    VNC와 SSH가 제공 정보의 주소와 포트를 사용하는지 확인하세요. 이전 노드, 오래된 북마크 또는 다른 주문의 연결 설정을 사용하지 마세요.

    주소 지정 계층
  3. 03

    계정 자격 증명 확인

    사용자 이름, 비밀번호 입력 및 키보드의 대소문자 상태를 확인하세요. 비밀번호, 개인 키 또는 복구 정보를 지원 티켓 본문에 붙여 넣지 마세요.

    액세스 계층
  4. 04

    VNC 클라이언트 교차 테스트

    클라이언트 이름, 버전 및 화질 설정을 기록하세요. 가능하면 다른 로컬 기기나 네트워크에서 다시 테스트해 클라이언트 문제인지 구분하세요.

    데스크톱 계층
  5. 05

    SSH 연결 테스트

    DNS 확인, 연결 수립 및 인증이 각각 어느 단계에서 멈추는지 기록하세요. VNC는 연결되지 않지만 SSH가 정상이라면 전체 네트워크보다 그래픽 세션을 먼저 확인하는 것이 일반적입니다.

    네트워크 계층
  6. 06

    디스크 공간 확인

    시스템 디스크의 잔여 용량과 DerivedData, 종속성 디렉터리, 아카이브, 시뮬레이터 및 모델 파일을 확인하세요. 공간 부족은 원인을 알아보기 어려운 다양한 빌드 오류를 일으킬 수 있습니다.

    리소스 계층
  7. 07

    Xcode 버전 고정

    실제로 선택된 Xcode 경로와 버전을 기록하고, CI 스크립트와 대화형 빌드가 동일한 툴체인을 사용하는지 확인한 뒤 실패한 명령을 다시 재현하세요.

    도구 계층
원격 액세스 문제 해결

화면, 네트워크 및 입력 문제를 구분하세요

VNC는 그래픽 세션이고 SSH는 명령줄 경로입니다. 두 가지를 각각 테스트하면 장애가 로컬 클라이언트, 네트워크 경로 또는 노드 세션 중 어디에 있는지 빠르게 판단할 수 있습니다.

원격 액세스의 일반적인 현상, 우선 점검 사항 및 지원 티켓 자료
현상 먼저 할 일 기록할 내용 하지 말아야 할 일
VNC 검은 화면 세션 초기화를 기다린 후 연결을 한 번 다시 수립하고 SSH가 정상적으로 응답하는지 테스트하세요. 클라이언트 이름, 발생 시간, 노드, SSH 테스트 결과 및 검은 화면 캡처 강제로 연속 재연결하거나 시스템 및 사용자 설정을 즉시 삭제하지 마세요.
연결 시간 초과 로컬 네트워크를 바꿔 다시 테스트하고 주소와 포트가 정확한지 확인한 뒤 DNS 확인 시간 초과와 인증 시간 초과를 구분하세요. 로컬 네트워크 유형, 오류 원문, 시작 및 실패 시간, 다른 네트워크에서의 재현 결과 로그에 비밀번호, 개인 키 또는 전체 인증 내용을 공개하지 마세요.
키보드 배열 이상 로컬 및 원격 키보드 배열, 입력 방식 및 보조 키 매핑을 확인하고 일반 텍스트 편집기로 테스트하세요. 클라이언트, 키보드 배열, 이상 입력 키 및 재현 단계 IDE 단축키만으로 판단하지 말고 먼저 애플리케이션 자체의 키 설정을 배제하세요.
클립보드 사용 불가 클라이언트에서 클립보드 동기화를 허용했는지 확인하고 일반 텍스트와 짧은 내용을 각각 테스트하세요. 복사 방향, 콘텐츠 유형, 클라이언트 버전 및 모든 애플리케이션에서 실패하는지 여부 키, 토큰 또는 서명 암호를 테스트 내용으로 사용하지 마세요.
세션 끊김 끊기기 전 작업과 지속 시간을 기록한 뒤 SSH가 계속 연결되어 있는지와 로컬 네트워크가 전환되었는지 확인하세요. 정확한 발생 시간, 전면 애플리케이션, 네트워크 변경, 재연결 결과 및 관련 로그 장애 발생 당시의 리소스 상태가 덮어써지지 않도록 빌드 작업을 반복해서 재시작하지 마세요.
Xcode 빌드 문제

마지막 줄이 아니라 첫 번째 유효 오류부터 확인하세요

서명, 캐시, 디스크 및 내보내기 오류는 연쇄적으로 발생하는 경우가 많습니다. 툴체인과 재현 명령을 고정한 후 로그에서 가장 먼저 나타난 명확한 실패 원인부터 확인하세요.

SIGN

인증서 및 프로비저닝 프로파일

bundle identifier, 팀, 인증서 유형 및 프로비저닝 프로파일 용도가 일치하는지 확인하세요. 동일한 타깃에서 자동 서명과 수동 서명을 변경 기록 없이 혼용하지 마세요.

  • 실패한 target 및 configuration 기록
  • 서명 자산의 유효 기간과 적용 범위 확인
  • codesign의 전체 오류 상황 보존
KEYCHAIN

Keychain 권한

대화형 빌드는 성공하지만 CI 빌드가 실패한다면 runner 세션이 필요한 서명 항목에 액세스할 수 있는지와 작업 컨텍스트의 권한 차이를 중점적으로 확인하세요.

  • 로컬 터미널과 runner 실행 사용자 비교
  • 작업 실행 시 키체인 상태 확인
  • 로그에서 서명 암호와 민감한 값 삭제
CACHE

DerivedData 및 종속성 캐시

먼저 오류가 안정적으로 재현되는지 확인한 후 단일 프로젝트만 대상으로 정리하세요. 전체 디스크의 캐시 삭제를 기본 조치로 삼으면 실제로 문제가 발생한 캐시 계층을 판단하기 어렵습니다.

  • 캐시 디렉터리와 적중 정책 기록
  • lockfile 및 종속성 관리자 버전 고정
  • 정리 전후의 빌드 로그를 각각 한 번씩 보존
DISK

디스크 공간

아카이브, 시뮬레이터, 종속성 및 이전 산출물이 동시에 공간을 차지합니다. 공간 부족은 쓰기 실패뿐 아니라 종속성 압축 해제 또는 서명 과정의 이상으로 나타날 수도 있습니다.

  • 시스템 디스크의 잔여 용량 기록
  • 프로젝트별 아카이브 및 캐시 사용량 확인
  • 정리 전에 보존해야 할 산출물 확인
EXPORT

아카이브 및 내보내기

archive 생성 실패와 export 실패를 구분하세요. 전자는 컴파일과 서명을, 후자는 내보내기 옵션, 대상 채널 및 아카이브의 서명 정보를 중점적으로 확인합니다.

  • archive가 정상 생성되었는지 명시
  • 내보내기 설정과 오류 요약 보존
  • 산출물 대상과 scheme 일치 여부 확인
REPRO

최소 재현 명령

지원 티켓에 작업 디렉터리, Xcode 버전, scheme, configuration 및 실행 명령을 명확히 작성하세요. CI에서만 실패한다면 민감한 값을 제거한 환경 차이도 함께 제공하세요.

  • 오류 전후의 최소 한 구간 상황 보존
  • 그래픽 인터페이스 빌드 성공 여부 설명
  • 이미 시도했지만 효과가 없었던 단계 나열
CI runner 문제 해결

레이블은 작업 위치를, 디렉터리는 실패 후 남는 내용을 결정합니다

대기열이 움직이지 않으면 먼저 레이블과 온라인 상태를 확인하세요. 작업이 시작된 후 실패한다면 실행 사용자, 작업 디렉터리, 동시 실행 및 정리 정책을 확인하세요.

Runner 점검표

네 가지 변수를 함께 기록해야 합니다

실행 가능한 점검
LABEL 레이블 일치

작업에 필요한 레이블이 runner 등록 레이블과 완전히 일치하는지 확인하고, 프로젝트 또는 브랜치 조건으로 제외되지 않았는지도 확인하세요.

WORKDIR 작업 디렉터리

전용 실행 사용자가 디렉터리를 읽고 쓸 수 있어야 하며, 프로젝트 간에 상태가 남는 임시 경로를 공유하지 마세요.

CONCURRENCY 동시 실행 제한

메모리, 디스크 및 빌드 유형에 따라 동시 실행 수를 설정하세요. 작업이 너무 많다면 먼저 대기 중인지 리소스를 이미 경쟁하고 있는지 판단하세요.

CLEANUP 정리 정책

각 작업 종료 후 무엇을 보존하고 삭제할지 명확히 정하고, 실패 작업에는 충분한 로그와 진단 산출물을 남기세요.

GitHub Actions

runs-on 및 runner 그룹 확인

저장소 또는 조직의 runner 액세스 범위, 레이블 표기, 서비스 상태 및 작업 디렉터리 권한을 확인하세요. 작업이 대기 상태라면 완전히 일치하는 온라인 runner 레이블이 있는지 먼저 확인하세요.

GitLab CI

tags 및 프로젝트 권한 확인

job tags, runner 잠금 범위, 프로젝트 권한 및 동시 실행 설정을 확인하세요. 작업이 시작된 후 실패했다면 실행기 로그와 프로젝트 스크립트 출력을 추가하세요.

기타 self-hosted runner

실행 ID 및 수명 주기 고정

runner 소프트웨어, 시작 방식, 실행 사용자, 작업 디렉터리 및 정리 스크립트를 설명하세요. 사용자 지정 스케줄러라면 작업 수신, 시간 초과 및 종료 코드 처리 방식도 기록해야 합니다.

용어 미니 사전

8개 용어로 문제 범위를 먼저 통일하세요

상담 시 동일한 용어를 사용하면 물리 리소스, 원격 프로토콜 및 자동화 소프트웨어를 혼동하지 않고 설명할 수 있습니다.

물리 노드
macOS가 실제로 실행되는 Apple Silicon 장비로, 공유 호스트에서 분할된 가상 인스턴스가 아닙니다.
전용
주문에 해당하는 컴퓨팅 리소스, 메모리 및 로컬 스토리지를 해당 사용자만 사용하며 다른 테넌트와 동일한 실행 인스턴스를 공유하지 않습니다.
비가상 머신
시스템이 물리 장비에서 직접 실행됩니다. 문제 해결 시 실제 macOS 호스트, 네트워크 및 주변 장치 경로를 기준으로 이해해야 합니다.
VNC
macOS 그래픽 인터페이스에 액세스하는 원격 데스크톱 프로토콜입니다. 화면, 입력 및 클립보드 문제는 일반적으로 클라이언트와 세션 계층에서 점검합니다.
SSH
명령줄 연결과 자동화 실행에 사용하는 프로토콜입니다. 노드가 온라인인지, 그래픽 세션 문제가 별도로 존재하는지 판단하는 데 도움이 됩니다.
self-hosted runner
팀이 클라우드 Mac에 배포하고 CI 플랫폼 작업을 수신하는 실행 프로그램입니다. 레이블과 프로젝트 권한은 팀이 직접 구성합니다.
빌드 캐시
반복적인 다운로드와 컴파일을 줄이기 위해 보존하는 종속성 또는 중간 산출물입니다. 캐시에는 버전 키, 용량 한도 및 정리 정책이 필요합니다.
병렬 연결
해당 작업에 여러 장비 또는 Thunderbolt 5 연결 방식을 사용하는 상담 항목입니다. 모든 빌드 도구가 자동으로 선형적인 성능 향상을 얻는다는 의미는 아닙니다.
지원 티켓 작성 기준

지원 담당자가 정보를 받는 즉시 진단을 시작할 수 있게 하세요

지원 티켓의 가치는 글의 길이가 아니라 시간, 대상, 재현 단계 및 원본 오류가 빠짐없이 포함되어 있는지에 있습니다.

지원 티켓 자료 목록 DIAGNOSTIC PACK
제출 전 확인
01

주문 번호 및 노드

문제가 발생한 주문 번호와 실제 노드를 명시하세요. 노드는 싱가포르, 도쿄, 서울 또는 홍콩 중 하나입니다. 여러 머신은 각각 표시해야 합니다.

02

재현 시간

시간대가 포함된 발생 시각과 지속 시간을 제공하세요. 문제가 반복되면 최근 2~3회의 발생 시점을 나열하세요.

03

오류 로그

오류 전후 상황, 실행 명령 및 종료 코드를 보존하세요. 캡처는 보조 자료로 사용할 수 있지만 복사 가능한 로그 텍스트를 대신해서는 안 됩니다.

04

수행한 단계

확인, 변경 및 재테스트한 내용을 순서대로 나열하고 각 단계의 결과를 적으세요. 지원 담당자가 같은 작업을 반복 요청하는 일을 줄일 수 있습니다.

05

예상 결과와 실제 결과

원래 무엇을 완료하려 했는지와 현재 어느 단계에서 멈췄는지 설명하세요. 빌드 문제라면 scheme, Xcode 버전 및 실행 방식을 명시해야 합니다.

제출 전 민감 정보 삭제

모든 인증 자료 삭제

로그, 캡처 및 설정 조각에서 비밀번호, 개인 키, 액세스 토큰, 서명 암호, 결제 정보 및 로그인이나 권한 부여에 사용할 수 있는 기타 내용을 삭제하세요.

두 가지 문의 채널

주문 문제는 지원 티켓, 일반 상담은 이메일 이용

이미 주문한 문제는 주문과 노드를 연결할 수 있도록 콘솔에서 우선 지원 티켓을 제출하세요. 일반적인 솔루션 상담은 다음 이메일로 보낼 수 있습니다 support@macvpsgo.com。

콘솔 지원 티켓 제출 문의 방법 보기
서비스 지원 경로

문제에 따라 적절한 처리 대기로 이동하세요

올바른 경로를 선택하는 것이 반복해서 문의하는 것보다 효과적입니다. 하드웨어 및 연결 문제는 주문 연결이 필요하며, 일반 사용 상담과 기업 요구 사항은 먼저 사용 시나리오를 정리하는 것이 좋습니다.

상담

사용 및 구성 상담

Xcode 버전, CI 마이그레이션, 동시 실행 규모, 스토리지 요구 사항 및 3가지 구성 중 선택에 적합합니다.

문의 페이지로 이동
연결

VNC 또는 SSH 문제

이 페이지의 빠른 자가 점검을 완료한 후 주문 번호, 노드, 발생 시간 및 교차 테스트 결과를 첨부해 콘솔 지원 티켓을 제출하세요.

연결 문제 티켓 제출
하드웨어

물리 노드 이상 의심

VNC와 SSH에 모두 연결할 수 없거나 재현 가능한 디스크, 네트워크 또는 장비 이상이 있다면 반복 작업을 중지하고 시간과 로그를 보존하세요.

하드웨어 이상 티켓 제출
청구

주문 및 결제 문제

주문 번호, 기간, 결제 유형 및 페이지 안내를 제공하세요. 실제 이용 가능한 결제 게이트웨이는 콘솔에 실시간으로 표시되는 내용을 기준으로 합니다.

청구 티켓 제출

다음 빌드를 실행할 준비가 되었나요?

Go M4 Core, Go M4 Plus 또는 Go M4 Pro를 선택하고 현재 판매 중인 4개 노드에서 구성을 완료하세요. 실제 이용 가능 여부는 콘솔의 실시간 상태를 기준으로 합니다.

클라우드 Mac 바로 대여 3가지 요금제 보기