클라우드 Mac 기술 지원

문제 범위를 파악하고 재현 가능한 정보를 준비하세요

연결 문제는 기기 상태와 접속 정보부터, 빌드 문제는 Xcode·종속성·서명 환경부터 점검하세요. CDNMac은 가상 머신이 아닌 전용 물리 Mac을 제공하며, 프로젝트 코드와 개발자 계정, 서명 자료는 고객이 직접 관리합니다.

클라우드 Mac 대여하기 콘솔에 로그인해 문의하기

주문이 있다면 주문 ID, 선택한 노드, 발생 시각, 민감 정보를 가린 로그를 함께 보내 주세요. 실제 기기 상태와 이용 가능한 작업은 콘솔에 표시되는 최신 정보를 기준으로 합니다.

문의 유형 6가지 연결·빌드·서명·네트워크·결제·노드별 분류

준비 자료 6가지 문의에 필요한 정보를 한 번에 준비

연중 가동 노드 연중 365일 가동

문제 인계 기록 증상부터 재현 절차까지

정보가 갖춰지면 처리 대기열에 등록

문제 범위 확인

한 대의 기기, 하나의 저장소, 한 번의 빌드에서 발생하는 문제인지, 아니면 모든 연결 방식에 영향을 주는지 기록하세요.

기기 상태: 콘솔의 현재 상태 확인
선택한 노드: 주문에 연결된 지역 기록

문제 발생 단계 좁히기

네트워크, 시스템 접속, 툴체인, 프로젝트 종속성, 서명 단계를 각각 확인하세요. 여러 설정을 동시에 변경하지 마세요.

최소 재현 절차: 일관되게 재현되는 절차 기록
발생 시각: 최초 및 최근 발생 시각 기록

필요한 증거 전달

민감 정보를 가린 로그, 기대 결과, 시도한 조치를 보내 주세요. 개인 키, 토큰, 인증서 암호, 전체 결제 정보는 보내지 마세요.

로그 범위: 명령어·단계·타임스탬프 포함
기대 결과: 정상 상태가 무엇인지 설명

먼저 문제 유형을 선택하세요

6가지 문의 유형별 필수 정보

주요 증상에 따라 유형을 선택한 다음 해당 자료를 준비하세요. 문의 하나에는 핵심 문제 하나만 담고, 관련 증상은 재현 절차에 덧붙이세요.

연결할 수 없음

기기 연결 불가와 인증 정보 오류를 구분하세요

콘솔의 기기 상태, SSH 또는 VNC 오류 원문, 로컬 네트워크 환경, 최초 발생 시각을 기록하세요. 특정 접속 방식에서만 실패하는지도 알려 주세요.

준비 항목: 노드, 접속 네트워크, 오류, 시각

빌드 실패

어느 빌드 단계에서 실패하는지 확인하세요

Xcode 및 Command Line Tools 버전, 사용한 잠금 파일, 실패한 명령어, 대상 scheme, 남은 디스크 공간, 로그에서 처음 발생한 유효 오류를 알려 주세요.

준비 항목: 버전, 명령어, 단계, 민감 정보를 가린 로그

코드 서명 문제

인증서·프로비저닝 프로파일·대상 설정 확인

민감 정보를 가린 서명 오류, bundle identifier, 대상 환경, 인증서 유효 상태를 보내 주세요. 인증서 암호, 개인 키, 바로 사용할 수 있는 토큰은 보내지 마세요.

준비 항목: 대상, 식별자, 유효 상태, 오류

네트워크 문제

왕복 지연 시간과 실제 다운로드 경로를 각각 테스트하세요

접속 회선 사업자, 네트워크 유형, 대상 노드, 연속 측정값의 중앙값을 기록하세요. 저장소를 가져오거나 종속성을 다운로드할 때도 문제가 발생하는지 알려 주세요.

준비 항목: 회선 사업자, 네트워크 유형, 측정값, 대상

결제 문의

주문 항목에서 기본 구성과 추가 옵션 확인

주문 ID, 대여 기간, 기본 구성, SSD 또는 Thunderbolt 5 병렬 처리 항목을 알려 주세요. 문의에 전체 결제 정보를 입력하지 마세요.

준비 항목: 주문, 기간, 구성, 추가 옵션

