클라우드 Mac 연결·빌드·성능 문제 해결 지원

01

노드 상태 확인

콘솔에서 대상 노드가 ‘준비 완료’로 표시되는지 확인하고 노드 식별자, 리전 및 선택한 모델을 대조하세요. 노드가 아직 준비 중이라면 클라이언트 오류만으로 연결 문제라고 판단하지 마세요.
완료 기준: 노드 식별자가 주문과 일치하고 연결 가능한 상태여야 합니다.
02

로그인 정보 복사

콘솔의 현재 노드 상세 정보에서 주소, 포트 및 사용자 이름을 복사하세요. 이전 문의, 오래된 스크린샷 또는 다른 노드에 저장된 기록은 사용하지 마세요. 비밀번호를 붙여넣을 때 앞뒤 공백과 입력기의 전각 문자를 확인하세요.
완료 기준: 주소, 포트 및 사용자 이름이 동일한 노드 상세 정보에서 가져온 것이어야 합니다.
03

로컬 네트워크 확인

먼저 일반 HTTPS 접속이 정상인지 확인한 뒤 사무실 네트워크와 신뢰할 수 있는 대체 네트워크에서 각각 테스트하세요. 기업 네트워크 출구, 방화벽 또는 프록시가 특정 포트만 차단할 수 있으므로 웹페이지가 열린다고 원격 연결까지 가능한 것은 아닙니다.
완료 기준: 사용한 네트워크, 출구 유형 및 실패 시간을 기록하세요.
04

키보드 레이아웃 설정

macOS 그래픽 인터페이스에 들어간 후 문자, 숫자, 기호, Command 및 Option 매핑을 먼저 테스트하세요. 기호 위치가 다르면 로컬 키보드 레이아웃과 원격에서 선택한 레이아웃도 함께 기록하세요.
완료 기준: 터미널에서 명령에 포함된 따옴표, 슬래시 및 하이픈을 정확히 입력할 수 있어야 합니다.
05

시간대와 시간 통일

작업 로그, CI 기록 및 문의 시간에 동일한 시간대를 표시하세요. 간헐적 오류를 조사할 때 시간대 없는 ‘14:20’만으로는 노드 이벤트와 대조할 수 없습니다. 시간대가 포함된 전체 날짜와 시간을 사용하세요.
완료 기준: 로컬, 노드 및 자동화 로그의 시간을 서로 변환할 수 있어야 합니다.

첫 연결에 성공한 뒤 민감한 인증 정보가 없는 기준 기록을 저장하는 것이 좋습니다. 노드 식별자, 리전, 연결 방식, 클라이언트 버전, 키보드 레이아웃, 시간대 및 성공한 연결 시간을 포함하세요. 이후 문제가 발생하면 이 기준과 바로 비교할 수 있습니다.

DECISION TREE

연결 문제 해결 트리: 한 번에 한 계층만 확인

연결 시간 초과는 대개 네트워크나 주소 문제를, 인증 실패는 사용자 이름·비밀번호·키 또는 클라이언트 설정 문제를 가리킵니다. 먼저 오류 유형별로 나눈 다음 5단계 점검을 실행하세요.

1

로컬 네트워크가 안정적인가요?

LOCAL

라우팅을 변경하는 임시 프록시를 끈 뒤 다시 시도하고 신뢰할 수 있는 대체 네트워크에서도 한 번 비교 테스트를 진행하세요. 사무실 네트워크에서 실패하고 대체 네트워크에서 성공한다면 출구 정책과 영향을 받은 포트를 기록하고 로컬 네트워크 관리자에게 우선 문의해야 합니다.

계속 조건:동일한 대상에 대해 하나 이상의 신뢰할 수 있는 네트워크에서 연결을 시도해야 합니다.

2

대상 주소와 포트가 현재 노드에 속하나요?

TARGET

콘솔로 돌아가 대상 정보를 다시 복사하고 명령 기록의 주소를 재사용하지 마세요. 브라우저 원격 데스크톱은 콘솔에서 제공한 진입점을 사용하고, SSH는 호스트·포트·사용자 이름이 동일한 연결 기록에 속하는지 확인하세요.

