검수부터 안정적인 운영까지

클라우드 Mac을 빌드 워크플로에 연결하세요

장비 정보를 받은 뒤 주문과 물리 노드를 먼저 확인하고 연결, 툴체인 재현, CI 러너 등록을 완료하세요. 각 단계에 점검 명령, 완료 기준, 오류 발생 시 보존할 증거를 제시합니다.

판매 노드
5개물리 노드
판매 구성
2종전용 물리 머신
운영 단계
9개 그룹점검 단계
최초 연결 인수인계판 순서대로 검증
01

인수인계 기록 확인

노드, 구성, 시스템 버전, 대여 기간과 접속 자격 증명이 주문 확인 정보와 일치해야 합니다.

검수
02

첫 세션 시작

먼저 명령줄 연결을 검증한 뒤 업무에 맞게 그래픽 세션을 만들고 연결 끊김 복구를 테스트하세요.

연결
03

개발 환경 재현

Xcode, 의존 도구와 작업 디렉터리를 고정하고 기존 머신의 파일 전체를 그대로 덮어쓰지 마세요.

구성
04

실제 빌드 실행

실제 저장소로 아카이브 또는 테스트 작업을 한 번 실행하고 소요 시간, 로그와 산출물 검증 결과를 기록하세요.

검증
제공 상태 콘솔의 실시간 응답 기준
시작 전 준비

어떤 장비와 노드인지, 대여 기간은 얼마인지 먼저 확인하세요

정보를 확인하기 전에는 환경을 이전하지 마세요. 먼저 콘솔에 로그인해 주문 기록과 장비 세부 정보를 항목별로 비교하고, 필드가 다르면 페이지 정보를 보존한 뒤 티켓을 제출하세요.

01

노드 및 네트워크 방향

노드가 싱가포르, 일본 도쿄, 한국 서울, 홍콩 또는 미국 동부 중 하나인지 확인하세요. 노드 코드를 기록하고 주요 사무실 네트워크에서 연결 경로를 테스트하세요.

  • 팀의 주요 접속 위치와 노드 시간대 확인
  • 사무실 네트워크와 보조 네트워크에서 각각 테스트
  • 단일 ping 결과가 아니라 지연 시간, 지터와 패킷 손실 기록
02

장비 구성

구성은 두 종류입니다. 정보를 받은 뒤 칩, 메모리와 저장 공간을 항목별로 확인하세요.

  • 기본형: M4, 16GB, 256GB
  • 고급형: M4 Pro, 64GB, 2TB
  • 추가 저장 공간은 주문 확인 기록을 기준으로 합니다
03

시스템 및 접속 정보

시스템 버전, 호스트 이름, 접속 주소, 포트와 임시 자격 증명을 확인하세요. 최초 로그인 후 팀 규정에 따라 즉시 자격 증명을 교체하세요.

  • 비밀번호나 개인 키를 공개 로그에 붙여 넣지 않기
  • 자격 증명은 관리되는 비밀 관리 도구에 저장
  • 명령줄과 그래픽 연결에 각각 필요한 정보 확인
04

대여 기간 및 종료 시점

일·주·월·분기 단위로 대여하더라도 시작 전에 데이터 내보내기 시간과 작업 중지 시점을 정해 정리 작업을 마지막까지 미루지 마세요.

  • 대여 시작 및 종료 정보 기록
  • 산출물 내보내기와 캐시 정리 시간 확보
  • 연장 또는 변경 요청의 내부 담당자 확인
최초 연결 가이드

먼저 명령줄로 장비 접근 가능 여부를 확인한 뒤 그래픽 세션을 만드세요

명령줄은 기본 검수와 자동화에, 그래픽 세션은 Xcode·시뮬레이터와 시각적 조작에 적합합니다. 두 방식을 각각 검증하고 한쪽의 성공을 전체 연결 정상으로 간주하지 마세요.

명령줄 연결

