작업별 지원 매뉴얼

최초 연결부터 빌드 문제 해결까지, 다음 단계를 작업별로 확인하세요

DebugMac은 가상 머신이 아닌 전용 Apple Silicon 물리 노드를 제공합니다. 이 페이지에서는 먼저 자격 증명, 지역과 도구 체인을 확인한 뒤 명령 출력으로 연결, 빌드, 스토리지와 네트워크 문제를 진단합니다.

클라우드 Mac 지금 대여 최초 시작 절차 보기
제공 대상
Debug M4 전용 물리 노드
연결 방식
SSH 및 macOS 그래픽 인터페이스
지원 창구
콘솔 문의와 지원 이메일
BREAKPOINT REVIEW DESK 진단 작업지
항목별 확인
CASE / BUILD-042 재현 대기

입력을 먼저 고정한 뒤 실행 환경을 확인하세요

노드
JP · Debug M4
작업
Xcode Archive
접근 방식
SSH 공개 키
증거
명령, 시간, 비식별화 로그
문제 해결 경로
  1. 01호스트 지문 확인연결 대상이 바뀌지 않았는지 확인
  2. 02도구 체인 버전 기록Xcode와 의존성 입력을 고정
  3. 03문제 범위 좁히기로컬, 경로, 노드 세션 구분
입력주문 및 지역 실행재현 및 샘플링 결과물확인 가능한 문의
지원 색인

6개 작업을 동시에 펼쳐 핵심 단계를 필터에 숨기지 않습니다

분류를 선택하면 해당 섹션으로 이동해 강조 표시하고, 나머지 가이드도 계속 보여 주므로 작업 간 전후 조건을 함께 확인할 수 있습니다.

최초 연결

자격 증명과 호스트 지문 확인

주소, 사용자 이름과 SSH 공개 키를 준비하고 지문을 확인한 뒤 명령줄 및 그래픽 세션을 연결합니다.

일상 빌드

Xcode와 아카이브 입력 고정

저장소 상태, 도구 체인, 서명 확인부터 아카이브 내보내기까지 재현 가능한 결과를 만드는 버전 정보를 보존합니다.

CI 자동화

추적 가능하고 정리 가능한 runner 만들기

동시 실행을 제한하고 캐시와 임시 디렉터리를 명시적으로 관리하며 핵심 빌드 출력을 파이프라인으로 반환합니다.

스토리지 확장

용량, 마운트와 병렬 장치 확인

활성화 전에 추가 옵션을 확인하고, 제공 후 디스크 용량, 마운트 지점, 파일 시스템과 읽기·쓰기 대상을 점검합니다.

네트워크 진단

로컬, 경로와 세션을 나누어 확인

지연 시간, 경로, 포트와 전송 테스트로 범위를 단계별로 좁히고 한 번의 ping만으로 결론 내리지 마세요.

계정 관리

실행 가능한 문의로 정리

주문 ID, 지역, 발생 시간, 재현 단계와 비식별화 로그를 첨부해 반복 확인을 줄입니다.

SSH 및 그래픽 세션

최초 연결에서 대상을 확인하고 신뢰 기준선을 저장하세요

제공 확인서의 주소, 사용자 이름, 호스트 지문과 접근 발급 상태는 같은 주문에 속해야 합니다. 어느 필드라도 일치하지 않으면 연결을 중지하고 콘솔 문의로 확인하세요.

연결 전 준비

로컬 SSH 개인 키, 공개 키 대응 관계, 제공 확인서와 안정적인 네트워크를 준비하세요. 개인 키, 전체 자격 증명 또는 비식별화되지 않은 설정을 문의에 붙여 넣지 마세요.

  • 로컬 개인 키 권한이 현재 사용자만 읽을 수 있도록 제한되어 있는지 확인하세요.
  • 주문 지역이 싱가포르, 일본(도쿄), 한국(서울), 홍콩 또는 미국 서부 중 하나인지 확인하세요.
  • 최초 연결 전에 확인서의 호스트 지문을 별도로 확인하세요.
  • 최초 성공 연결 시간, 시스템 버전과 기본 디스크 용량을 기록하세요.
