연결·빌드·문제 해결

클라우드 Mac을 최초 연결부터 안정적으로 운영하는 다음 단계를 안내합니다

먼저 접속 경로와 보안 경계를 확인한 뒤 Xcode, Runner, MLX 또는 미디어 워크플로를 설정하세요. 문제가 발생하면 네트워크, 인증, 디스크, 도구 체인, 프로세스 리소스와 리전 경로를 순서대로 점검해 여러 변수를 동시에 변경하지 마세요.

표준 제공 절차는 약 4분입니다. 노드와 주문의 실제 사용 가능 여부는 콘솔의 실시간 상태를 기준으로 합니다.

지원 / 런북 작업 제공 및 문제 해결 등록판
실행 단계
01

최초 연결

노드, 출발지 주소와 접속 방식을 확인하고 개인 세션을 먼저 완료한 뒤 팀원에게 인계하세요.

출력: 연결 기준선
02

빌드 실행

도구 버전, 캐시 디렉터리와 동시 실행 한도를 고정해 Xcode 또는 Runner 작업을 반복 실행할 수 있게 하세요.

출력: 재현 가능한 작업
03

문제 원인 파악

시간 범위, 오류 원문, 리소스 지표와 재현 절차를 보존한 뒤 콘솔에서 문의를 제출하세요.

출력: 진단 기록
전용 Apple Silicon 물리 노드 가상 머신 아님 연중 365일 운영
권장 읽기 순서

빠른 시작 목차

다섯 단계가 의존 관계에 따라 정렬되어 있습니다. 앞 단계의 기록은 다음 단계의 입력이 되므로, 팀 환경에서는 키 교체와 접속 철회를 건너뛰지 마세요.

  1. 01

    주문 완료

    기종, 대여 기간, 노드와 스토리지 추가 옵션을 선택하고 결제 후 콘솔에서 주문 상태를 확인하세요. 오래된 스크린샷으로 현재 사용 가능 여부를 판단하지 마세요.

  2. 02

    접속 자격 증명 수신

    콘솔에서 인스턴스, 노드와 접속 안내를 확인하세요. 자격 증명은 관리되는 비밀번호 도구에만 저장하고 단체 채팅이나 코드 저장소에 전달하지 마세요.

  3. 03

    최초 로그인 완료

    신뢰할 수 있는 네트워크에서 원격 데스크톱 또는 SSH 세션을 열고 최초 연결 시간, 클라이언트 버전과 공인 출발지 주소를 기록해 비교 가능한 연결 기준선을 만드세요.

  4. 04

    키 교체

    팀 전용 SSH 키와 최소 권한 계정을 만들고 새 경로가 작동하는지 확인한 뒤 임시 접속 자료를 철회하세요. 먼저 삭제한 후 확인하면 잠길 수 있습니다.

  5. 05

    팀 인계 완료

    작업, 브랜치, 캐시 상태, 실행 프로세스와 출력 위치를 인계하되 개인 자격 증명은 넘기지 마세요. 다음 작업자와 대여 기간 종료 전 데이터 반출 책임을 명확히 하세요.

연결 전 준비

네 가지 연결 경로별 최소 점검 목록

연결에 문제가 생기면 먼저 어떤 경로를 사용하는지 확인하세요. 원격 데스크톱, SSH, 파일 전송과 방화벽 허용 목록은 점검 항목이 다르므로 한 번에 섞어 점검하지 마세요.

그래픽 세션

보안 원격 데스크톱

암호화 연결을 지원하는 클라이언트를 준비하고 신뢰할 수 있는 단일 네트워크에서 먼저 테스트하세요. 클라이언트 버전, 화면 해상도, 키보드 레이아웃과 프록시 네트워크 사용 여부를 기록하세요.

  • 최초 연결은 단일 모니터와 기본 해상도로 진행
  • 클립보드와 파일 매핑이 팀 정책에 맞는지 확인
  • 입력 지연이 비정상적이면 연속 테스트 구간을 보존
Xcode, Final Cut Pro 및 그래픽 관리에 적합
명령줄

SSH

각 작업자에게 독립 키를 배정하고 최초 연결 전에 인스턴스 정보를 확인하세요. 자동화 작업에는 전용 계정을 사용하고 개인 대화형 세션을 재사용하지 마세요.

  • 개인 키는 관리되는 장치에 보관하고 파일 권한을 제한
  • 팀원별 승인된 공개 키를 별도로 관리
  • 연결 실패 시 상세 모드 출력을 보존하되 민감한 내용은 제거
자동화, 로그 점검과 원격 명령에 적합
데이터 채널

파일 전송

