노드 운영 지원

장애 계층을 먼저 식별한 다음 다음 명령을 실행하세요

전용 Apple Silicon 물리 노드의 연결, 빌드, 러너, 네트워크 및 스토리지 문제 해결 경로를 한곳에 정리했습니다. 각 단계에서 점검 대상과 명령, 다음 판단에 활용할 결과를 안내합니다.

노드가 이미 있다면 먼저 노드 번호와 문제가 발생한 시간 범위를 기록하세요. 아직 주문하지 않았다면 판매 중인 세 가지 구성과 선택 가능한 네 개 노드를 먼저 확인할 수 있습니다.

클라우드 Mac 지금 대여 콘솔에 로그인해 지원 티켓 제출
RUNBOOK / NODE CHECK L0—L4
L0
노드 상태 노드 번호, 리전 및 콘솔 반환 상태 확인
먼저 확인
L1
연결 경로 주소, 포트, 키 권한 및 호스트 지문
SSH
L2
도구 체인 Xcode, 서명 자료, Keychain 및 빌드 로그
BUILD
L3
작업 실행 러너 프로세스, 작업 디렉터리, 캐시 및 동시 작업
CI
L4
하드웨어 경로 디스크 여유 공간, 외장 SSD, 네트워크 및 Thunderbolt 5
I/O
지원 티켓에 필요한 최소 정보 노드 번호 + 시간 범위 + 명령 출력
점검 시작점 선택

장애가 발생한 위치에 따라 분기하세요

여러 계층의 설정을 동시에 변경하지 마세요. 현상에 가장 가까운 유형을 선택해 기본 점검을 완료한 후, 결과를 바탕으로 다음 계층으로 이동하세요.

연결 문제

SSH 또는 그래픽 데스크톱에 접속할 수 없음

주소, 포트, 키 권한, 호스트 지문 및 자격 증명 유효성부터 확인하세요. SSH에는 연결되지만 그래픽 세션에 문제가 있다면 해상도, 잠금 상태 및 세션 복구를 점검하세요.

연결 문제 해결 시작
빌드 문제

Xcode, 서명 또는 파이프라인 실패

먼저 Xcode 버전을 고정하고 원본 로그를 저장한 다음 서명 ID, 프로비저닝 프로파일, Keychain 권한, DerivedData 및 러너 작업 디렉터리를 확인하세요.

빌드 문제 해결 시작
계정 및 주문

갱신, 청구 또는 노드 정보에 관한 문의

콘솔에서 주문 번호, 대여 기간, 노드 번호 및 결제 상태를 확인하세요. 지원 티켓에 키 원문이나 전체 결제 자격 증명을 제출하지 마세요.

콘솔로 이동
하드웨어 및 네트워크

디스크, 대역폭 또는 외장 장치 이상

디스크 여유 공간, 볼륨 이름, 네트워크 품질 및 Thunderbolt 장치 트리를 기록하세요. 백업 없이 디스크를 포맷하거나 볼륨을 재구성하지 마세요.

하드웨어 문제 해결 시작
SSH 빠른 진단

로컬 권한과 핸드셰이크부터 확인하세요

연결 실패가 반드시 노드 오프라인을 의미하는 것은 아닙니다. 주소 오류, 포트 연결 불가, 로컬 키 권한 문제, 호스트 지문 변경 및 서버 인증 거부를 먼저 구분하세요.

연결 점검 명령 SSH / VERBOSE 
$ chmod 600 ~/.ssh/orbvps_node
$ ssh-keygen -F node-address
$ nc -vz node-address 22
$ ssh -vvv -p 22 \
  -i ~/.ssh/orbvps_node \
  node-user@node-address
Permission denied
인증 자료 불일치

사용자 이름과 개인 키가 현재 노드에 해당하는지 확인하고, 로컬 SSH 설정의 다른 IdentityFile이 키를 덮어쓰고 있지 않은지 점검하세요.

Connection timed out
연결이 설정되지 않음

콘솔에 표시된 주소와 포트를 확인하고 로컬 프록시 규칙을 일시적으로 비활성화한 뒤 다시 테스트하세요. 발생 시간과 접속한 네트워크도 기록하세요.

Connection refused
대상에는 도달했지만 포트가 연결을 수락하지 않음

전체 verbose 출력을 보관하고 호스트 기록을 반복해서 삭제하지 마세요. 먼저 포트가 노드 제공 정보와 일치하는지 확인하세요.

REMOTE HOST IDENTIFICATION
호스트 지문이 로컬 기록과 다름

경고를 바로 무시하지 마세요. 표시된 지문을 먼저 콘솔의 제공 기록과 대조하고, 노드 정보를 확인한 후 로컬 기록을 업데이트하세요.

01

연결 매개변수 확인

콘솔에서 주소, 포트 및 사용자 이름을 다시 확인하고 이전 터미널 기록의 주소를 추측해 사용하지 마세요.

02

키 권한 제한