노드 이전

이전 사유와 데이터 인계 범위를 먼저 알려 주세요

현재 노드, 원하는 접속 방향, 보존할 작업 디렉터리와 결과물을 기록하고 환경을 다시 배포해도 되는지 알려 주세요. 이용 가능한 범위는 콘솔의 최신 정보를 확인하세요.

준비 항목: 현재 노드, 원하는 방향, 데이터 범위

연결 문제 해결

정해진 순서대로 점검해 네트워크 문제를 기기 장애로 오인하지 마세요

각 단계를 마치고 결과를 기록한 뒤 다음 단계로 넘어가세요. 점검 중에 키 교체, 방화벽 변경, 로컬 네트워크 재시작을 동시에 하면 원인을 파악하기 어렵습니다.

기기 상태 확인

먼저 콘솔에서 주문과 기기 상태를 확인하고 현재 노드와 기기 ID를 대조하세요. 상태가 바뀌는 중이면 콘솔에 안정된 결과가 표시된 후 연결을 테스트하세요.

접속 정보 확인

현재 기기에 해당하는 시스템 사용자 이름, 호스트 주소, 최신 접속 정보를 사용 중인지 확인하세요. 다른 주문의 접속 정보를 이 기기에 사용하지 마세요.

SSH 연결 확인

신뢰할 수 있는 네트워크에서 호스트와 포트에 연결되는지 테스트한 다음 키 파일 권한과 인증 오류를 확인하세요. 타임스탬프가 있는 오류를 저장하되 개인 키 내용은 보내지 마세요.

VNC 세션 확인

SSH는 정상이지만 그래픽 세션에 문제가 있다면 VNC 클라이언트, 연결 단계, 화면 상태를 따로 기록하세요. 그래픽 세션 문제를 기본 네트워크 장애로 분류하지 마세요.

로컬 방화벽 확인

회사 네트워크, VPN, 아웃바운드 정책, 로컬 방화벽이 대상 포트를 차단하는지 확인하세요. 신뢰할 수 있는 다른 네트워크에서도 테스트하면 로컬 연결 경로의 문제인지 판단하는 데 도움이 됩니다.

ping 한 번으로 확인할 수 있는 것은 그 시점의 왕복 시간뿐입니다. VNC 반응 속도, 종속성 다운로드 속도, 전체 빌드 시간까지 알 수는 없습니다. 연속 측정값과 실제 작업을 함께 확인하세요.

빌드 문제 해결

툴체인 버전부터 첫 번째 유효 오류까지 확인하세요

빌드 로그에는 후속 오류가 연달아 기록되는 경우가 많습니다. 먼저 작업을 중단시킨 최초의 유효 오류를 찾고, 관련 도구·종속성·서명·디스크 상태를 확인하세요.

Xcode 및 대상 SDK

Xcode 전체 버전, 대상 플랫폼, scheme, configuration, 실제로 호출된 도구 경로를 기록하세요. 그래픽 인터페이스와 명령줄에서 같은 버전을 사용해야 합니다.

Command Line Tools

현재 선택된 개발자 디렉터리가 예상 경로와 버전에 맞는지 확인하세요. Xcode를 업그레이드한 뒤 명령줄 도구가 올바른 경로를 가리키는지 다시 점검하세요.

종속성 및 잠금 파일

프로젝트에서 사용하는 잠금 파일을 유지하고 종속성 복원 명령어와 캐시 정책을 기록하세요. 캐시 문제인지 확인하기 전에 깨끗한 작업 디렉터리에서 다시 테스트하세요.

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

인증서 유효 상태, bundle identifier, 대상 환경, 서명 설정이 서로 맞는지 확인하세요. 민감 정보를 가린 오류만 제출하고 개인 키나 인증서 암호는 보내지 마세요.

디스크 여유 공간 및 임시 디렉터리

소스 코드, 종속성 캐시, DerivedData, Archive, 내보낸 결과물이 차지하는 전체 공간을 확인하세요. 공간이 부족하면 다시 생성할 수 있는 캐시부터 정리하세요.

로그 타임스탬프 및 실패 단계

작업 시작, 최초 오류, 작업 종료 시각을 기록하고 종속성 복원·컴파일·Archive·서명·내보내기 중 어느 단계에서 실패했는지 표시하세요.

