클라우드 Mac 연결 및 CI/CD 문제 해결 가이드

첫 연결

연결 전 네 가지 항목 확인

채팅 기록이나 이전 문서에서 주소와 인증 정보를 복사하지 마세요. 노드 상태, 연결 주소, 계정 정보와 접근 제어는 현재 주문의 콘솔 반환값을 기준으로 확인하세요.

01

노드 상태 확인

먼저 주문에 연결된 물리 노드가 연결 가능한 상태인지 확인하세요. 상태가 계속 업데이트 중이면 주문 ID를 보관하고 콘솔의 다음 안내를 기다리세요. 중복 주문을 연속으로 생성하지 마세요.

주문 ID가 선택한 모델과 일치함
리전이 실제 워크플로 목표와 일치함
연결 정보가 모두 표시됨

02

주소와 포트 확인

호스트 주소와 포트를 한 글자씩 확인하고 공백, 전각 기호 또는 이전 노드 정보가 섞이지 않았는지 점검하세요. 회사 네트워크 사용자는 외부 접속 정책에서 대상 포트를 허용하는지도 확인해야 합니다.

현재 연결 정보를 우선 직접 복사
네트워크 시간 초과와 인증 거부를 구분
공개 페이지에 실제 주소를 붙여 넣지 않기

03

계정 및 인증 정보 확인

주문에 할당된 계정 정보를 사용하고 개인 키 권한은 현재 사용자만 읽을 수 있도록 제한하세요. 비밀번호, 개인 키, 서명 인증서를 일반 이메일 본문이나 공개 저장소에 넣지 마세요.

사용자 이름이 대상 노드와 일치함
개인 키 파일 권한이 SSH 요구 사항에 맞음
이전 인증 정보가 자동화 변수에서 제거됨

04

적절한 연결 방식 선택

명령줄, 코드 동기화, 자동화 작업에는 SSH를 우선 사용하세요. macOS 그래픽 인터페이스를 확인해야 할 때는 주문에서 제공한 원격 연결 방식을 사용하세요.

SSH는 스크립트, Git 및 Runner 관리에 적합
그래픽 연결은 Xcode 인터페이스 확인에 적합
두 방식 모두 문제가 있으면 먼저 네트워크 경로 비교

SSH 연결

시간 초과, 지문, 인증 오류를 분리해 처리

SSH 오류는 서로 다른 단계에서 발생합니다. 연결 시간 초과는 대개 네트워크 경로 문제이고, 호스트 지문 변경은 먼저 노드 신원을 확인해야 합니다. 인증 실패라면 사용자 이름, 키 형식, 파일 권한을 점검하세요.

연결 확인 목록 실제 인증 정보 제외

키 준비

개인 키 읽기 권한 제한

개인 키는 관리되는 디렉터리에 보관하고 프로젝트 저장소에 넣지 마세요. 권한이 너무 넓으면 SSH 클라이언트가 해당 파일 사용을 거부합니다.

chmod 600 ~/.ssh/mangovm_node
ssh -i ~/.ssh/mangovm_node -p <PORT> <USER>@<HOST>

첫 연결

호스트 지문 별도 확인

첫 연결 시 표시되는 지문을 콘솔에서 제공한 정보와 대조하세요. 확인할 수 없다면 연결을 중단하고 지원 요청을 제출하세요. 경고를 바로 무시하지 마세요.

세션 유지

장시간 작업을 로컬 터미널에서 분리

빌드, 아카이브, 의존성 설치는 Runner, launchd 또는 신뢰할 수 있는 세션 관리 도구에서 실행해야 합니다. 중요한 작업을 노트북의 단일 SSH 세션에만 걸어 두지 마세요.

Permission denied

사용자 이름, 개인 키 경로, 개인 키 권한, 키가 현재 노드에 대응하는지 차례로 확인하세요. 네트워크 연결은 되었지만 인증에 실패했다면 먼저 노드를 재시작할 필요는 없습니다.