개인 키는 현재 사용자만 읽고 쓸 수 있도록 설정하는 것이 좋으며, SSH 설정과 상위 디렉터리도 관계없는 사용자가 수정할 수 없어야 합니다.

03

핸드셰이크 출력 저장

verbose 모드로 한 번 다시 시도하고 연결 시작부터 실패 지점까지의 전체 출력을 저장한 뒤 주소의 민감 정보를 제거하세요.

그래픽 데스크톱 연결

자격 증명, 디스플레이, 잠금, 재연결 순서로 처리하세요

그래픽 세션과 SSH는 서로 다른 연결 경로입니다. SSH가 정상이어도 그래픽 세션 설정이 정상이라는 뜻은 아니므로 현상을 각각 기록해야 합니다.

01

자격 증명 대상 확인

현재 노드에서 제공된 그래픽 세션 자격 증명만 사용하세요. 자격 증명을 교체한 후에는 클라이언트에 저장된 이전 비밀번호를 삭제해 오래된 기록이 계속 자동 재시도되지 않도록 하세요.

02

첫 연결 시 해상도 낮추기

검은 화면이나 화면 정지가 발생하면 먼저 낮은 해상도와 단일 디스플레이로 연결하세요. 데스크톱에 진입한 후 해상도를 단계적으로 높여 디스플레이 설정과 관련된 문제인지 확인하세요.

03

세션 잠금 상태 확인

잠금 화면은 보이지만 진행할 수 없다면 먼저 키보드 입력과 포커스를 확인한 후 SSH로 시스템 부하와 남은 디스크 공간을 점검하세요.

04

연결을 끊고 세션 다시 설정

먼저 클라이언트 연결을 정상적으로 종료하고 세션이 해제될 때까지 기다린 다음 다시 연결하세요. 사용 중인 데스크톱을 혼동하지 않도록 여러 그래픽 세션을 빠르게 동시에 만들지 마세요.

지원 요청 시 두 가지 결과를 기록하세요

SSH가 정상인지, 그래픽 클라이언트가 어느 단계에서 멈췄는지, 사용한 해상도, 클라이언트 오류 원문 및 마지막으로 정상 연결된 시간 범위를 알려 주세요. 전체 접속 비밀번호는 제출하지 마세요.

Xcode 및 서명

도구 체인을 고정한 뒤 서명 실패 범위를 좁히세요

먼저 실제로 호출된 Xcode 경로와 버전을 확인한 다음 사용 가능한 서명 ID, 프로비저닝 프로파일, Keychain 접근 권한 및 프로젝트 캐시를 점검하세요. 한 번의 점검에서 종속성을 업그레이드하면서 서명 자료도 변경하지 마세요.

도구 체인

Xcode 및 명령줄 도구 확인

  • 다음의 전체 결과를 저장하세요: xcodebuild -version 。
  • 다음 명령으로 xcode-select -p 현재 Developer 디렉터리를 확인하세요.
  • 파이프라인과 대화형 터미널이 동일한 환경 변수를 사용하는지 확인하세요.
서명 자료

ID와 프로비저닝 프로파일을 분리해 점검하세요

  • 현재 코드 서명에 사용할 수 있는 ID와 유효 상태를 나열하세요.
  • 프로비저닝 프로파일의 앱 ID, 팀 및 유효 기간을 확인하세요.
  • 빌드 프로세스가 해당 Keychain을 읽을 수 있는지 확인하세요. 현재 데스크톱 사용자에게 보이는 것만으로는 충분하지 않습니다.
캐시 및 로그

재현 가능한 클린 기준선 구축

  • 먼저 실패 로그를 저장한 다음 대상 프로젝트에 해당하는 DerivedData를 정리하세요.
  • 동일한 scheme, configuration 및 destination으로 다시 실행하세요.
  • 원본 .xcresult를 보관하세요. 터미널의 마지막 몇 줄만 제출하지 마세요.
서명 및 버전 점검 XCODE / CODESIGN 
$ xcode-select -p
$ xcodebuild -version
$ security find-identity \
  -v -p codesigning
$ profiles show \
  -type provisioning
$ xcodebuild \
  -workspace App.xcworkspace \
  -scheme App \
  -configuration Release \
  -resultBundlePath Build.xcresult \
  build
로그 범위

명령, scheme, configuration, 실패한 대상, 첫 번째 error 및 관련 맥락을 보관하세요. 제출 전에 저장소 자격 증명, 토큰 및 업무 데이터를 제거하세요.

CI/CD 러너

문제가 프로세스, 디렉터리 또는 리소스 중 어디에서 멈췄는지 확인하세요

self-hosted runner가 온라인으로 표시된다고 작업 환경이 완전한 것은 아닙니다. 러너 프로세스, 작업 디렉터리 권한, 캐시 사용량, 동시 작업 및 재시작 후 자동 복구 경로를 점검하세요.

A

프로세스 상태

러너 서비스가 예상 사용자로 계속 실행 중이며 시작 매개변수가 올바른 설정을 가리키는지 확인하세요. 프로세스가 반복 종료되면 먼저 종료 코드와 최근 로그를 저장하세요.