전체 시작 절차 보기
  1. 01 자격 증명 준비

    제공 확인서에서 호스트 주소, 사용자 이름과 지문을 확인하세요. 개인 키는 로컬의 관리되는 경로에 보관하고 채팅이나 문의로 전송하지 마세요.

  2. 02 지문 확인

    최초 SSH 연결에 표시되는 지문은 확인서와 일치해야 합니다. 이미 연결한 뒤 지문이 갑자기 바뀌었다면 로컬 기록을 바로 삭제하고 다시 시도하지 마세요.

  3. 03 키 로그인 테스트

    먼저 읽기 전용 명령을 실행해 사용자, Apple Silicon 아키텍처, 시스템 시간과 사용 가능한 디스크를 확인한 뒤 저장소나 빌드 디렉터리로 이동하세요.

  4. 04 그래픽 세션 시작

    그래픽 세션 자격 증명, 화면 해상도와 키보드 레이아웃을 확인하세요. 최초 진입 후 안전하게 연결을 끊었다가 다시 연결하는 테스트를 한 번 진행하세요.

  5. 05 연결 끊김 처리

    먼저 로컬 네트워크 중단, SSH 포트 연결 불가와 그래픽 세션 중단을 구분하세요. 명령줄을 계속 사용할 수 있다면 로그와 작업 상태를 우선 저장하세요.

연결에 실패하면 먼저 세 가지 증거를 보존하세요

로컬 시간, 전체 오류 문구와 같은 네트워크에서 실행한 포트 확인 결과를 기록하세요. 자격 증명을 연속으로 초기화하지 마세요. 문제 발생 당시 상태가 덮어써질 수 있습니다.

Xcode 워크플로

저장소, 도구 체인과 아카이브 매개변수를 함께 고정하세요

같은 커밋도 Xcode, 의존성 잠금 파일 또는 서명 입력이 다르면 결과가 달라질 수 있습니다. 문제를 해결할 때는 먼저 입력을 고정하고 여러 의존성을 동시에 업그레이드하지 마세요.

01

저장소 가져오기

커밋 해시, 브랜치, 서브모듈 상태와 의존성 잠금 파일을 기록하세요. 기준선 빌드 전에 작업 공간에 커밋되지 않은 변경 사항이 없는지 확인하세요.

02

도구 체인 선택

다음 명령으로 xcode-select -p 및 xcodebuild -version 현재 개발자 디렉터리와 Xcode 버전을 기록하세요.

03

서명 입력 확인

프로젝트의 팀, Bundle ID, 구성 이름과 서명 모드를 확인하세요. 로그에 인증서 세부 정보가 포함되면 먼저 비식별화하세요.

04

아카이브 실행

workspace 또는 project, scheme, configuration과 archivePath를 명시하고 전체 종료 코드와 로그를 저장하세요.

05

결과물 다운로드

아카이브가 완료되면 파일 크기, 체크섬과 내보내기 디렉터리를 확인한 뒤 팀에서 정한 안전한 위치로 결과물을 복사하세요.

빌드 기준선 명령 민감한 값은 예시 이름 사용 
git rev-parse HEAD
xcode-select -p
xcodebuild -version
xcodebuild -workspace "<WORKSPACE>" \
  -scheme "<SCHEME>" \
  -configuration Release \
  -archivePath "<OUTPUT>/App.xcarchive" \
  archive | tee "<LOG_DIR>/archive.log"

성공 확인

종료 코드가 0이고 아카이브 디렉터리가 존재하며 결과물 크기가 예상과 일치하고 로그에 누락된 서명 또는 스크립트 오류가 없어야 합니다.

실패 분류

의존성 확인, 컴파일, 링크, 서명, 스크립트 단계와 내보내기 중 어디서 실패했는지 순서대로 판단하세요. 모든 문제를 ‘Xcode 빌드 실패’로 뭉뚱그리지 마세요.

증거 제출

커밋 해시, Xcode 버전, 실행 명령, 종료 코드, 실패 단계와 비식별화 로그 일부를 제공하세요. 개인 키나 전체 자격 증명은 업로드하지 마세요.

CI/CD 자동화

self-hosted runner의 모든 실행에 경계를 설정하세요

GitHub와 GitLab 등의 파이프라인은 macOS 작업을 전용 노드로 라우팅할 수 있습니다. 노드의 실행 환경은 다른 테넌트와 공유되지 않지만 같은 팀의 작업에서도 동시 실행, 캐시와 정리를 관리해야 합니다.

동시 실행

단일 작업 기준선부터 시작

먼저 하나의 파이프라인이 끝까지 성공하는지 확인한 뒤 동시 실행을 점진적으로 늘리세요. 여러 빌드가 같은 DerivedData, 키체인 또는 출력 디렉터리에 동시에 쓰면 서로 오염될 수 있습니다.

  • 각 작업에 독립된 작업 디렉터리를 사용하세요.
  • 시뮬레이터와 아카이브 경로에 작업 ID를 포함하세요.
  • CPU, 메모리, 디스크 최고 사용량과 대기 시간을 기록하세요.
캐시

캐시에는 검증 가능한 키가 필요합니다

의존성 캐시 키에는 최소한 잠금 파일 요약, 도구 체인 버전과 아키텍처를 포함하세요. 캐시가 적중한 뒤에도 의존성 무결성을 확인하고 이전 캐시를 올바른 결과로 간주하지 마세요.

  • 의존성 캐시와 빌드 중간 결과물을 분리해 관리하세요.
  • 도구 체인을 변경한 뒤 새 캐시 키를 직접 생성하세요.
  • 적중, 폴백과 재빌드에 걸린 시간을 기록하세요.