대용량 파일에는 재개 가능한 도구를 우선 사용하고 입력, 중간 파일과 출력물을 별도 디렉터리로 나누세요. 작은 샘플로 권한과 디스크 공간을 확인한 뒤 전체 동기화를 시작하세요.

  • 전후 파일 수와 체크섬을 확인
  • 모델, 소재와 빌드 캐시를 별도 디렉터리에 저장
  • 실행 중인 캐시 디렉터리의 파일을 직접 덮어쓰지 않기
모델, 소재, 빌드 산출물과 로그 반송에 적합
접근 경계

방화벽 허용 목록

확인된 공인 출발지 주소와 필요한 포트만 허용하세요. 가정이나 이동 네트워크 주소가 바뀌면 통제되지 않은 대역으로 확대하지 말고 규칙을 업데이트하세요.

  • 사무실 네트워크, Runner와 운영 출구를 각각 기록
  • 임시 출발지에 명확한 철회 시간 설정
  • 변경 후 허용 출발지와 비허용 출발지에서 각각 테스트
고정 사무실 출구와 통제된 자동화 네트워크에 적합
지속적 통합

GitHub Actions 셀프 호스팅 Mac Runner를 회수 가능한 작업으로 운영하세요

Runner의 안정성은 버전 고정, 동시 실행 경계, 캐시 소유권과 작업 후 정리에 달려 있습니다. 이전 작업의 상태가 다음 작업의 숨은 의존성이 되지 않게 하세요.

등록 및 라벨

라벨에는 검증 가능한 기능만 표시

라벨에는 칩 아키텍처, Xcode 주 버전, 용도와 큐 경계를 포함하는 것이 좋습니다. 임시 프로젝트명을 장기 기능 라벨로 사용하면 프로젝트 변경에 따라 스케줄링 규칙이 왜곡됩니다.

등록 방식
조직 또는 저장소 전용
실행 계정
독립 최소 권한 계정
검증 작업
민감 정보가 없는 테스트 작업 1회 실행
동시 실행 및 캐시

동시 실행을 먼저 제한하고 리소스 피크를 관찰

단일 작업 기준선에서 시작해 CPU, 통합 메모리, 디스크 쓰기와 빌드 시간을 각각 기록하세요. 작업이 서로 독립적이고 피크에 여유가 있을 때만 동시 실행을 늘리세요.

의존성 캐시
잠금 파일과 도구 버전별로 키 분리
파생 데이터
프로젝트별 격리 및 정리 한도 설정
동시 실행 판단
피크 리소스와 큐 대기 시간을 함께 기준으로 결정
격리 및 정리

서명 자료는 공용 캐시에 저장하지 않기

민감한 자료는 필요한 작업 단계에만 주입하고 작업 완료 후 임시 파일, 환경 변수와 백그라운드 프로세스를 철회하세요. 실패 경로와 성공 경로에 같은 정리 절차를 적용해야 합니다.

민감한 자료
독립 권한 및 독립 수명 주기
실패 재시도
잔여물을 먼저 정리한 뒤 다시 큐에 등록
대여 기간 종료
Runner, 키와 접근 규칙 철회
개발 환경

도구 버전, 설치 출처와 캐시 디렉터리를 모두 추적 가능하게 관리

현재 상태를 먼저 기록한 뒤 업그레이드하세요. 지속적 빌드 호스트에서는 최신 버전을 따르는 것보다 버전 안정성과 재현성이 중요한 경우가 많습니다.

클라우드 Mac 개발 환경 유지 관리 목록
도구 최초 설정 일상 유지 관리 문제 발생 시 우선 확인
Xcode 주 버전을 고정하고 명령줄 도구 선택과 최초 실행 상태를 기록하세요. 업그레이드 전에 프로젝트 호환성 결과를 보존하고 DerivedData를 프로젝트별로 격리하세요. 현재 선택 경로, SDK, 시뮬레이터 상태, 디스크 여유 공간과 전체 빌드 로그.
Homebrew 관리되는 단일 계정으로 설치하고 의존성 목록과 필요한 버전 제약을 저장하세요. 업데이트 전에 변경 내용을 확인하고 빌드 작업 중간에 의존성을 업그레이드하지 마세요. 경로 우선순위, 디렉터리 소유권, 아키텍처 일치와 formula 버전.
Ruby 프로젝트가 선언한 버전을 사용하고 Bundler와 의존성 파일을 고정하세요. 재사용 가능한 의존성은 캐시하되 호환되지 않는 Ruby 버전 간에 섞어 사용하지 마세요. 인터프리터 경로, Gem 설치 디렉터리, 잠금 파일과 네이티브 확장 빌드 출력.
Node.js 프로젝트별 런타임과 패키지 관리자 버전을 고정하고 잠금 파일 검사를 활성화하세요. 불투명한 작업 디렉터리가 아닌 다운로드 콘텐츠를 캐시하고 오래된 캐시를 정기적으로 정리하세요. Node 경로, 패키지 관리자 버전, 잠금 파일 차이와 네이티브 모듈 아키텍처.
컨테이너 대체 절차 Linux 컨테이너 단계는 외부 Linux 실행 환경에서 처리하고 Mac 노드는 macOS 전용 빌드와 테스트를 담당하게 하세요. 스크립트로 입력과 산출물 형식을 통일해 플랫폼 간 수동 이동을 줄이세요. 플랫폼 가정, 파일 권한, 줄바꿈 형식, 아키텍처와 산출물 전달 경로.
빌드 캐시 프로젝트, 브랜치 정책, 도구 버전과 잠금 파일별로 캐시 키를 만드세요. 용량 임계값과 정리 순서를 설정하고 재생성 가능한 캐시부터 삭제한 뒤 작업 파일을 처리하세요. 적중률, 디렉터리 권한, 잔여 공간, 파일 수와 동시 쓰기.
고메모리 및 대용량 파일 작업