CI/CD 연결

전용 물리 Mac을 관리형 self-hosted runner로 등록

CDNMac M4에서 저장소 변경으로 시작되는 iOS 빌드 작업을 실행할 수 있습니다. GitHub Actions, GitLab CI, Jenkins 또는 다른 스케줄러에 연결할 때는 실행 노드를 일회용 컨테이너가 아닌 상시 운영되는 빌드 호스트로 관리하세요.

저장소마다 별도의 작업 디렉터리를 만들고, 정리하지 않은 빌드 캐시를 여러 프로젝트에서 공유하지 마세요.
토큰에는 작업 수행에 필요한 최소 권한만 부여하고 저장소별로 따로 설정하세요.
서명 자료는 통제된 위치에 보관하고 파이프라인 로그에 키, 토큰, 인증서 암호가 출력되지 않도록 하세요.
작업이 끝나면 임시 파일, 파생 데이터, 더 이상 필요하지 않은 결과물 복사본을 정리하세요.
runner에 명확한 라벨을 설정해 호환되지 않는 작업이 잘못 배정되지 않도록 하세요.

시작 연결 안내 보기

빌드 작업 인계표 RUNNER / M4

신뢰할 수 있는 작업 수신

저장소, 브랜치, runner 라벨을 기준으로 작업 수락 여부를 결정합니다.

대기열

종속성 복원

잠금 파일과 저장소 전용 캐시를 사용하고 캐시 적중 여부를 기록합니다.

작업 공간

Archive 실행

Xcode 경로, scheme, configuration, 내보내기 매개변수를 고정합니다.

아카이브

전달 및 정리

필요한 결과물을 복사한 뒤 임시 디렉터리를 정리하고 민감 정보를 가린 진단 로그를 보관합니다.

결과물

격리 단위: 저장소 인증 정보 정책: 최소 권한 정리 시점: 작업 완료 후

용어 미니 사전

자주 쓰는 용어 8개와 점검 기준

문의에서 용어를 통일하면 물리 기기, 접속 프로토콜, 자동화 실행기, 최종 결과물을 더 빠르게 구분할 수 있습니다.

클라우드 Mac: 네트워크를 통해 원격으로 사용하는 Mac 기기입니다. CDNMac은 다른 주문과 같은 기기를 공유하지 않는 전용 물리 Mac을 제공합니다.
물리 노드: 기기가 실제로 배치되고 네트워크에 연결되는 지역입니다. 노드 선택은 연결 경로에 영향을 주지만 전체 빌드 시간을 단독으로 결정하지는 않습니다.
전용: 주문 하나에 기기 한 대와 해당 기기의 리소스 및 접속 환경이 배정되며, 여러 대여자가 계산 리소스를 나눠 쓰지 않습니다.
가상 머신이 아님: 작업은 여러 가상 인스턴스로 분할된 호스트가 아니라 실제 Mac 하드웨어에서 실행됩니다.
VNC: macOS 그래픽 인터페이스에 원격으로 접속하는 세션 방식입니다. 화면 상태를 확인하거나 GUI 작업을 수행할 때 적합합니다.
SSH: 명령줄 작업, 스크립트 실행, 파일 전송에 사용하는 암호화 연결 방식입니다. 자동화 작업과 일반적인 시스템 관리에 적합합니다.
self-hosted runner: 팀이 직접 관리하며 CI 시스템에 등록하는 작업 실행기입니다. 지정된 클라우드 Mac에서 파이프라인 작업을 받아 실행합니다.
빌드 결과물: 컴파일, Archive 또는 내보내기 과정에서 생성된 파일과 필요한 로그입니다. 팀이 관리하는 저장소로 복사하고 보존 정책을 설정해야 합니다.

문의 전 준비

자료 6가지를 준비한 다음 콘솔에서 문의하세요

짧은 메시지를 여러 번 보내는 것보다 문제 상황을 빠짐없이 설명하는 편이 재현에 도움이 됩니다. 민감한 정보는 종류와 상태만 설명하고 실제 사용할 수 있는 원문은 보내지 마세요.

주문 ID