인증 요약을 포함해 지원 요청 제출

Connection timed out

먼저 신뢰할 수 있는 다른 네트워크로 재테스트한 뒤 대상 포트, 클라이언트의 공인 네트워크 출구, 시작 및 종료 시간을 기록하세요. 시간 초과는 키 내용과 관련이 없으므로 키를 반복해서 교체해 네트워크 문제를 가리지 마세요.

진단 트리를 따라 계속 점검

CI/CD 연동

Runner는 상시 실행하되 작업을 무제한으로 병렬 실행하지 마세요

고정 물리 노드는 툴체인과 프로젝트 캐시를 유지하는 데 적합합니다. 안정성은 백그라운드 프로세스를 계속 늘리는 데서가 아니라 명확한 동시 실행 한도, 격리된 작업 디렉터리, 추적 가능한 로그, 작업 종료 후 정리에서 나옵니다.

등록

전용 Runner ID 사용

프로젝트 또는 조직마다 독립적인 Runner를 만들고 칩, 툴체인, 용도를 태그에 명확히 표시하세요. 등록 토큰은 관리되는 환경에서만 사용하고 완료 후 임시 명령과 로그에서 삭제하세요.

권장 태그: macos, arm64, m4
작업 디렉터리: 프로젝트마다 독립 경로 사용

동시 실행

먼저 단일 작업 동시 실행으로 시작

대규모 Xcode 빌드, 시뮬레이터 테스트, 아카이브는 CPU, 메모리, 디스크를 동시에 사용할 수 있습니다. 먼저 단일 작업 동시 실행을 설정하고 피크를 관찰한 뒤 실제 로그를 기준으로 단계적으로 조정하세요.

시작 전략: Runner 1개, 동시 실행 1개
확장 기준: 대기열 시간 및 리소스 피크

자료

서명 자료 보호

서명 인증서, 키, 접근 토큰은 관리되는 변수나 로컬 권한 격리를 사용하고 저장소, 빌드 산출물, 다운로드 가능한 로그에 기록하지 마세요. 작업이 끝나면 임시 파일을 정리하세요.

로그 규칙: 토큰과 민감한 경로 숨기기
종료 규칙: 임시 접근 권한 취소 및 정리

기록

재현 가능한 로그 보관

커밋 버전, Xcode 버전, SDK, 의존성 잠금 파일, 시작 시간, 종료 코드와 주요 오류를 기록하세요. 지원 요청에는 민감 정보가 제거된 관련 작업의 일부 로그만 첨부하면 됩니다.

최소 필드: 버전, 시간, 작업, 종료 코드
보관 목표: 동일한 빌드를 재현할 수 있음

macOS 운영

업그레이드 전에 툴체인을 복구할 수 있음을 먼저 확인

MangoVM 노드는 365일 연중 정상 운영됩니다. macOS와 개발 도구 업그레이드는 업무가 한산한 시간에 직접 선택해 실행하세요. 변경 전에 데이터 백업, 호환성 검증, 복구 자료 준비를 완료해야 합니다.

준비

스냅샷 방식 백업 생성

프로젝트, 의존성 잠금 파일, 빌드 설정, 주요 로그, 보관할 로컬 데이터를 같은 시점에 내보내고 백업 범위와 검증 결과를 기록하세요. 백업은 노드의 로컬 디스크와 분리해야 합니다.

검증

호환성 목록 작성

대상 macOS, Xcode, SDK, 패키지 관리자, Runner, 프로젝트 스크립트를 항목별로 확인하세요. 먼저 중요도가 낮은 작업에서 컴파일, 테스트, 아카이브, 업로드 전 검증을 완료하세요.

실행

쓰기 작업을 수행하는 작업 일시 중지

새 빌드가 대기열에 들어오지 않도록 중지하고 아카이브, 캐시 정리, 의존성 업데이트가 디스크에 쓰기 중이 아닌지 확인하세요. 업그레이드 시작 시간, 실행자, 업그레이드 전 버전을 기록하세요.