MLX 추론과 미디어 제작에서 메모리·디스크·반송 경로를 함께 관리하세요

두 작업 유형 모두 통합 메모리를 장시간 사용하고 큰 출력물을 만들 수 있습니다. 시작 전에 입력 파일, 임시 디렉터리, 완료 조건과 반송 방식을 정하세요.

MLX 추론

모델 저장 후 소규모 배치로 기준선 측정

모델 파일, 양자화 버전, 입력 샘플과 결과를 식별 가능한 디렉터리에 각각 저장하세요. 소규모 배치를 먼저 실행해 로딩 시간, 통합 메모리 피크, 단일 추론 시간과 출력 크기를 기록한 뒤 배치 크기와 동시 실행을 결정하세요.

  1. 파일 준비:모델 파일 무결성을 확인하고 모델·캐시·출력에 필요한 전체 공간을 확보합니다.
  2. 리소스 관찰:메모리 압박, 스왑 활동, 디스크 읽기·쓰기와 프로세스 지속 시간을 함께 확인합니다.
  3. 장시간 작업 유지:재개 가능한 작업 관리 방식을 사용하고 단계별 진행률과 중간 결과를 출력합니다.
  4. 결과 반송:먼저 목록과 체크섬을 생성한 뒤 결과를 전송해 파일명만으로 완료 여부를 판단하지 않습니다.
64GB 고메모리 작업에는 VPSGit M4 Pro를 검토할 수 있습니다: M4 Pro, 64GB, 2TB.
미디어 제작

프록시 소재, 프로젝트 파일과 완성본을 분리해 동기화

원격으로 Final Cut Pro를 사용할 때는 먼저 짧은 프록시 소재로 입력 지연, 미리보기의 원활함과 음성·영상 동기화를 확인하세요. 전체 소재를 업로드하기 전에 디스크 여유 공간과 반송 시간 예산을 확인하세요.

  1. 소재 동기화:원본 소재, 프록시 파일과 프로젝트 파일을 별도 디렉터리에 두어 사용 중인 미디어를 덮어쓰지 않습니다.
  2. 편집 기준선:원격 데스크톱 해상도, 네트워크 경로와 재생 품질을 기록해 변화를 비교합니다.
  3. 내보내기 관리:내보내기 전에 목표 형식, 임시 공간과 명명 규칙을 확인하고 장시간 내보내기의 단계별 로그를 보존합니다.
  4. 완성본 반송:먼저 샘플을 전송해 확인한 뒤 최종 파일과 검증 정보를 보내고 완료 후 재생성 가능한 파일을 정리합니다.
대용량 소재에는 +1TB SSD 또는 +2TB SSD를 선택할 수 있으며 작업 전에 반출 시간을 확인하세요.
단계별 문제 해결

한 번에 한 계층만 검증하고 각 단계의 결과를 보존

먼저 문제가 로컬, 연결 경로 또는 노드 내부에서 발생했는지 판단하세요. 각 단계를 완료할 때마다 현상 변화를 기록하고 같은 라운드에서 도구 업그레이드, 네트워크 변경과 캐시 삭제를 동시에 하지 마세요.

  1. 01

    네트워크

    같은 출발지에서 기본 연결, 패킷 손실과 지터를 테스트한 뒤 이미 안정적인 다른 네트워크에서 재검사하세요. 클라이언트 네트워크 유형, 프록시 경유 여부와 문제가 발생한 시간 범위를 기록하세요.

  2. 02

    인증

    현재 승인된 계정과 키를 사용하는지 확인하고 로컬 파일 권한, 승인 범위와 최근 교체 기록을 점검하세요. 자격 증명 내용은 문의에 작성하지 마세요.

  3. 03

    디스크

    잔여 용량, 디렉터리 소유권, 파일 수와 대형 디렉터리 증가 원인을 확인하세요. 빌드 실패 시 임시, 캐시와 출력 디렉터리도 함께 점검하세요.

  4. 04

    빌드 도구 체인

    Xcode, SDK, Ruby, Node.js, 패키지 관리자와 의존성 잠금 파일 버전을 기록하고 마지막 성공 작업과 비교하세요. 먼저 전체 업그레이드를 실행하지 마세요.

  5. 05

    프로세스 리소스

    CPU, 통합 메모리, 스왑 활동, 디스크 쓰기와 남은 하위 프로세스를 관찰하세요. 단일 피크, 지속 점유와 작업 종료 후 미해제를 구분하세요.

  6. 06

    리전 경로

    같은 클라이언트와 작업을 비슷한 시간대에 비교해 경로를 확인하고 서로 다른 작업 부하를 리전 차이로 오해하지 마세요. 리전 간 이전 시 디렉터리를 다시 확인하고 데이터 이동을 예약하세요.