중지 조건:주소가 변경되었거나 다른 노드의 기록이라면 정보를 갱신한 후 다시 테스트하세요.

3

인증 정보가 완전하며 입력기로 변형되지 않았나요?

AUTH

사용자 이름의 대소문자, 비밀번호 앞뒤 공백, 키 파일 권한 및 선택한 인증 파일을 확인하세요. SSH 호스트 지문이 처음 표시되면 콘솔 정보와 대조해야 합니다. 지문이 예기치 않게 변경되면 연결을 중지하고 문의를 통해 원인을 확인하세요.

증거 요구사항:원문 오류는 보관하되 비밀번호, 키 내용 및 전체 접속 주소는 가리세요.

4

콘솔의 노드 상태가 연결을 허용하나요?

NODE

노드 상세 정보를 새로 고쳐 상태, 노드 식별자 및 마지막 변경 시간을 확인하세요. 상태가 비정상이면 재시작과 같은 작업을 반복하지 마세요. 작업 전 상태, 실행한 작업 및 각 작업 시간을 기록해 문제 상황이 덮어써지지 않게 하세요.

문의 조건:노드 상태가 비정상이거나 상태는 정상이지만 신뢰할 수 있는 두 네트워크 모두에서 연결할 수 없어야 합니다.

5

클라이언트 설정이 화면 또는 세션 문제를 일으키나요?

CLIENT

브라우저 페이지가 비어 있으면 현재 안정 버전의 브라우저를 사용하고 해당 사이트의 세션 데이터를 삭제한 후 다시 시도하세요. 키보드가 어긋나면 단일 레이아웃으로 설정하세요. SSH 세션이 자주 끊기면 터미널 플러그인을 먼저 끄고 기본 명령으로 비교 세션을 구축하세요.

완료 조건:클라이언트 이름, 버전, 연결 방식 및 재현 가능한 절차를 기록하세요.

오류가 ‘시간 초과’ 또는 ‘연결할 수 없음’인 경우

네트워크 유형, 실패 시간, 대상 리전, 두 네트워크의 비교 결과 및 콘솔의 노드 상태를 우선 제출하세요. 시간과 노드 식별자가 없는 스크린샷 한 장만 제출하지 마세요.

오류가 ‘인증 실패’인 경우

현재 노드의 사용자 이름, 인증 방식 및 클라이언트 인증 파일을 우선 확인하세요. 문의에는 인증 방식과 원문 오류만 작성하고 비밀번호, 개인 키 또는 바로 사용할 수 있는 인증 정보를 보내지 마세요.

BUILD PIPELINE

빌드 작업 문제 해결: 도구 버전부터 바깥쪽으로 점검

빌드 오류는 마지막 요약 줄이 아니라 처음 발생한 명확한 오류부터 확인해야 합니다. 먼저 도구 체인을 고정한 뒤 서명, 종속성, 디스크 및 자동화 프로세스를 점검하세요.

Xcode 도구 체인

macOS 버전, Xcode 버전, 명령줄 도구 경로 및 빌드 명령을 기록하세요. 그래픽 인터페이스와 자동화 작업이 서로 다른 도구 경로를 호출하면 동일한 노드에서도 결과가 달라질 수 있습니다.

작업에서 실제로 호출한 Xcode 경로 확인
전체 빌드 명령과 작업 디렉터리 보관
성공한 작업과 실패한 작업의 버전 차이 비교

인증서 및 서명

인증서 누락, 프로비저닝 파일 불일치, 권한 범위 불일치 및 키체인 접근 실패를 구분하세요. 진단 자료에는 인증서 이름, 유효 기간 및 오류 텍스트를 남기되 인증서 파일, 비밀번호 및 프로젝트의 민감한 식별자는 가리세요.

자동화 프로세스가 필요한 서명 자료에 접근할 수 있는지 확인
대상, 빌드 구성 및 서명 설정이 일치하는지 확인
오류가 보관, 내보내기 또는 업로드 중 어느 단계에서 발생했는지 기록

종속성 및 캐시

먼저 잠금 파일만으로 실패를 안정적으로 재현할 수 있는지 확인한 다음 캐시를 최소 범위로 정리하세요. 모든 종속성과 빌드 캐시를 한 번에 삭제하면 변수가 늘어나고 원래 문제가 일시적으로 사라져 원인을 찾기 어려워질 수 있습니다.

