연결 문제
주소에는 연결되지만 세션에 진입할 수 없음
먼저 노드 주소, 포트, 사용자 이름과 자격 증명을 확인한 다음 로컬 네트워크 제한, 클라이언트 암호화 옵션과 세션 상태를 점검하세요. 오래된 자격 증명을 반복해서 사용하지 마세요.
연결 점검 단계 열기
엔지니어링 문제 분류
먼저 장애 계층을 찾고, 재현 가능한 문제를 제출하세요
전용 물리 Mac 노드의 연결, Xcode 빌드, CI/CD 러너, 스토리지, 노드 네트워크와 결제 문제를 한곳에서 다룹니다. 먼저 기본 점검을 순서대로 완료하세요. 문제가 계속되면 주문, 환경 정보와 비식별화한 로그를 함께 제출해 불필요한 확인 절차를 줄일 수 있습니다.
- 6개
- 문제 유형
- 5개
- 제공 노드 지역
- 7개
- 티켓 필수 정보
배치 진단 콘솔
BUILD / CHECK
로그 대기 중
연결
주소, 포트, 자격 증명
먼저 확인
환경
시스템, Xcode, SDK
그다음 정렬
빌드
의존성, 서명, 캐시
재현
배포
아카이브, 업로드, 산출물
확인
권장 순서
연결 → 환경 → 빌드 → 배포
지원 항목 전체 보기
증상에 맞는 점검 경로로 이동
네트워크, 시스템 버전, 빌드 설정을 동시에 변경하지 마세요. 한 번에 하나의 변수만 바꾸고 원본 오류 메시지와 발생 시각을 보존해야 문제가 연결 계층인지, 환경 계층인지, 프로젝트 계층인지 판단할 수 있습니다.
Xcode 빌드
컴파일, 아카이브 또는 업로드 실패
실패한 단계를 기록한 뒤 디스크 공간, Xcode 및 SDK 버전, 의존성 잠금 파일, 서명 자료와 전체 빌드 로그를 확인하세요. 실제로 발생한 첫 번째 오류를 우선 보존하세요.
빌드 진단 순서 보기
CI/CD
러너 오프라인 또는 작업이 예약되지 않음
러너 서비스 프로세스, 등록 상태, 레이블 일치 여부, 작업 디렉터리 권한과 동시 실행 한도를 확인하세요. 플랫폼에 온라인으로 표시된다고 해서 현재 작업의 레이블이 반드시 일치하는 것은 아닙니다.
러너 설정 확인
스토리지 확장
캐시와 빌드 산출물로 공간이 가득 참
소스 코드, 의존성 캐시, DerivedData, 아카이브와 배포 산출물의 사용량을 구분하세요. 필요한 파일을 먼저 내보낸 뒤 디렉터리별로 정리하고, 용도를 확인할 수 없는 데이터는 바로 삭제하지 마세요.
스토리지 FAQ 보기
노드 이전
팀 또는 저장소 위치 변경
현재 노드, 저장소 호스팅 지역, 주요 작업자 위치와 대용량 파일 전송 방향을 먼저 기록한 뒤 이전을 검토하세요. 이전 전에는 코드와 빌드 산출물의 별도 사본을 반드시 준비해야 합니다.
노드 및 네트워크 비교
결제 문제
주문, 기간 또는 결제 상태 확인 필요
주문 번호, 선택한 구성, 결제 주기, 결제 수단과 콘솔 표시 상태를 준비하세요. 거래 식별자만 제출하고 카드 전체 정보나 개인 키는 보내지 마세요.
콘솔에서 결제 티켓 제출
최초 사용 절차
먼저 노드 기준 환경을 고정한 뒤 프로젝트 도구를 설치하세요
노드에 처음 접속하면 먼저 연결과 보안 점검을 완료한 후 개발 환경을 설정하세요. 이렇게 하면 시스템 문제와 프로젝트 의존성 문제를 분리할 수 있어 이후 재현이 더 쉬워집니다.
-
01
콘솔에서 연결 정보 확인
주문에 해당하는 노드, 서버 주소, 포트, 사용자 이름과 임시 자격 증명을 확인하세요. 연결 정보는 현재 권한이 부여된 구성원만 사용하며 채팅 기록이나 공개 문서로 전달하지 마세요.
완료 기준: 세션을 안정적으로 연결하고 주문에 해당하는 노드에 진입했는지 확인합니다. -
02
계정 보안 설정 완료
처음 접속한 후 임시 자격 증명을 변경하고 팀 권한 정책에 맞는 시스템 계정을 생성하세요. 관리자 작업은 도구 설치나 서비스 조정이 필요한 구성원에게만 맡기세요.
완료 기준: 임시 자격 증명을 더 이상 사용하지 않으며 일반 계정과 관리 계정의 용도가 구분되어 있습니다. -
03
시스템 및 개발 기준 환경 기록
macOS 버전, 칩, 사용 가능한 디스크 공간, Xcode 버전, 명령줄 도구 경로와 대상 SDK를 기록하세요. 팀은 이 정보를 자체 빌드 운영 매뉴얼에 작성해야 합니다.
완료 기준: 동일한 버전 정보로 로컬 빌드와 클라우드 빌드의 차이를 설명할 수 있습니다. -
04
의존성 및 runner 설치
프로젝트 잠금 파일에 따라 의존성을 설치하고 독립적인 캐시 디렉터리를 설정한 다음 self-hosted runner를 등록하세요. 첫 작업은 낮은 동시성으로 실행해 서명, 아카이브와 업로드 경로를 검증하세요.
완료 기준: 최소 빌드 작업을 반복 실행할 수 있고 전체 로그가 남습니다.
보관을 권장하는 환경 목록
- macOS 및 Xcode 전체 버전 번호
- 대상 SDK와 명령줄 도구 경로
- 의존성 관리자 및 잠금 파일 버전
- Runner 이름, 레이블과 작업 디렉터리
- 캐시 디렉터리 및 최대 동시 작업 수
최소 작업으로 전체 경로 확인
먼저 확실히 빌드되는 커밋 하나를 가져와 의존성 설치, 컴파일과 아카이브만 실행하세요. 성공을 확인한 뒤 병렬 작업, 캐시 복원과 배포 단계를 추가하세요.
연결 점검 전 준비
빌드 장애 진단
실패 경로를 따라 하나씩 제외하고, 변수 6개를 동시에 변경하지 마세요
빌드 문제는 일반적으로 공간, 서명, 버전, 의존성, 로그와 동시성의 6개 계층으로 나뉩니다. 각 계층을 완료할 때마다 동일한 커밋을 다시 실행하고 결과가 달라졌는지 기록하세요.
01
용량
디스크 공간
시스템 볼륨의 사용 가능 공간, DerivedData, 의존성 캐시, 아카이브 디렉터리와 내보낸 산출물을 각각 확인하세요. 공간이 부족하면 필요한 산출물을 먼저 저장한 뒤 디렉터리별로 정리하세요.
02
서명
인증서 및 프로비저닝 프로파일
프로젝트에서 선택한 팀, 인증서의 유효 상태, 프로비저닝 프로파일 대상과 Bundle Identifier가 일치하는지 확인하세요. 로그나 티켓에 서명 개인 키를 첨부하지 마세요.
03
버전
Xcode 및 SDK 버전
실제로 빌드를 실행한 Xcode 경로를 기록하고 명령줄 도구가 다른 버전을 가리키지 않는지 확인한 뒤 프로젝트에 필요한 대상 SDK가 존재하는지 점검하세요.
04
의존성
의존성 캐시
잠금 파일과 대조해 캐시가 만료되었는지 확인하세요. 먼저 캐시를 복원하지 않는 클린 빌드를 시도하고, 성공하면 의존성 캐시를 하나씩 복원해 불일치 원인을 찾으세요.
05
로그
전체 빌드 로그
실행 명령, 종료 코드와 첫 번째 실제 오류를 보존하세요. 마지막 화면만 캡처하면 앞선 실패가 누락되는 경우가 많으므로 작업 시작부터 종료까지의 비식별화한 로그를 첨부해야 합니다.
06
동시성
병렬 작업 수
동시 실행을 단일 작업으로 낮춰 메모리, 디스크와 네트워크 사용량을 관찰하세요. 단일 작업은 성공하지만 병렬 실행이 실패한다면 동시성을 단계적으로 늘려 안정적인 한계를 찾으세요.
6개 계층을 모두 점검해도 원인을 찾지 못했다면 실패한 커밋 식별자, 실행 명령, 환경 버전, 종료 코드와 비식별화한 로그를 제출하세요.
빌드 문제 티켓 제출
CI/CD 지원
러너를 식별 가능하고 복구 가능하며 감사 가능하게 운영하세요
전용 물리 노드는 self-hosted runner로 적합하지만 안정적인 운영을 위해 명확한 등록 정책, 레이블, 서비스 관리, 캐시 경계와 권한 제어가 필요합니다.
등록
각 노드에 고유한 runner 이름을 사용하고 소속 저장소 또는 조직, 등록 범위, 작업 디렉터리와 서비스 계정을 기록하세요. 노드를 이전할 때는 먼저 기존 등록을 취소하세요.
레이블
레이블은 칩 아키텍처, Xcode 주 버전, 노드 지역과 용도처럼 변하지 않는 사실을 나타내야 합니다. 임시 프로젝트 이름을 관리하기 어려운 레이블 조합으로 쌓지 마세요.
서비스 유지
runner를 관리형 서비스로 실행하고 시작 방식과 로그 위치를 기록하세요. 시스템을 다시 시작한 후 서비스가 자동으로 복구되는지 확인하고 최소 작업 하나를 테스트하세요.
캐시 디렉터리
의존성, DerivedData와 아카이브를 별도 디렉터리로 관리하고 정리 임계값을 설정하세요. 캐시는 속도를 높이는 용도이며 프로젝트의 유일한 사본이나 장기 배포 저장소가 되어서는 안 됩니다.
최소 권한
일상적인 빌드 계정에는 작업에 필요한 디렉터리와 명령 권한만 부여하세요. 도구 설치, 시스템 설정 변경과 서비스 관리가 필요할 때만 관리자 권한을 사용하세요.
Runner 오프라인 시 점검 순서
Runner 티켓 제출
서비스 프로세스 → 등록 유효성 → 레이블 일치 → 작업 디렉터리 권한 → 외부 연결 → 플랫폼 작업 큐.
용어집
먼저 용어를 통일한 뒤 문제를 설명하세요
티켓에서 일관된 용어를 사용하면 물리 노드, 원격 세션, runner와 빌드 캐시를 하나의 장애 대상으로 혼동하는 일을 막을 수 있습니다.
- 물리 노드
- macOS, Xcode와 빌드 작업이 실제로 실행되는 Apple Silicon Mac 장비입니다. 노드는 하드웨어 제공 단위이며 공유 가상 리소스가 아닙니다.
- 전용
- 하나의 주문에 해당하는 노드 리소스를 해당 고객이 사용하며 CPU, 메모리와 로컬 스토리지는 다른 고객의 작업과 섞여 예약되지 않습니다.
- 가상 머신 아님
- 시스템이 물리 Mac에서 직접 실행되며 한 장비를 여러 가상 인스턴스로 나누지 않습니다. 하드웨어 사양은 주문 구성과 직접 일치합니다.
- VNC
- macOS 그래픽 인터페이스를 원격으로 보고 조작하는 연결 방식입니다. 주소, 포트, 계정과 암호화 옵션은 연결 정보에 따라 입력해야 합니다.
- Self-hosted runner
- 팀이 CI/CD 플랫폼에 직접 등록하고 전용 노드에서 작업을 실행하는 runner입니다. 도구 버전, 캐시와 동시성 정책을 제어할 수 있습니다.
- 빌드 캐시
- 반복적인 다운로드나 컴파일을 줄이는 재생성 가능한 데이터로, 의존성 캐시와 DerivedData가 포함됩니다. 캐시가 손상되면 안전하게 다시 생성할 수 있어야 합니다.
- 서명 인증서
- 빌드 및 배포 과정에서 사용하는 민감한 서명 자료입니다. 문제를 진단할 때는 인증서 이름, 상태와 오류만 설명하고 티켓에 개인 키를 업로드하지 마세요.
- 노드 지역
- 물리 노드가 위치한 지역입니다. 선택할 때 개발자 위치, 코드 저장소 위치, 배포 대상과 대용량 파일 전송 방향을 함께 고려하세요.
노드 및 네트워크 점검
지역은 한 번의 지연 시간이 아니라 전체 워크플로를 기준으로 선택하세요
VMArm은 싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 서부 등 5개 노드 지역을 제공합니다. 원격 조작, 저장소 가져오기, 의존성 다운로드와 산출물 업로드 방향을 함께 비교해야 합니다.
싱가포르
동남아시아 팀과 주요 서비스가 동남아시아에 위치한 저장소 및 배포 경로에 적합합니다.
일본(도쿄)
일본 및 동아시아 팀에 적합하며 원격 데스크톱 조작과 지역 내 빌드 리소스 접근을 균형 있게 지원합니다.
한국(서울)
한국 및 동북아 방향의 개발자, 의존성 미러와 배포 흐름에 적합합니다.
홍콩
중국 남부 및 동남아시아 협업 팀에 적합하며 선택 전에 저장소와 원격 세션 경로를 함께 테스트해야 합니다.
미국 서부
북미 서부 팀과 주요 저장소, 의존성 소스 또는 배포 시스템이 북미에 위치한 프로젝트에 적합합니다.
| 점검 대상 | 측정 방법 | 기록할 내용 | 판단 기준 |
|---|---|---|---|
| 원격 세션 | 업무 시간과 비혼잡 시간대에 연결 및 상호 작용을 각각 테스트 | 로컬 네트워크, 노드, 클라이언트 버전, 발생 시각 | 지속적인 이상인지 특정 시간대의 변동인지 |
| 코드 저장소 | 동일한 저장소와 커밋으로 복제, 가져오기와 서브모듈을 테스트 | 저장소 지역, 소요 시간, 실패 명령, 종료 코드 | 연결 수립이 느린지 대용량 파일 전송이 느린지 |
| 의존성 다운로드 | 캐시를 끈 상태에서 전체 의존성 분석을 한 번 실행 | 의존성 소스, 패키지 관리자 버전, 실패 패키지와 재시도 횟수 | 단일 의존성 소스 문제인지 전체 대역폭 문제인지 |
| 산출물 업로드 | 동일한 크기의 비식별화한 테스트 파일로 전송을 비교 | 파일 크기, 대상 지역, 시작 및 종료 시각 | 업로드 경로, 대상 서비스 또는 파일 크기의 영향 |
티켓 제출에 필요한 정보
진단에 필요한 맥락을 한 번에 모두 제공하세요
티켓의 목적은 문제가 존재한다는 사실을 증명하는 것이 아니라, 지원 담당자가 동일한 주문, 노드, 시간과 실패 단계를 확인할 수 있게 하는 것입니다.
진단 정보 시트
필수 입력 항목 7개
01
주문 번호
해당 구성, 결제 주기와 제공 기록을 확인하는 데 사용됩니다.
02
노드 지역
싱가포르, 일본(도쿄), 한국(서울), 홍콩 또는 미국 서부를 명시하세요.
03
발생 시각
시간대를 포함한 시각을 제공하고 문제가 반복되는지 설명하세요.
04
시스템 버전
주 버전 이름만 쓰지 말고 전체 macOS 버전을 입력하세요.
05
Xcode 버전
실제 명령줄 도구가 가리키는 버전과 경로도 함께 입력하세요.
06
재현 단계
정상 상태에서 시작해 실제 클릭 또는 명령 순서대로 단계별로 설명하세요.
07
비식별화한 로그
오류 맥락과 종료 코드는 보존하고 토큰, 개인 키와 기타 민감 정보를 제거하세요.
제출 전에 액세스 토큰, 서명 개인 키, 결제 전체 정보와 기타 민감한 내용을 제거하세요. 데이터 처리 방식을 확인하려면개인정보 처리방침을 읽어 보세요.
지원 범위 및 응답 절차
문제 확인부터 티켓 종료까지 각 단계마다 결과를 제공합니다
응답 순서는 영향 범위와 재현 가능성에 따라 달라집니다. 지원 절차는 노드 제공, 연결, 환경과 주문 문제를 담당하며 프로젝트 비즈니스 로직은 프로젝트 담당자가 확인해야 합니다.
-
01
문제 분류
연결 불가, 빌드 전체 중단, 일부 작업 이상 또는 일반 문의인지에 따라 영향 범위를 판단하고 실행 가능한 대체 경로가 있는지 확인합니다.
-
02
접수 확인
주문 번호, 노드, 시각, 환경과 로그를 받았는지 확인합니다. 필수 정보가 부족하면 보완해야 할 항목을 명확히 안내합니다.
-
03
진단 업데이트
현재 점검 계층, 제외된 항목, 다음 검증 작업과 사용자가 실행해야 할 테스트를 안내해 정보가 늘지 않는 단계를 반복하지 않도록 합니다.
-
04
종료 조건
문제가 복구되고 원인과 회피 방법이 안내되었거나 프로젝트 설정 문제임을 확인하고 실행 가능한 점검 방향을 제시하면 티켓 종료 절차로 진행합니다.
지원 범위
- 주문 및 노드 제공 상태 확인
- VNC 주소, 포트와 세션 연결 점검
- 노드 시스템, 디스크, 네트워크와 권한 기본 진단
- Runner 서비스 상태 및 일반 설정 확인
- 결제 주기와 결제 상태 안내
프로젝트 팀과 함께 확인해야 하는 항목
- 비즈니스 코드 로직 및 타사 SDK 동작
- 프로젝트 사용자 지정 스크립트 및 내부 의존성 소스
- 팀이 자체적으로 정한 서명 및 배포 절차
- 저장소 권한, 브랜치 정책과 작업 트리거 조건
- 빌드 산출물의 비즈니스 검수 기준
다음 단계
다음 빌드를 전용 물리 Mac 노드에서 실행하세요
VMArm M4 Core 또는 VMArm M4 Plus를 선택하고 싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 서부 중에서 노드를 고르세요. 실제 이용 가능 여부는 콘솔의 실시간 결과를 기준으로 합니다.