최소 검증 세션 만들기

  1. 1
    대상 정보 확인

    콘솔에서 호스트 주소, 포트와 사용자 이름을 복사하고 문자와 대소문자를 확인하세요. 이전 티켓의 만료된 정보를 재사용하지 마세요.

  2. 2
    호스트 지문 검증

    최초 연결 시 제공 정보와 대조하세요. 지문이 바뀌면 연결을 중지하고 원인을 확인한 뒤 로컬 기록을 삭제하고 재시도하지 마세요.

  3. 3
    읽기 전용 점검 실행

    현재 사용자, 호스트 이름, 시스템 버전, 디스크와 Xcode 경로를 확인하고 즉시 소프트웨어를 설치하거나 삭제하지 마세요.

  4. 4
    연결 끊김 복구 검증

    직접 연결을 끊은 뒤 다시 연결하여 세션 복구 방식, 장시간 작업 유지 정책과 로그 저장 디렉터리를 확인하세요.

그래픽 원격 액세스

화질과 작업 안정성을 따로 검증하세요

  1. 1
    낮은 화질부터 시작

    먼저 낮은 해상도와 색 품질로 세션 안정성을 확인한 뒤 설정을 단계적으로 높이세요. 화면 끊김을 장비 성능 문제로 오판하지 마세요.

  2. 2
    자격 증명과 클립보드 보호

    공유 화면, 화면 녹화 또는 관리되지 않는 클립보드에 비밀번호, 개인 키와 인증서 암호를 노출하지 마세요.

  3. 3
    무인 세션 잠금

    장비를 떠나기 전에 그래픽 세션을 잠그세요. 여러 사람이 협업할 때 동시에 조작하는 사람을 명확히 해 환경을 병렬로 변경하지 않도록 하세요.

  4. 4
    재연결 후 상태 확인

    연결이 끊겼다 다시 연결된 후 포그라운드 앱, 빌드 프로세스와 디스크 쓰기가 계속 실행 중인지 확인하세요. 화면이 멈춘 것만으로 작업 실패를 판단하지 마세요.

터미널 빠른 점검

읽기 전용 명령 세트로 장비 기준선 만들기

다음 명령은 칩, 메모리, 디스크, 시스템 버전, 네트워크와 개발 도구 경로를 점검합니다. 실행 후 출력을 저장하되 티켓 제출 전 사용자 이름, 내부 저장소 주소와 기타 민감한 필드를 삭제하세요.

DPLYMAC / FIRST-RUN CHECK
printf '\n== CHIP ==\n'
system_profiler SPHardwareDataType | grep -E "Chip|Memory"

printf '\n== DISK ==\n'
diskutil info / | grep -E "Device Node|File System|Disk Size|Free Space"

printf '\n== SYSTEM ==\n'
sw_vers
uname -m

printf '\n== NETWORK ==\n'
route -n get default | grep interface
ping -c 5 1.1.1.1

printf '\n== XCODE ==\n'
xcodebuild -version
xcode-select -p
swift --version

printf '\n== TOOL PATHS ==\n'
command -v git
command -v ruby
command -v fastlane

통과 여부 확인 방법

  • 칩과 메모리가 주문 구성과 일치
  • 루트 볼륨을 읽고 쓸 수 있으며 잔여 공간이 작업 요구 사항을 충족
  • 시스템 아키텍처 출력이 arm64
  • 기본 네트워크 인터페이스가 존재하고 연속 테스트에서 뚜렷한 패킷 손실이 없음
  • Xcode와 명령줄 도구 경로가 예상 버전을 가리킴

보존할 항목

  • 명령 실행 시간과 노드
  • 마지막 한 줄만이 아니라 전체 명령
  • 원본 출력과 민감 정보 제거 후 티켓에 첨부할 버전
  • 예상 결과, 실제 결과와 재현 횟수
Xcode 및 서명 환경

툴체인을 먼저 고정한 뒤 빌드 자료를 가져오세요

환경 일관성은 기존 머신의 사용자 디렉터리 전체를 복사하는 것이 아니라 명확한 버전과 반복 가능한 단계에서 나옵니다. 서명 자료는 필요한 최소 항목만 가져오고 대여 기간이 끝나기 전에 정리하세요.

점검 항목 작업 완료 기준
Xcode 버전