정리

작업이 끝나면 임시 상태를 회수하세요

성공 여부와 관계없이 정리 단계를 실행하세요. 반환해야 할 로그와 결과물은 보존하고 임시 키, 작업 디렉터리와 더 이상 사용하지 않는 시뮬레이터 상태는 삭제하세요.

  • 정리 단계에는 finally 또는 동등한 메커니즘을 사용하세요.
  • 실패 로그를 먼저 보관한 뒤 작업 디렉터리를 삭제하세요.
  • 디스크 사용량과 오래된 캐시를 정기적으로 확인하세요.
  1. 01 실행기 등록

    팀이 관리하는 단기 등록 정보로 runner를 연결하세요. 태그에는 Apple Silicon, 지역과 예상 워크플로를 명확히 표시해야 합니다.

  2. 02 기준선 작업 생성

    환경 확인과 최소 빌드만 실행해 저장소 권한, Xcode 경로, 의존성 다운로드와 결과물 반환이 모두 정상인지 확인하세요.

  3. 03 캐시 추가

    먼저 캐시 없이 걸리는 시간을 측정한 뒤 잠금 파일과 도구 체인에 따라 캐시 키를 만드세요. 그래야 캐시가 실제로 유효한지 판단할 수 있습니다.

  4. 04 정리 검증

    일부러 한 번 실패시켜 로그가 계속 반환되고 임시 정보가 폐기되며 후속 작업이 이전 상태를 물려받지 않는지 확인하세요.

스토리지 및 Thunderbolt 5

추가 옵션은 주문에서 먼저 확인하고 제공 후 용량과 경로를 검증하세요

기본 구성은 Debug M4: M4, 16GB RAM, 256GB SSD입니다. +1TB SSD, +2TB SSD와 Thunderbolt 5 병렬 연결은 각각 별도의 추가 옵션이며 시스템 표시만으로 주문 내용을 추정할 수 없습니다.

추가 스토리지

+1TB SSD

주문별 요금
일일$2.3
주간$6.1
월간$11.3
분기$30.7

활성화 전에 대상 워크플로, 예상 최고 사용량과 데이터 이전 방식을 확인하세요. 제공 후에는 총 용량, 볼륨 이름, 파일 시스템과 마운트 경로를 점검하세요.

추가 스토리지

+2TB SSD

주문별 요금
일일$4.6
주간$12.2
월간$22.6
분기$61.4

아카이브, 미디어 파일 또는 모델 파일을 많이 보관해야 하는 작업에 적합합니다. 용량 확인은 시스템 디스크 정보와 실제 마운트 결과를 기준으로 해야 합니다.

대당 요금

Thunderbolt 5 병렬 연결

대당 별도 계산
일일$1.7
주간$4.6
월간$8.5
분기$23.1

제출 전에 병렬 연결 대수, 작업 배정 방식과 결과물 집계 위치를 명확히 하세요. 이 옵션은 대당 요금이므로 한 대의 가격으로 전체 주문을 계산할 수 없습니다.

  1. 01 주문 확인

    추가 옵션 이름, 수량, 대여 기간과 USD 금액을 확인하세요. 실제 사용 가능 상태와 결제 게이트웨이는 콘솔의 실시간 응답을 기준으로 합니다.

  2. 02 시스템 확인

    다음 명령으로 diskutil list 및 df -h 디스크, 볼륨과 사용 가능한 공간을 기록하세요. 데스크톱 아이콘만 확인하지 마세요.

  3. 03 읽기·쓰기 검증

    대상 작업 디렉터리에서 소규모 읽기·쓰기 테스트를 실행해 권한, 경로와 실제 결과물 위치를 확인하세요. 한 번의 극단적 테스트로 장기 성능을 판단하지 마세요.

  4. 04 매핑 기록

    여러 디스크 또는 여러 컴퓨터로 협업할 때 ‘작업—볼륨—결과물 디렉터리’ 대응 관계를 기록하세요. 정리 작업으로 보존해야 할 데이터가 삭제되는 일을 막을 수 있습니다.

네트워크 진단 매뉴얼

네 가지 테스트로 로컬 네트워크, 지역 간 경로와 노드 세션을 구분하세요

한 번의 지연 측정이나 연결 끊김만으로 문제 위치를 판단할 수 없습니다. 같은 네트워크와 비슷한 시간대에 반복 측정하고 명령, 대상, 시간과 원본 출력을 보존하세요.

