연결 / 도구 체인 / 진단
이 가이드는 전용 물리 노드에 연결하는 방법을 설명합니다. 먼저 노드 주소와 시스템 자격 증명을 확인한 뒤 SSH, VNC, Xcode 및 CI runner를 설정하세요. 문제가 발생하면 네트워크, 인증, 시스템, 도구 체인, 스토리지 순서로 점검해 불필요한 재시도를 줄이세요.
01 / 첫 연결
네트워크를 추측하거나 시스템을 초기화하지 마세요. 콘솔의 노드 기록을 유일한 확인 기준으로 사용하고, 주소를 복사할 때 프로토콜 접두사·공백·포트 이외의 문자가 포함되지 않도록 하세요.
현재 인스턴스의 노드 ID, 리전, 호스트 주소와 연결 포트를 확인하세요. 리전은 주문 정보와 일치해야 합니다. 팀에서 네트워크 허용 목록을 사용하는 경우 클라이언트의 현재 공인 출구 IP도 기록하세요.
확인: NODE ID / HOST / REGION / PORT
계정 이름은 대소문자를 구분합니다. SSH 명령의 계정 이름, VNC 로그인 화면의 계정 이름, 콘솔 표시값이 모두 일치해야 하며 이메일 주소를 시스템 사용자 이름 대신 사용하지 마세요.
형식: username@host
처음 사용하기 전에 자격 증명이 콘솔의 최신 값인지 확인하세요. 로그인 직후 임시 비밀번호를 변경하세요. 이미 비밀번호를 변경했다면 이후 연결에는 새 값을 사용해야 하며 이전 값은 더 이상 유효하지 않습니다.
작업: 로그인 → 변경 → 안전하게 저장
macOS와 일반적인 Linux 환경에서는 터미널을 바로 사용할 수 있습니다. 먼저 포트 연결을 확인한 다음 SSH를 시작하세요. 처음 호스트 지문이 표시되면 노드 주소를 확인한 뒤 승인하세요.
권장: 연결 시간 초과 10초 / 연결 유지 30초
VNC를 지원하는 클라이언트를 준비하고 연결 대상에 올바른 포트가 포함되었는지 확인하세요. 처음에는 낮은 해상도와 자동 화질로 연결한 뒤 입력이 안정되면 화면 설정을 높이세요.
시작 설정: 1920×1080 / 24-bit / 자동 조정
02 / 용어 미니 가이드
다음 용어는 주문, 콘솔, 연결 문서와 장애 기록에 등장합니다. 각 용어는 명확한 리소스 범위 또는 기술 작업을 나타냅니다.
03 / 터미널 예시
터미널 출력은 세 가지 질문에 답할 수 있어야 합니다. 올바른 노드에 접속했는가, Xcode가 예상한 버전을 선택했는가, 빌드 산출물이 파이프라인에 전달되었는가입니다.
$ ssh -o ConnectTimeout=10 developer@node.example
Last login: Tue Mar 11 09:42:18
node: M4-Core / memory: 16GB / storage: 256GB
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ xcodebuild -workspace Demo.xcworkspace \
-scheme Demo -configuration Release build
Resolve Package Graph
CompileSwiftSources normal arm64
** BUILD SUCCEEDED **
$ bundle exec fastlane upload_build
[09:47:22]: Validating archive
[09:47:36]: Uploading artifact
[09:48:04]: Upload complete
[09:48:04]: Pipeline result: success예시의 호스트 이름은 명령 구조만 보여 줍니다. 실제 주소, 포트, 계정과 노드 ID는 콘솔 기록을 기준으로 하세요. 로그를 수집할 때는 타임스탬프와 실패한 명령을 남기고 비밀번호, 개인 키와 서명 자료는 삭제하세요.
04 / 마이그레이션 경로
전체 디렉터리를 한 번에 옮기지 마세요. 먼저 프로젝트 데이터를 이전하고 도구 체인을 재현한 뒤 CI를 연결하세요. 각 단계에 확인 가능한 완료 조건을 설정하세요.
코드 저장소, 빌드 스크립트와 필수 리소스부터 동기화하세요. 대용량 파일은 별도로 전송하고 전송 전후에 체크섬을 계산하세요. 이전 장비의 전체 캐시를 그대로 복사하지 마세요.
Xcode 주 버전, 명령줄 도구 경로, Ruby와 fastlane 버전을 명확히 확인하세요. 서명 자료는 통제된 절차로 가져오고 파일 권한과 유효 범위를 점검해야 합니다.
runner 전용 작업 디렉터리와 서비스 계정을 만드세요. 태그 매칭 범위를 제한하고 동시 실행 수를 설정한 뒤 캐시, 로그와 산출물 경로를 소스 디렉터리에서 분리하세요.
05 / 원격 데스크톱
원격 데스크톱 품질은 대역폭만으로 결정되지 않습니다. 노드 지연 시간, 해상도, 색 심도, 프레임 속도, 클라이언트 확대/축소와 백그라운드 파일 전송이 모두 입력 반응에 영향을 줍니다.
Mac 클라이언트에서 그래픽 인터페이스에 접속할 때 적합합니다. 연결 대상은 콘솔에서 제공한 호스트 주소와 포트를 사용하고 로그인 계정은 시스템 계정과 완전히 일치해야 합니다.
화면이 끊길 때는 먼저 백그라운드 동기화를 중지한 다음 원격 해상도를 낮추세요. 해상도, 색 심도와 압축 수준을 동시에 바꾸면 실제 원인을 판단하기 어렵습니다.
플랫폼을 넘나드는 접속에 적합합니다. 자동 압축을 켜고 불필요한 애니메이션을 끄세요. 화질과 색 심도를 따로 조절할 수 있다면 화질은 자동으로 유지하고 색 심도만 먼저 낮추세요.
입력 지연은 뚜렷하지만 화면이 선명하다면 먼저 클라이언트와 노드 사이의 왕복 지연 시간을 확인하세요. 고해상도는 네트워크 불안정을 해결하지 못하고 인코딩 및 전송 부담만 늘립니다.
| 사용 상태 | 해상도 시작값 | 색 심도 | 권장 대역폭 | 우선 조정 항목 |
|---|---|---|---|---|
| 터미널 및 가벼운 편집 | 1600×900 | 16-bit | ≥ 8 Mbps | 동적 화면 줄이기 |
| Xcode 코딩 및 디버깅 | 1920×1080 | 24-bit | ≥ 15 Mbps | 낮은 지연 시간의 연결 유지 |
| 다중 창 개발 | 2560×1440 | 24-bit | ≥ 25 Mbps | 먼저 안정성 확인 |
| 화면 변화가 잦음 | 1920×1080 | 24-bit | ≥ 30 Mbps | 프레임 속도 또는 화질 낮추기 |
대역폭 수치는 설정 시작점일 뿐 지연 시간의 결론이 아닙니다. 원격 데스크톱을 주로 개발과 관리에 사용할 경우 클라이언트와 가까운 노드를 우선 선택하고 실제 네트워크 환경에서 확인하세요.
06 / CI/CD
CI 연결 완료의 기준은 한 번의 성공 결과가 아닙니다. 작업 디렉터리를 정리한 뒤에도 동일한 커밋을 반복 빌드할 수 있고, 실패 시 충분한 로그가 남아야 합니다.
07 / 진단 트리
한 번에 하나의 변수만 변경하고 시점, 명령, 반환값과 클라이언트 네트워크를 기록하세요. 연결 버튼을 반복해서 누르는 것만으로는 유용한 정보가 늘어나지 않습니다.
08 / 보안 운영
전용 물리 서버는 명확한 리소스 경계를 제공하지만 노드 내부의 계정, 키, 프로젝트 파일과 접속 출처는 팀이 최소 권한 원칙에 따라 관리해야 합니다.
첫 로그인 후 즉시 새 고강도 비밀번호를 설정하고 팀이 승인한 자격 증명 관리 도구에 저장하세요. 빌드 로그나 일반 문서로 비밀번호를 전달하지 마세요.
SSH와 VNC의 노출 범위를 실제로 필요한 팀 출구 IP로 제한하세요. 구성원의 네트워크가 바뀌면 규칙을 업데이트하고 임시 테스트 출처를 계속 허용하지 마세요.
일상적인 빌드, 원격 작업과 runner 서비스에는 역할이 명확한 계정을 각각 사용하세요. 설치나 시스템 설정 때만 일시적으로 권한을 높이고 완료 후 즉시 권한을 해제하세요.
마이그레이션, 문제 해결 또는 외부 협업이 끝나면 임시 공개 키, 단기 토큰과 테스트 계정을 삭제하세요. 자동화 스크립트가 이전 자격 증명을 계속 참조하는지도 확인하세요.
09 / 지원 요청
기술 문제는 인스턴스와 연결하고 로그를 계속 추가할 수 있도록 콘솔 티켓으로 제출하는 것이 좋습니다. 콘솔에 접속할 수 없거나 구매 전 확인이 필요한 경우 이메일을 보내세요.
콘솔에 로그인한 뒤 티켓 영역에서 새 기술 지원 요청을 만들고 해당 노드를 연결하세요. 티켓 하나에는 주요 문제 하나만 다뤄 관련 없는 오류를 한 기록에 섞지 마세요.
이메일 제목은 “문제 유형 + 노드 ID 또는 주문 식별자” 형식을 권장합니다. 본문에는 완료한 점검 내용을 시간순으로 작성하고 비밀번호, 개인 키 또는 비식별화하지 않은 서명 자료는 보내지 마세요.
연결 준비 완료
노드 주소, 시스템 계정과 현재 자격 증명을 먼저 복사하고 SSH 확인을 한 번 완료한 뒤 원격 Mac 데스크톱에 접속하세요. 새 전용 물리 서버가 필요하면 고정 모델과 임대 기간별 가격을 바로 확인할 수 있습니다.