문의 제출 전

재현 가능한 정보를 한 장의 진단표로 정리

문의는 영향 범위와 주문 상태에 따라 처리됩니다. 정보가 완전하면 반복 확인을 줄일 수 있지만 키, 접속 비밀번호, 서명 자료와 업무 데이터는 제거하세요.

  • 주문 번호, 선택한 노드와 기종
  • 문제 시작 시간과 지속 범위
  • 영향받은 연결 방식 또는 작업 단계
  • 재현 가능한 최소 작업 절차
  • 전체 오류 원문과 필요한 로그 일부
  • 완료한 점검과 각 단계의 결과
서비스 가동률 기준
99.9%서비스 가동률 목표

모든 노드는 연중 365일 정상 운영되며 고정 중단 시간을 두지 않습니다. 가동률은 서비스 약관에서 정한 범위로 계산하며 사용자 작업, 제3자 의존성과 통제할 수 없는 사건은 약관에 따라 구분합니다.

최근 90일 상태 기록

연속된 30일 구간 3개로 표시하며, 구체적인 이벤트 기록과 최신 상태는 콘솔을 기준으로 합니다.

상태 지속 기록
최근 30일현재 구간
이벤트 확인 후 기록 업데이트
31~60일 전이전 구간
서비스 이벤트 기준으로 보관
61~90일 전이전 구간
이벤트 영향 범위 기록 보존
서비스 크레딧

서비스 약관의 조건을 충족하면 영향을 받은 기간에 대해 서비스 크레딧을 신청할 수 있습니다. 신청 시 주문, 영향 시간대와 확인 가능한 현상을 제공해야 하며 구체적인 인정 여부와 크레딧은 서비스 약관을 따릅니다.

안전한 운영

노드 접속부터 대여 종료까지 책임자를 명확히 지정

보안은 한 번 설정하고 끝나는 일이 아닙니다. 계정, 권한, 키, 민감 자료, 백업과 철회에 각각 점검 지점을 만들고 팀 인계 시 항목별로 확인하세요.

01

독립 계정

각 작업자는 식별 가능한 계정을 사용하고 개인 세션을 공유하지 마세요. 자동화 Runner에는 수동 작업과 분리된 서비스 계정을 사용하세요.

점검: 담당자와 계정이 일대일로 대응
02

최소 권한

현재 작업에 필요한 디렉터리, 명령과 네트워크 접근만 부여하세요. 임시 권한에는 용도와 철회 시간을 명시해야 합니다.

점검: 용도 없는 장기 고권한 없음
03

키 교체

구성원 변경, 장치 분실 또는 권한 경계 조정 후 즉시 교체하세요. 새 키를 먼저 검증한 뒤 기존 키를 철회하고 결과를 기록하세요.

점검: 승인 목록과 실제 설정이 일치
04

민감 자료 정리

서명 파일, 임시 토큰, 환경 변수와 로그의 민감한 부분은 작업 수명 주기에 따라 정리하고 공용 캐시에 저장하지 마세요.

점검: 성공·실패 경로 모두 정리 실행
05

종료 전 백업

대여 기간 종료 전에 소스 변경 사항, 빌드 산출물, 모델 결과, 미디어 프로젝트와 필요한 로그를 반출하고 백업을 읽을 수 있는지 확인하세요.

점검: 백업 위치와 검증 결과 기록 완료
06

접근 철회

작업 완료 후 계정, 공개 키, Runner 등록, 허용 목록과 임시 공유 경로를 철회하고 백그라운드 프로세스가 중지되었는지 확인하세요.

점검: 노드 외부 진입점 모두 회수
시작 준비

기종과 노드를 선택한 뒤 이 런북에 따라 제공 절차를 완료하세요

세 가지 전용 Apple Silicon 물리 노드는 일·주·월·분기 단위로 대여할 수 있습니다. USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)를 지원하며 USD로 결제합니다.