복구

먼저 실패 조건 정의

주요 프로젝트를 컴파일할 수 없거나 Runner를 등록할 수 없거나 핵심 의존성이 호환되지 않으면 추가 변경을 중단하고 로그를 보관하세요. 사전에 기록한 복구 절차에 따라 데이터와 툴체인을 복원해야 합니다.

업그레이드 전후 필수 툴체인 점검 항목
점검 대상	업그레이드 전 기록	업그레이드 후 검증	문제 발생 시 보관
Xcode 및 SDK	현재 버전, 프로젝트 대상, 명령줄 도구 경로	컴파일, 단위 테스트, 아카이브	버전 출력 및 최초 실패 로그
의존성 관리	잠금 파일, 미러 설정, 캐시 범위	새 디렉터리에서 의존성 복원	잠금 파일 및 해석 오류 일부
Runner 서비스	태그, 동시 실행, 작업 디렉터리, 시작 방식	재시작 후 자동 온라인 전환 및 작업 수신	서비스 상태 및 작업 종료 코드
프로젝트 데이터	백업 범위, 내보내기 위치, 검증 결과	샘플 읽기 및 복원 테스트	누락된 경로 및 최근 정상 버전

스토리지 및 연결

용량이 정상으로 표시되어도 작업이 올바른 경로를 사용한다는 뜻은 아닙니다

추가 스토리지 또는 Thunderbolt 5 연결에 문제가 있으면 먼저 주문의 추가 옵션을 확인한 뒤 시스템 인식, 마운트 경로, 디렉터리 권한, 작업 설정을 점검하세요. 가격과 이용 기간은 요금제 페이지의 공식 항목을 기준으로 합니다.

추가 옵션 상태

주문에 대상 추가 옵션이 포함되어 있는지, 청구 기간이 일치하는지, 콘솔에서 해당 설정을 반환했는지 확인하세요. 프로젝트 스크립트의 이전 경로만으로 판단하지 마세요.

주문 ID와 추가 옵션 이름 기록
현재 노드가 주문에 대응하는지 확인
콘솔에서 반환한 상태 요약 저장

마운트 및 권한

시스템이 대상 볼륨을 인식하고 빌드 사용자가 작업 디렉터리에 필요한 읽기 및 쓰기 권한을 갖는지 확인하세요. 개별 디렉터리 문제를 해결하기 위해 전체 디스크 권한을 과도하게 개방하지 마세요.

볼륨 이름과 실제 마운트 경로 확인
Runner가 사용하는 시스템 계정 확인
재시작 후에도 경로가 유효한지 확인

Thunderbolt 5 연결

연결된 추가 옵션, 케이블 연결, 작업 할당을 장치별로 확인하세요. 먼저 재현 가능한 단일 작업으로 읽기·쓰기 또는 노드 간 협업을 검증한 후 일괄 대기열을 재개하세요.

관련 주문 ID 기록
주 작업과 보조 작업의 관계 명확히 하기
실패 단계 및 시스템 인식 결과 보관

공식 추가 옵션을 먼저 확인한 후 문제 제출

요금제 페이지에는 +1TB SSD, +2TB SSD 및 Thunderbolt 5 연결의 일·주·월·분기 가격이 표시됩니다. 청구 문제에는 주문 ID와 선택한 기간을 함께 제공하세요.

추가 옵션 및 가격 보기

문제 진단 트리

한 번에 한 단계만 검증하고 결과를 기록

앞 단계의 확인을 건너뛰면 여러 현상이 뒤섞입니다. 아래 순서대로 실행하면서 각 단계의 시간, 결과, 변경 사항을 기록하세요. 이전 단계가 정상임을 확인한 뒤 다음 단계로 넘어가세요.

01

콘솔 상태에서 연결이 허용되는가

노드 상태, 주문 ID, 리전, 연결 정보가 모두 완전한지 확인하세요. 정보가 계속 업데이트 중이면 로컬 인증 시도를 중단하고 현재 상태를 기록하세요.