종속성 잠금 파일과 패키지 관리자 버전 저장
실패한 대상과 직접 관련된 캐시만 정리
정리 전후 첫 빌드 시간과 오류 차이 기록

디스크 및 자동화 로그

보관, 종속성 압축 해제 및 임시 산출물에는 추가 공간이 필요합니다. 프로젝트 디렉터리 크기만 확인해서는 부족하며 사용 가능한 용량, 임시 디렉터리, 빌드 캐시 및 리소스 부족으로 종료된 자동화 프로세스도 확인해야 합니다.

실패 전후 사용 가능한 디스크 용량 기록
작업 시작, 종료 및 종료 코드 보관
첫 오류 전후 최소 50줄의 로그 발췌

diagnostic.txt 읽기 전용 수집

sw_vers
xcodebuild -version
xcode-select -p
df -h
system_profiler SPHardwareDataType

date "+%Y-%m-%d %H:%M:%S %z"
xcodebuild ... 2>&1 | tee build.log

명령 출력에 장치 이름, 경로 또는 프로젝트 식별자가 포함될 수 있습니다. 제출 전에 비식별화하되 오류 코드, 버전, 타임스탬프 및 리소스 데이터는 삭제하지 마세요.

PERFORMANCE SAMPLE

성능 문제 해결: 같은 시간대의 4가지 지표 기록

CPU 스크린샷 하나만으로는 디스크 대기, 메모리 압박 또는 네트워크 변동을 설명할 수 없습니다. 문제가 발생하기 전후로 5~10분 연속 샘플링하고 작업 시작 및 실패 시간을 표시하세요.

지표	최소 기록 항목	확인할 현상	작업과 비교할 내용
CPU	전체 사용률, 주요 프로세스, 샘플링 시간	단일 프로세스의 지속적인 점유, 급격한 부하 증가, 작업 종료 후에도 회복되지 않음	컴파일·링크·테스트 또는 추론 시작 시간 표시
메모리	사용 메모리, 메모리 압박, 스왑 공간	압박이 계속 증가함, 잦은 스왑, 시스템에 의해 프로세스가 종료됨	병렬 작업 수와 입력 규모 기록
디스크	사용 가능 공간, 읽기·쓰기 처리량, I/O 대기	공간이 거의 소진됨, 압축 해제 또는 보관 단계에서 대기가 뚜렷함	종속성 다운로드, 빌드 캐시 및 산출물 쓰기 구분
네트워크	로컬 네트워크 유형, 왕복 지연 시간, 패킷 손실 여부	특정 출구에서만 이상 발생, 노드 작업은 정상인데 상호작용이 끊김	원격 화면, 종속성 다운로드 및 코드 가져오기 구분

SAMPLE

샘플은 문제 발생 전후를 포함해야 합니다

작업 시작 전부터 기준을 기록하고 문제가 발생한 뒤 최소 1분까지 계속하세요. 이상 순간의 데이터만으로는 리소스 문제가 원인인지 결과인지 판단할 수 없습니다.

COMPARE

정상 작업 한 번을 비교 자료로 보관

동일한 프로젝트, 종속성 및 병렬 처리 수준으로 정상 작업을 한 번 기록하고 전체 시간만이 아니라 각 단계의 소요 시간과 리소스 곡선을 비교하세요.

BOUNDARY

먼저 상호작용 지연과 계산 지연을 구분

원격 화면은 끊기지만 노드 내부 작업 시간은 안정적이라면 네트워크를 우선 확인하세요. 작업 자체의 소요 시간이 늘었다면 CPU, 메모리 및 디스크를 계속 점검하세요.

MINIMUM EVIDENCE

최소 진단 정보: 문제를 재현할 수 있게 준비하세요

지원 요청에 전체 프로젝트를 업로드할 필요는 없습니다. 다음 항목만으로도 보통 첫 판단이 가능하며, 누락된 정보가 있으면 지원팀이 추가로 요청합니다.

01

노드 및 환경