네트워크 진단 명령, 관찰 항목과 판단 기준
테스트 예시 명령 중점 관찰 구분에 도움이 되는 문제
기본 지연 ping -c 20 <HOST> 패킷 손실, 변동, 연속 타임아웃 위치 로컬 접속 이상과 지속적인 경로 이상
경로 추적 traceroute <HOST> 경로 변화, 이상 홉, 타임아웃 지속 여부 로컬 출구, 지역 간 경로와 대상 인근 경로
포트 확인 nc -vz <HOST> 22 연결 성공, 거부 또는 타임아웃 호스트에는 도달하지만 SSH 포트에는 도달하지 못하는 상황
전송 테스트 scp <FILE> <USER>@<HOST>:<PATH> 지속 속도, 재시도, 파일 체크섬 대화형 지연과 대용량 파일 전송 문제
세션 확인 ssh -vv <USER>@<HOST> 이름 확인, 핸드셰이크, 키 선택, 인증 단계 네트워크, 지문, 키와 사용자 설정 문제

로컬 네트워크 문제

같은 장치에서 여러 대상에 모두 문제가 발생하고 관리되는 네트워크로 전환하면 복구되거나 로컬 출구의 초기 홉부터 지속적인 패킷 손실이 나타나는 경우입니다. 제출할 때 네트워크 유형과 재측정 결과를 설명하세요.

지역 간 경로 문제

로컬 접속은 정상이지만 특정 경로에서 지속적인 변동이 나타나는 경우입니다. 여러 차례 경로 추적 결과를 제공하고 중간 홉이 응답하지 않는다고 실제 패킷 손실로 단정하지 마세요.

노드 세션 문제

호스트와 포트에는 도달하지만 인증, Shell 또는 그래픽 세션이 실패하는 경우입니다. 이때는 SSH 상세 출력, 세션 오류와 최근 작업을 우선 보존하세요.

테스트 기준

네트워크 결과는 로컬 통신사, 접속 방식, 지역 간 경로와 측정 시간대의 영향을 받습니다. 이는 문제 범위를 파악하기 위한 자료일 뿐 성능을 보장하지 않습니다. 모든 노드는 365일 연중 정상 운영되며 가용성은 실제 서비스 기록으로 확인합니다.

문의 준비 목록

지원 요청을 재현 가능한 인계 자료로 정리하세요

사용 중인 노드 문제는 우선 콘솔에서 문의를 제출하세요. 구매 전 문의나 로그인할 수 없는 경우 support@debugmac.com으로 이메일을 보내면 됩니다. 두 채널 모두 같은 정보 목록을 사용합니다.

  1. 01 주문 ID

    콘솔에 표시된 주문 ID와 모델 Debug M4를 제공하세요. 결제 정보, 개인 키 또는 전체 접근 비밀번호는 보내지 마세요.

  2. 02 노드 지역

    싱가포르, 일본(도쿄), 한국(서울), 홍콩 또는 미국 서부를 명시하고 문제가 해당 지역에서만 발생하는지 설명하세요.

  3. 03 발생 시간

    시간대가 포함된 최초 발생 시간, 최근 재현 시간과 지속 시간을 제공하세요. ‘방금’이나 ‘가끔’처럼만 쓰지 마세요.

  4. 04 재현 단계

    입력, 실행 명령, 예상 결과와 실제 결과 순서로 작성하세요. 안정적으로 재현할 수 없다면 발생 빈도와 관찰된 공통 조건을 설명하세요.

  5. 05 비식별화 로그

    타임스탬프, 종료 코드와 오류 맥락은 보존하고 키, 토큰, 비밀번호, 내부 저장소 주소와 기타 민감한 값은 제거하세요.

  6. 06 수행한 점검

    실행한 명령, 재시도 횟수, 네트워크 전환과 결과를 나열해 지원 담당자가 같은 기본 점검을 반복 요청하지 않도록 하세요.

사용 중인 노드 및 계정

콘솔에 로그인해 문의 제출

문의는 주문, 노드와 과거 처리 기록에 연결할 수 있어 연결, 빌드, 스토리지, 청구와 계정 접근 문제에 적합합니다.

콘솔로 이동
구매 전 문의 또는 로그인 불가

구조화된 지원 이메일 보내기

제목에 작업 유형과 노드 지역을 적고 본문은 이 페이지의 목록 순서에 맞춰 작성하세요. 외부 지원 이메일은 support@debugmac.com 하나뿐입니다.

지원 이메일 보내기
시작 준비

구성을 확인할 수 있는 클라우드 Mac이 필요하신가요?

Debug M4, 대여 기간과 5개 지역 노드를 선택하고 제출 전에 기본 구성, 추가 옵션, 지역과 USD 결제 금액을 다시 확인하세요. 실제 사용 가능 상태는 콘솔의 실시간 응답을 기준으로 합니다.

클라우드 Mac 지금 대여 구성 및 가격 보기