통과 조건: 상태 정상, 주소 및 접속 정보 완비.
02

로컬 네트워크에서 대상 포트에 도달할 수 있는가

다른 신뢰할 수 있는 네트워크로 재테스트해 회사 네트워크 출구, 방화벽, 프록시, 로컬 VPN으로 인한 경로 차이를 배제하세요. 테스트 네트워크와 발생 시간을 기록하세요.

통과 조건: 대상 포트에 연결되고 더 이상 시간 초과가 발생하지 않음.
03

인증 정보가 현재 노드에 대응하는가

사용자 이름, 키 경로, 파일 권한, 호스트 지문을 확인하세요. 이전 노드의 known_hosts 기록이나 자동화 변수를 새 주문에 그대로 사용하지 마세요.

통과 조건: 호스트 신원 확인 및 인증 성공.
04

시스템 서비스가 예상 상태인가

SSH, Runner, 빌드 에이전트, 프로젝트 의존성 서비스를 확인하세요. 서비스 상태, 최근 종료 코드, 마지막 설정 변경을 기록하고 기록 없이 연속 재시작하지 마세요.

통과 조건: 대상 서비스 실행 중이며 시작 방식이 명확함.
05

작업 프로세스가 리소스 또는 설정으로 차단되었는가

동시 실행 대기열, 디스크 공간, 작업 디렉터리 권한, 의존성 잠금, 작업 시간 초과를 확인하세요. 최초 실패 단계와 이후 연쇄 오류를 나누어 기록하세요.

통과 조건: 최소 작업이 재현 가능하게 실행되고 종료 코드를 설명할 수 있음.

지원 요청 경로

문제별로 필요한 최소 정보만 제출

정보가 장애 단계에 가까울수록 지원팀이 재현하기 쉽습니다. 모든 접수 경로에는 필요한 정보만 제공하고, 민감한 자료는 먼저 지원팀에 안전한 제출 방법을 확인하세요.

일반 문의

구성, 이용 기간 및 워크플로 평가

대상 작업, 동시 실행 규모, 선호 리전, 예상 이용 기간, 스토리지 요구 사항을 설명하세요. 기존 주문과 관련된 경우 주문 ID를 제공하고 로그인 인증 정보는 제출하지 마세요.

적용 범위: 제품 선택, 추가 옵션, 이용 기간, 청구 안내
준비 항목: 워크로드, 동시 실행, 리전, 주문 ID

문의 경로 확인

노드 연결 불가

콘솔 지원 요청을 우선 제출

주문 ID, 리전, 연결 방식, 발생 시간, 클라이언트 네트워크, 오류 요약, 진단 트리 5단계의 점검 결과를 제공하세요. 단순히 '연결할 수 없음'이라고만 쓰지 마세요.

적용 범위: 시간 초과, 인증 문제, 서비스 오프라인
준비 항목: 시간 범위, 재현 단계, 민감 정보가 제거된 로그

노드 연결 불가 지원 요청 제출

데이터 보안 사고

먼저 영향을 통제한 후 범위 보고

의심스러운 작업을 중지하고 노출되었을 수 있는 임시 접근 권한을 취소한 뒤 로그와 타임라인을 보관하세요. 주문 ID, 발견 경로, 영향 범위, 조치 내용을 제출하고 계속 사용할 수 있는 키는 보내지 마세요.

적용 범위: 비정상 접근, 민감 자료 노출, 의심스러운 프로세스
준비 항목: 타임라인, 영향 설명, 격리 조치

데이터 보호 원칙 보기

주문 ID와 시간 범위를 준비한 후 처리를 시작하세요.

새 노드가 필요하면 바로 주문 절차로 이동하세요. 기존 주문에 문제가 있으면 재현 단계와 민감 정보가 제거된 로그를 포함해 콘솔에서 지원 요청을 제출하세요.

클라우드 Mac 지금 대여하기 콘솔에서 지원 요청 제출