실행 xcodebuild -version하여 주 버전과 빌드 번호를 기록하세요. 프로젝트가 특정 버전으로 고정되어 있다면 요구 사항을 저장소 문서에 작성하세요.

버전이 프로젝트 요구 사항과 일치
명령줄 도구

실행 xcode-select -p하고 필요하면 팀이 승인한 경로로 전환하세요. 작업 중간에 임의로 업그레이드하지 마세요.

경로가 대상 Xcode를 가리킴
인증서 가져오기

현재 프로젝트에 필요한 인증서만 가져오고 관리되는 전송 방식을 사용하며 키체인 접근 범위를 제한하세요.

대상 서명 ID를 확인 가능
프로비저닝 프로파일

앱 ID, 팀 정보, 기능과 유효 상태를 확인하여 다른 프로젝트의 잔여 파일과 혼용하지 마세요.

아카이브 대상이 프로젝트 구성과 일치
키체인 잠금 해제

빌드 스크립트에서 필요한 최소 시간 동안만 잠금 해제하고 작업이 끝나면 다시 잠그세요. 암호를 저장소나 일반 로그에 기록하지 마세요.

비대화형 빌드에서 필요한 항목을 읽을 수 있음
빌드 전 검증

의존성 해석, 프로젝트 목록과 서명 설정을 먼저 점검한 뒤 전체 아카이브를 시작하세요.

정식 빌드 전에 실패를 확인
마이그레이션 작업 경로

데이터·툴체인·러너를 세 번에 나눠 인수인계하세요

한 번에 변수 하나만 바꾸고 롤백 지점을 남기세요. 그러면 빌드 차이가 데이터, 의존 환경 또는 CI 등록에서 비롯되었는지 확인할 수 있습니다.

인수인계 01

데이터 동기화

입력
소스 코드, 필수 리소스, 의존성 잠금 파일과 빌드 스크립트
작업
우선 버전 저장소에서 가져오고, 대용량 파일은 별도로 검증하세요. 관련 없는 캐시와 기존 산출물은 복사하지 마세요
검증
커밋 버전, 파일 수와 체크섬이 예상과 일치하고 민감한 파일이 저장소에 포함되지 않음
일반적인 실패
무시 규칙에서 파일 누락, 대소문자 경로 차이, 줄바꿈 변경, 권한 비트 손실
롤백 지점
깨끗한 작업 디렉터리를 보존하여 이번 동기화 내용을 삭제한 뒤 다시 가져올 수 있음
인수인계 02

툴체인 재현

입력
Xcode 요구 사항, 의존성 목록, 패키지 관리자 잠금 파일과 스크립트 런타임 버전
작업
문서에 따라 최소 도구 세트를 설치하고 버전을 고정한 뒤 경로와 환경 변수를 작업 구성에 명시하세요
검증
의존성 해석이 성공하고 동일한 커밋이 로컬 명령과 자동화 스크립트에서 일관된 결과를 냄
일반적인 실패
암묵적 전역 의존성, 기본 Ruby 차이, 잘못된 Xcode 경로, 캐시 오염
롤백 지점
버전 목록과 설치 로그를 보존하고 도구 캐시를 비운 뒤 다시 재현할 수 있음
인수인계 03

CI 연동

입력
러너 등록 정보, 큐 태그, 작업 디렉터리, 캐시 규칙과 동시 실행 한도
작업
러너 한 대를 등록하고 먼저 읽기 전용 점검 작업을 실행한 뒤 실제 저장소의 전체 파이프라인을 제출하세요
검증
작업이 올바르게 예약되고 종료 코드, 로그, 테스트 결과와 산출물을 추적할 수 있음
일반적인 실패
태그 불일치, 작업 디렉터리 재사용, 지나치게 넓은 캐시 키, 여러 작업의 동일 리소스 선점
롤백 지점
러너를 등록 해제하고 수동 빌드로 복구하되 이미 검증한 데이터와 툴체인에는 영향을 주지 않음
CI/CD 연동

러너 등록이 곧 파이프라인 안정성을 의미하지는 않습니다