콘솔에 표시된 주문 ID 또는 기기 ID를 알려 주시면 해당 기종, 대여 기간, 기기 정보를 확인할 수 있습니다.

선택한 노드

현재 기기가 있는 노드를 구체적으로 적어 주세요. ‘아시아’ 또는 ‘미국’만 적지 마세요. 이전이 필요하다면 원하는 접속 방향도 알려 주세요.

발생 시각

최초 발생, 최근 재현, 작업 종료 시각을 시간대와 함께 기록하세요. 기기 및 네트워크 로그와 대조하는 데 도움이 됩니다.

재현 절차

입력값, 명령어, 대상, 결과를 순서대로 적어 주세요. 매번 발생하지 않는 문제라면 발생 빈도와 조건도 알려 주세요.

민감 정보를 가린 로그

오류 맥락과 타임스탬프는 남기고 개인 키, 토큰, 인증서 암호, 개인 정보, 전체 결제 정보는 삭제하세요.

기대 결과

정상이라면 어떤 상태, 파일, 반환값이 표시되어야 하는지 설명하고 이미 시도했지만 해결되지 않은 조치도 적어 주세요.

콘솔에서 문의하기 문의 방법 보기

지원 범위

어떤 문제를 지원하고 어떤 항목을 팀에서 관리해야 하나요?

기기·네트워크, 시스템 접속, 툴체인 안내, 프로젝트 자체의 책임 범위를 먼저 구분하면 잘못된 계층의 설정을 반복해서 수정하지 않아도 됩니다.

하드웨어 및 네트워크 상태

기기 상태, 노드 측 네트워크, 주문 연결 정보, 콘솔에 표시되는 관리 상태를 확인하고 재현 가능한 정보를 바탕으로 문제를 처리합니다.

CDNMac 지원 범위

시스템 접속 지원

기기에 연결할 수 있는지, 접속 정보가 현재 기기에 해당하는지, SSH 또는 VNC 문제가 네트워크·인증·세션 중 어느 단계에서 발생하는지 확인합니다.

CDNMac 지원 범위

빌드 도구 점검 안내

로그를 바탕으로 Xcode, Command Line Tools, 디스크, 빌드 단계를 함께 확인할 수 있습니다. 프로젝트 종속성과 스크립트는 프로젝트 팀에서 검증해야 합니다.

공동 점검 범위

프로젝트 및 개발자 자료

프로젝트 코드, 개발자 계정, 인증서, 프로비저닝 프로파일, 접속 키, 소프트웨어 라이선스, 종속성 버전, 작업의 적법성은 고객이 관리해야 합니다.

고객 관리 범위

보안 안내

인증 정보·서명 자료·빌드 결과물의 정리 절차를 하나로 관리하세요

전용 기기를 사용해도 리소스 공유에 따른 위험이 줄어들 뿐, 팀 자체의 권한 관리를 대신할 수는 없습니다. 최초 접속, 지속적인 운영, 대여 종료 시점마다 명확한 절차를 마련하세요.

최소 권한 사용

CI 토큰, 저장소 키, 자동화 계정에는 현재 작업에 필요한 권한만 부여하세요. 여러 프로젝트가 하나의 고권한 인증 정보를 장기간 함께 사용하지 않도록 하세요.

인증 정보 정기 교체

키와 토큰 교체 내역을 기록하세요. 구성원, 저장소, 작업 범위가 바뀌면 더 이상 필요하지 않은 접근 권한을 즉시 회수하세요.

만료된 인증서 제거

인증서와 프로비저닝 프로파일의 유효 상태를 정기적으로 확인하고 사용하지 않는 사본을 삭제해 파이프라인에서 오래된 설정을 선택하지 않도록 하세요.

필요한 결과물 미리 내보내기

대여 종료 전에 소스 변경 사항, 빌드 로그, Archive, 필요한 결과물을 팀이 관리하는 저장소로 복사하고 파일을 읽을 수 있는지 확인하세요.

문제를 재현했나요? 필요한 정보를 갖춰 콘솔에서 문의하세요

주문 ID, 노드, 발생 시각, 재현 절차, 민감 정보를 가린 로그, 기대 결과를 보내 주세요. 평문 키, 토큰, 인증서 암호는 보내지 마세요.

콘솔에서 문의하기 최초 연결 방법 보기