노드 식별자, 노드 리전, macOS 버전, Xcode 또는 클라이언트 버전. 비밀번호, 개인 키 또는 전체 인증 정보는 입력하지 마세요.
02

정확한 시간 범위

‘날짜 + 시:분:초 + 시간대’ 형식을 사용하고 최초 발생, 마지막 발생 및 최근 재현 시간을 표시하세요.
03

원문 오류 및 종료 코드

검색 가능한 텍스트를 복사하고 스크린샷만 업로드하지 마세요. 오류 코드, 실패 단계 및 첫 오류 전후의 로그 맥락을 보존하세요.
04

최소 재현 절차

정상 상태에서 시작해 작업, 명령, 예상 결과 및 실제 결과를 순서대로 작성하고 재현 확률도 설명하세요.
05

이미 시도한 작업

네트워크 전환, 주소 갱신, 캐시 정리 또는 작업 재시작의 시간과 결과를 나열해 같은 작업이 반복되거나 상황이 덮어써지지 않게 하세요.

ESCALATION RULES

문의 접수 규칙: 영향 대상별 분류

문의 하나에는 하나의 주요 문제만 설명하세요. 계정 접근과 노드 장애가 동시에 발생하면 별도로 기록해 처리 상태가 서로 덮어쓰이지 않게 하세요.

분류	적용 상황	권장 증거	우선 채널
계정 문제	콘솔에 들어갈 수 없거나 계정 정보 또는 접근 확인에 문제가 있음	가입 이메일, 발생 시간, 페이지 원문 오류, 브라우저 버전	지원 이메일
노드 연결 불가	노드가 연결 허용 상태로 표시되지만 브라우저 원격 데스크톱과 SSH 모두 세션을 생성할 수 없음	노드 식별자, 리전, 두 네트워크의 테스트 결과, 오류 시간 및 원문	콘솔 문의
하드웨어 이상	비정상 재시작, 스토리지 오류 또는 단일 작업으로 설명할 수 없는 리소스 이상이 지속적으로 발생	노드 식별자, 시스템 로그 시간 범위, 이상 전 작업, 재현 빈도	콘솔 문의
데이터 관련 요청	노드 해제, 데이터 내보내기 절차 또는 개인정보 권리와 관련된 요청	주문 식별자, 요청 범위, 원하는 작업, 필요한 본인 확인 정보	콘솔 문의

영향 수준 A

노드 전체에 연결할 수 없음

노드 상태가 연결을 허용하지만 신뢰할 수 있는 두 네트워크에서 테스트한 후에도 브라우저 원격 데스크톱과 SSH 모두 연결되지 않습니다. 노드 식별자, 리전 및 마지막으로 성공한 연결 시간을 제출하세요.

영향 수준 B

주요 작업이 차단됨

노드에는 연결되지만 도구 체인을 고정한 상태에서 빌드 또는 자동화 작업이 안정적으로 실패합니다. 최초 오류, 전체 명령, 종료 코드 및 최소 재현 절차를 한 번 제출하세요.

영향 수준 C

설정 및 사용 문의

노드는 사용할 수 있지만 키보드, 해상도, 종속성 캐시 또는 워크플로 최적화와 관련된 문제입니다. 현재 설정, 원하는 결과 및 이미 검증한 방법을 설명하세요.

SERVICE CONTINUITY

서비스 연속성 및 상태 판단

모든 노드는 연중 365일 정상 운영되도록 설계되었습니다. 문제가 발생하면 영향 범위에 따라 리전 네트워크 변동, 단일 노드 장애 또는 로컬 연결 문제를 구분해야 합니다.

REGION

리전 네트워크 변동

같은 지역의 여러 연결 출처에서 비슷한 시간에 지연 증가, 패킷 손실 또는 세션 끊김이 발생하지만 노드 내부 작업은 계속 실행될 수 있습니다.

출발 도시, 통신사 및 네트워크 유형 기록
신뢰할 수 있는 대체 네트워크로 비교 테스트
시작 시간, 지속 시간 및 대상 리전 제공

NODE

단일 노드 장애

로컬 네트워크와 같은 리전의 다른 서비스는 정상이나 대상 노드의 상태가 비정상이거나 반복적으로 연결이 끊기거나 사용자 작업으로 설명할 수 없는 시스템 오류가 발생합니다.