등록 후 최소한 콜드 캐시 작업, 웜 캐시 작업과 실패 재시도를 각각 한 번씩 검증하세요. 작업 디렉터리, 캐시와 동시 실행 정책은 파이프라인에서 명시적으로 관리해야 합니다.

일반적인 CI 러너 연동 점검
플랫폼 등록 점검 작업 디렉터리 캐시 전략 동시 실행 권장
GitHub Actions 셀프 호스팅 Runner 태그와 대상 저장소 또는 조직 범위를 확인 각 작업에 독립 작업 공간을 사용하고 종료 후 임시 파일 정리 캐시 키에 잠금 파일 요약, Xcode와 아키텍처 정보를 포함 먼저 단일 작업으로 검증한 뒤 메모리와 디스크 부하에 따라 동시 실행을 늘림
GitLab CI Runner 태그, 보호 브랜치 권한과 러너 상태 확인 여러 프로젝트가 쓰기 가능한 디렉터리와 동일한 산출물 경로를 공유하지 않도록 함 프로젝트, 브랜치와 의존성 요약별로 캐시 범위 구분 아카이브, 테스트와 경량 점검에 서로 다른 큐 설정
Jenkins 노드 태그, 원격 루트 디렉터리와 자격 증명 범위 확인 파이프라인 종료 후 workspace를 정리하되 필요한 로그는 보존 의존성 캐시와 빌드 산출물을 분리 관리 중량 아카이브 작업이 같은 장비를 동시에 점유하지 않도록 제한
자체 구축 Runner 서비스 시작 방식, 실행 사용자와 작업 수락 조건 기록 작업 ID별 디렉터리를 만들고 종료 시 결정적 정리 실행 캐시 소유자, 용량 한도와 만료 조건 명시 스크립트가 운 좋게 잠금을 얻기를 기대하지 말고 큐로 리소스 제어

등록 완료

러너가 온라인이고 태그가 일치하며 실행 사용자가 올바르고 승인된 저장소와 자격 증명만 읽을 수 있음

작업 재현 가능

동일한 커밋이 콜드 캐시와 웜 캐시 모두에서 일관된 산출물을 만들고 실패 시 명확한 종료 코드를 남김

디렉터리 회수 가능

임시 서명 파일, 파생 데이터와 빌드 중간 산출물에 확실한 정리 규칙이 있으며 수동 삭제에 의존하지 않음

동시 실행 한도 설정

CPU, 메모리와 SSD 부하에 따라 큐를 설정하여 여러 아카이브 작업이 서로 리소스를 빼앗지 않도록 함

성능 문제 해결

먼저 병목이 어느 계층에 있는지 파악한 뒤 매개변수를 조정하세요

성능 문제는 최소한 발생 시간, 노드, 작업 제출 버전, 재현 단계와 비교 결과를 기록해야 합니다. 단순히 ‘느리다’고만 하면 리소스 부하, 네트워크 경로와 그래픽 세션 문제를 구분할 수 없습니다.

CPU

지속적인 계산인지 짧은 피크인지 확인

사용량이 높은 프로세스, 스레드 수와 작업 단계를 기록하세요. 단일 작업과 동시 작업을 비교하고 중복 빌드, 제어되지 않는 테스트 또는 백그라운드 인덱싱이 있는지 확인하세요.

프로세스 샘플링
메모리

메모리 압박과 스왑 활동 확인

최대 메모리, 압축 메모리와 스왑 변화를 기록하세요. 작업이 동시 실행에서만 실패한다면 네트워크 탓을 하기 전에 동시 실행 수를 낮춰 비교하세요.

부하 비교
SSD

용량 부족과 랜덤 읽기·쓰기 정체 구분

잔여 공간, 파생 데이터, 의존성 캐시와 기존 산출물을 확인하세요. 정리 전에 디렉터리 용량을 기록하여 문제 증거를 잃지 않도록 하세요.

용량 및 I/O
네트워크

지연 시간, 지터, 패킷 손실과 처리량 비교

고정된 로컬 네트워크에서 연속 테스트하고 보조 네트워크와 비교하세요. 저장소 가져오기가 느릴 때는 노드 경로와 의존성 서비스 응답도 구분해야 합니다.