ps aux | grep -i runner
B

작업 디렉터리

디렉터리 소유자, 남은 공간 및 이전 작업의 잠금 파일을 확인하세요. 실행 중인 작업이 사용 중인 작업 디렉터리를 바로 삭제하지 마세요.

df -h && du -sh ./work
C

캐시 전략

종속성 캐시, DerivedData 및 빌드 산출물을 구분하세요. 먼저 비정상 캐시 키를 찾아 프로젝트 단위로 정리하고, 재사용 가능한 모든 콘텐츠를 한 번에 삭제하지 마세요.

du -sh ~/Library/Developer/Xcode/DerivedData
D

동시 실행 및 복구

여러 작업이 동일한 Keychain, 시뮬레이터 또는 작업 디렉터리를 함께 사용하고 있지 않은지 확인하세요. 재시작 후에는 통제된 테스트 작업 하나를 먼저 실행한 다음 정상 대기열을 재개하세요.

uptime && sysctl -n hw.memsize
복구 순서 새 작업 일시 중지 → 로그 저장 → 비정상 프로세스 종료 → 디렉터리 확인 → 러너 시작 → 단일 작업 테스트 실행

테스트 작업은 성공하지만 동시 작업이 실패한다면 동시 실행 수, 작업 태그 및 공유 리소스 목록을 함께 제공하세요.

네트워크 및 스토리지

연결 품질, 디스크 용량 및 장치 인식을 পৃথ개별적으로 확인하세요

처리량 저하, 빌드 지연 및 외장 볼륨 사라짐은 비슷하게 나타날 수 있습니다. 먼저 시스템 내장 진단 결과를 수집한 후 네트워크, 파일 시스템 또는 외장 장치 경로의 문제인지 판단하세요.

네트워크

기본 연결 품질 확인

시스템 내장 네트워크 품질 도구로 업로드·다운로드 성능과 응답성을 기록하고 테스트 시간 범위도 함께 남기세요. 리전 간 결과는 현지 통신사와 경로의 영향을 받을 수 있습니다.

networkQuality -v
route -n get default
ifconfig
내부 스토리지

용량 및 볼륨 상태 확인

먼저 시스템 볼륨과 데이터 볼륨의 남은 공간을 확인한 다음 가장 많은 공간을 사용하는 작업 디렉터리를 찾으세요. 빌드 실패 시 임시 디렉터리와 DerivedData를 특히 점검해야 합니다.

df -h
diskutil list
du -sh ~/Library/Developer/*
외장 장치

SSD 및 Thunderbolt 5 경로 확인

디스크 목록과 Thunderbolt 장치 트리를 각각 확인하세요. 장치는 보이지만 볼륨이 마운트되지 않았다면 먼저 상태를 수집하고 즉시 지우거나 다시 파티션하지 마세요.

diskutil list external
system_profiler SPThunderboltDataType
diskutil info /Volumes/VolumeName
업그레이드 및 운영 변경

먼저 롤백 기준선을 남긴 후 재시작을 계획하세요

OrbVPS 노드는 연중무휴 365일 정상 운영됩니다. 시스템 업그레이드, 도구 체인 전환 또는 재시작이 필요한 작업은 사용자가 워크로드에 맞춰 직접 일정을 정하세요. 인프라에 긴급 변경이 필요한 경우 관련 정보는 콘솔에 기록됩니다.

01

변경 목록 작성

현재 macOS, Xcode, 러너 버전, 주요 종속성 및 롤백 가능한 빌드 로그를 기록하세요. 기준선 없이 도구 체인을 바로 덮어쓰지 마세요.

02

데이터 백업 완료

저장소, 서명 자료, 러너 설정, 캐시 정책 및 필요한 빌드 산출물을 백업하고 별도 위치에서 백업을 읽을 수 있는지 확인하세요.

03

사용자 측 재시작 시간 예약

새 작업을 일시 중지하고 실행 중인 작업이 끝날 때까지 기다린 후 로그를 저장하고 재시작하세요. 재시작 중 네트워크, 서명 및 빌드 설정을 동시에 변경하지 마세요.

04

복구 검증 실행

SSH, 그래픽 데스크톱, 디스크 마운트, Xcode 버전 및 통제된 빌드 작업 하나를 순서대로 확인한 후 정상 동시 실행 대기열을 재개하세요.

여전히 원인을 찾을 수 없음

재현 가능한 증거를 지원팀에 전달하세요

노드 번호, 문제 발생 시간 범위, 영향을 받은 작업, 실행한 명령, 원본 출력 및 민감 정보가 제거된 스크린샷을 준비하세요. 주문을 완료한 사용자는 콘솔에서 지원 티켓을 제출해야 합니다. 구매 전 구성 또는 리전 문의는 문의 페이지를 통해 support@orbvps.com으로 보내실 수 있습니다.

콘솔에 로그인해 지원 티켓 제출 문의 경로 보기