노드 식별자와 콘솔 상태 저장
상황을 변경할 수 있는 작업을 반복하지 않기
콘솔 문의에서 주문 기록 연결

LOCAL

로컬 또는 클라이언트 문제

대상 노드는 대체 네트워크나 다른 클라이언트에서 정상적으로 접속되지만 특정 사무실 네트워크 출구, 브라우저 설정 또는 SSH 클라이언트에서만 실패합니다.

실패 환경과 성공 환경의 차이 비교
프록시, 방화벽 및 클라이언트 버전 확인
네트워크 정책 문제는 로컬 관리자에게 전달

상태 설명에는 검증 가능한 사실을 사용하세요

권장 표현

“노드 SG-예시는 2026-08-08 14:20 +0800부터 SSH로 연결할 수 없습니다. 가정용 네트워크와 사무실 네트워크 모두 시간 초과가 발생했으며 콘솔 상태는 여전히 연결 허용으로 표시됩니다.”

모호한 설명은 피하세요

“서버가 고장 났다”, “네트워크가 너무 느리다” 또는 “가끔 끊긴다”라고만 쓰지 마세요. 노드, 시간, 네트워크 출처 및 원문 오류가 없으면 영향 범위를 확인할 수 없습니다.

QUICK ANSWERS

지원 요청 전 자주 묻는 질문

노드에 연결할 수 없을 때 첫 단계는 무엇인가요?

먼저 콘솔에서 노드 식별자와 상태를 확인한 다음 현재 노드 상세 정보에서 주소, 포트 및 사용자 이름을 다시 복사하세요. 이후 신뢰할 수 있는 대체 네트워크에서 비교 테스트를 진행하세요. 상태를 기록하기 전에 노드 상태를 변경하는 작업을 여러 번 연속 실행하지 마세요.

빌드 실패 시 전체 로그를 제출해야 하나요?

최초 오류 전후 최소 50줄, 전체 빌드 명령, 종료 코드, Xcode 버전 및 발생 시간을 우선 제출하세요. 전체 로그에 프로젝트 경로, 저장소 주소 또는 서명 정보가 포함되어 있다면 먼저 비식별화하세요. 오류 코드와 타임스탬프는 삭제하지 마세요.

성능 스크린샷 한 장으로는 보통 부족한 이유가 무엇인가요?

스크린샷은 한 순간만 보여 주므로 리소스 변화가 작업 전후 언제 발생했는지 판단할 수 없습니다. CPU, 메모리, 디스크 및 네트워크 지표를 5~10분 연속 기록하고 작업 시작, 이상 발생 및 종료 시간을 표시하세요.

이메일을 보내야 하나요, 콘솔 문의를 제출해야 하나요?

기존 주문, 노드, 하드웨어 및 데이터 관련 요청은 주문과 노드 기록을 연결할 수 있도록 콘솔 문의로 제출하세요. 콘솔에 들어갈 수 없는 계정 문제는 support@macworker.com으로 이메일을 보낼 수 있습니다. 본 사이트의 연락 채널은 이 두 가지뿐입니다.

문의나 이메일에 어떤 내용을 넣으면 안 되나요?

비밀번호, 개인 키, 결제 인증 정보, 전체 접속 주소 또는 프로젝트 소스 코드를 제출하지 마세요. 로그의 민감한 값은 가릴 수 있지만 필드 이름, 버전, 오류 코드, 타임스탬프 및 호출 순서는 보존하세요.

현상별 문제 해결 경로 검색

첫 연결 전에 무엇을 확인해야 하나요?

연결 시간 초과 또는 인증 실패

Xcode, 서명 또는 종속성 문제

빌드 속도 저하 또는 응답 불안정

어떤 유형의 문의를 선택해야 하나요?

리전 문제인가요, 단일 노드 장애인가요?

어떤 정보를 제출해야 가장 효과적인가요?

일치하는 페이지 경로가 없습니다

최초 사용 체크리스트: 재현 가능한 연결 기준 만들기

노드 상태 확인

로그인 정보 복사

로컬 네트워크 확인

키보드 레이아웃 설정

시간대와 시간 통일