연속 샘플링
그래픽 세션

화면 끊김이 빌드 프로세스 지연을 뜻하지는 않습니다

해상도와 색 품질을 낮춘 뒤 다시 테스트하고 명령줄로 작업이 계속 실행되는지 관찰하세요. 재연결 후 포그라운드와 백그라운드 상태를 기록하세요.

세션 분리
보안 및 종료

최초 로그인부터 최종 인수인계를 준비하세요

자격 증명, 서명 자료, 빌드 산출물과 캐시에는 모두 명확한 소유자가 있어야 합니다. 대여 기간이 끝나기 전에 순서대로 내보내고, 검증하고, 제거하고, 재확인하여 정리 작업을 기억에 의존하지 않도록 하세요.

지속 실행

자격 증명 및 권한

  • 최초 연결 후 임시 자격 증명 교체
  • 저장소와 작업별로 최소 권한 부여
  • 러너와 자동화 키의 권한 범위를 정기적으로 점검
  • 스크립트, 저장소와 일반 로그에 암호를 기록하지 않기
내보내기 전

산출물 및 데이터

  • 아카이브, 테스트 보고서와 필요한 로그 내보내기
  • 대상 위치에서 파일 수와 체크섬 확인
  • 저장소 커밋과 원격 브랜치가 동기화되었는지 확인
  • 계속 보존할 빌드 기준선 기록
대여 기간 종료 전

환경 정리

  • CI 러너 등록 해제 및 연결된 자격 증명 폐기
  • 인증서, 프로비저닝 프로파일, 개인 키와 복구 코드 제거
  • 작업 디렉터리, 임시 파일과 민감한 캐시 삭제
  • 다운로드 폴더, 데스크톱과 명령 기록 재확인
지원 요청

첫 번째 티켓부터 재현 가능한 조건을 갖추세요

기존 주문 관련 문제는 콘솔에 로그인하여 티켓을 제출하세요. 로그인할 수 없다면 다음 주소로 이메일을 보낼 수 있습니다 support@deploymac.com제출하기 전에 비밀번호, 개인 키, 인증서 암호와 기타 민감한 자격 증명을 반드시 삭제하세요.

장애 기록 템플릿 필드는 복사하되 민감한 정보는 복사하지 마세요
주문 식별자

콘솔에서 주문을 찾는 데 사용할 수 있는 식별자를 입력

노드

싱가포르, 일본 도쿄, 한국 서울, 홍콩 또는 미국 동부

발생 시간

시간대를 명시하고 최초 발생 및 최근 재현 시간을 기재

장비 구성

기본형 또는 고급형과 추가 저장 공간 정보

재현 단계

깨끗한 상태에서 시작하여 실제 실행 순서대로 항목별 기재

명령 출력

전체 명령, 종료 코드와 민감 정보 제거 후 출력을 첨부하고 스크린샷만 첨부하지 않기

예상 결과

정상적으로 나타나야 하는 상태, 파일 또는 반환값 설명

실제 결과

차이, 재현 횟수와 전체 작업에 미치는 영향 설명

시도한 작업

재시도, 재연결, 동시 실행 축소 또는 캐시 삭제 등의 작업과 결과 나열

기존 주문 및 연결 장애

콘솔 티켓은 주문, 노드와 장비 정보를 연결할 수 있어 제공 정보 확인, 연결 이상과 운영 문제 처리에 적합합니다.

콘솔에 로그인하여 티켓 제출

아직 주문하지 않았거나 로그인할 수 없음

이메일에 용도, 대상 노드, 예상 대여 기간과 문제 영향 범위를 적으세요. 비밀번호, 개인 키 또는 인증서 암호는 절대 보내지 마세요.

지원 이메일 보내기
다음 단계

작업 부하에 맞는 구성을 선택한 뒤 최초 연결을 시작하세요

기본형은 가벼운 빌드와 일상 개발에, 고급형은 대규모 메모리 실험, 다중 프로젝트 동시 실행과 더 무거운 빌드 작업에 적합합니다. 두 구성 모두 전용 물리 머신이며 가상 머신이 아닙니다.