이 페이지에서는 실제 접속 순서에 따라 원격 데스크톱, SSH, 코드 저장소, 자체 호스팅 Runner와 파일 전송을 안내합니다. 먼저 노드와 자격 증명을 확인한 뒤 클라이언트 설정을 점검하세요. 문제가 발생하면 증상별로 단계적으로 진단하고, 강제 전원 종료를 일반적인 해결 방법으로 사용하지 마세요.
접속 주소, 계정명, 임시 자격 증명과 노드 코드가 같은 주문에 해당하는지 확인합니다.
먼저 하나의 클라이언트로 연결해 여러 기기의 동시 접속과 오래된 캐시의 영향을 배제합니다.
처음 접속한 즉시 변경하고 새 자격 증명을 팀에서 승인한 보안 보관 도구에 저장합니다.
SSH 공개 키를 등록하고 Xcode 명령줄 도구를 확인한 다음 자동화 Runner를 등록합니다.
주문 알림 이메일과 콘솔에는 동일한 인수인계 정보가 표시됩니다. 연결하기 전에 주문 번호, 노드 코드, 접속 주소와 계정명을 확인하세요. 두 곳의 내용이 다르면 이전 주소를 반복해서 시도하지 말고 콘솔에서 바로 지원 요청을 제출하세요.
전체 그래픽 인터페이스, Xcode 프로젝트 작업 또는 제작 소프트웨어가 필요할 때는 원격 데스크톱을 사용하세요. 스크립트 실행, 빌드 상태 확인 또는 소량의 파일 전송만 할 때는 SSH를 우선 사용합니다. 불필요한 그래픽 세션을 줄이면 불안정한 네트워크에서의 조작 부담을 낮출 수 있습니다.
| 접속 방식 | 적합한 작업 | 접속 전 준비 | 클라이언트 매개변수 | 세션 종료 |
|---|---|---|---|---|
| VNC 원격 데스크톱 | Xcode 그래픽 인터페이스, 시뮬레이터 확인, Logic Pro, Final Cut Pro 및 일반적인 데스크톱 작업 | 접속 주소, 포트, 계정명과 현재 자격 증명을 확인하고 같은 계정의 중복 세션을 종료합니다. | 먼저 적응형 화질과 시스템 해상도를 사용하세요. 네트워크가 불안정하면 색상 품질과 프레임 속도를 단계적으로 낮춥니다. | 프로젝트를 저장하고 애플리케이션을 종료한 다음 시스템 세션에서 정상적으로 로그아웃하세요. 파일을 쓰는 작업을 바로 종료하지 마세요. |
| macOS 시스템 수준 원격 접속 | 팀에서 통일한 클라이언트, 고정 해상도 작업 환경 및 장시간 데스크톱 작업 | 클라이언트가 대상 프로토콜을 지원하는지 확인하고 필요한 네트워크 포트가 로컬 방화벽을 통과하도록 허용합니다. | 호스트명에는 제공된 주소를 입력하고 계정명은 원문 그대로 유지하세요. 처음 연결할 때 호스트 안내 정보를 확인합니다. | 먼저 내보내기, 압축 또는 동기화 작업을 중지한 뒤 로그아웃하세요. 클라이언트 창만 닫는 것은 백그라운드 프로세스 종료를 의미하지 않습니다. |
| SSH 명령줄 | 저장소 작업, 빌드 스크립트, Runner 관리, 로그 확인 및 자동화 작업 | 공개 키를 등록하고 개인 키는 관리되는 단말에만 보관하며 노드 호스트 지문을 기록합니다. | 사용자 이름, 호스트 주소와 포트를 명확히 지정하세요. 자동화 스크립트에는 적절한 시간 제한과 종료 코드 확인을 설정합니다. | 대화형 세션을 종료하기 전에 포그라운드 작업이 끝났는지 확인하세요. 장시간 작업은 관리되는 프로세스 또는 Runner에 맡깁니다. |
세션 종료 순서:파일을 저장하고 파일 쓰기 작업을 중지한 뒤 애플리케이션을 종료하고 데스크톱 세션에서 로그아웃합니다. 백그라운드 빌드를 계속 실행해야 한다면 열린 데스크톱 창에 의존하지 말고 Runner 또는 관리되는 프로세스가 이어서 실행하도록 하세요.
개인 원격 데스크톱 계정, SSH 키와 CI/CD Runner가 하나의 장기 자격 증명을 공유해서는 안 됩니다. 권한을 각각 설정하면 빌드 실패 원인을 쉽게 찾을 수 있고 구성원이 변경될 때 해당 접근 권한만 취소할 수 있습니다.
관리되는 작업 기기에서 새 키를 생성하거나 기존 키를 선택해 공개 키를 대상 계정의 인증 목록에 추가하세요. 개인 키는 노드에 업로드하거나 이메일로 보내거나 지원 요청에 붙여넣지 마세요.
ssh -i ~/.ssh/team_build user@assigned-host현재 저장소에만 적용되는 접근 토큰 또는 배포 키를 우선 사용하세요. 처음 가져온 뒤 원격 주소를 확인해 민감한 매개변수가 포함된 URL이 셸 기록이나 빌드 출력에 남지 않도록 하세요.
git clone <repository-url>
git remote -v현재 도구 체인의 경로와 버전이 프로젝트 요구 사항에 맞는지 확인하세요. 버전을 변경한 뒤 검사를 다시 실행하고, 팀 문서의 예상값만 믿지 말고 빌드 스크립트에서 실제 사용 중인 도구 체인을 출력하게 하세요.
xcode-select -p
xcodebuild -version
swift --version칩, 노드와 작업 유형을 나타내는 명확한 태그를 Runner에 지정하세요. 단일 머신의 동시 실행 수를 제한하고 작업 디렉터리 정리 정책을 설정하며, 구성원이 떠나거나 프로젝트가 끝나면 등록 토큰을 취소합니다.
./config.sh --labels apple-silicon,macos,build
./run.sh프로젝트 파일, 캐시와 빌드 산출물은 용도별로 다른 디렉터리에 저장하세요. 작업 영역과 임시 캐시를 섞으면 디스크 공간 문제를 파악하기 어려워지고 정리 중 프로젝트 파일을 실수로 삭제할 위험도 커집니다.
네트워크, 클라이언트, 자격 증명과 노드 매개변수를 동시에 바꾸지 마세요. 매 라운드마다 한 가지 항목만 변경하고 시간, 오류 문구와 결과를 기록하세요. 그러면 지원 요청을 제출할 때 지원 담당자가 이미 확인된 단계부터 바로 이어서 진행할 수 있습니다.
먼저 로컬 네트워크에서 다른 HTTPS 서비스에 접속할 수 있는지 확인한 뒤 호스트 주소와 포트를 다시 확인하세요. 프록시 또는 기업 네트워크 정책을 끄고 비교 테스트를 한 번 진행하며, 클라이언트가 오래된 세션 캐시를 계속 사용하지 않는지 확인합니다.
해상도, 색상 품질과 프레임 속도를 낮추고 대용량 업로드를 일시 중지한 뒤 유선 네트워크와 무선 네트워크 결과를 비교하세요. SSH 응답은 정상인데 데스크톱 지연이 뚜렷하다면 그래픽 인코딩과 클라이언트 설정을 먼저 확인합니다.
계정명의 대소문자와 붙여넣은 공백을 확인하고 처음 제공된 임시 값을 아직 사용 중인지 점검하세요. 짧은 시간에 반복해서 시도하지 말고 콘솔에서 주문 상태를 확인한 뒤 지원 요청을 제출해 계정 상태를 확인받으세요.
작업 영역, 빌드 캐시, 시뮬레이터 데이터, 아카이브 파일과 다운로드 디렉터리를 각각 확인하세요. 보존할 산출물을 먼저 옮긴 뒤 다시 생성할 수 있는 캐시를 정리하고 출처가 불분명한 시스템 디렉터리를 바로 삭제하지 마세요.
종료 코드와 실패 단계를 보존하고 Runner 서비스, 도구 체인 경로, 남은 디스크 공간과 저장소 권한을 확인하세요. 같은 커밋으로 최소 작업을 한 번 다시 실행한 뒤 환경 문제인지 프로젝트 스크립트 문제인지 판단합니다.
모든 노드는 연중 365일 정상적으로 실행됩니다. 시스템 업데이트, 프로젝트 의존성 변경과 사용자가 요청한 재시작은 팀이 작업 상태에 따라 진행해야 합니다. 노드가 완전히 응답하지 않을 때는 지원 담당자가 노드를 점검합니다.
Runner가 새 작업을 받지 않도록 중지하고 쓰기 작업이 끝날 때까지 기다린 뒤 데스크톱 프로젝트를 저장하고 macOS에서 정상적으로 재시작하세요. 다시 연결한 후 시간, 네트워크, 디스크와 빌드 서비스를 확인합니다.
SSH에 계속 연결할 수 있다면 바로 전원을 끄지 마세요. 먼저 원격 데스크톱 프로세스, 디스크 공간과 시스템 부하를 확인하고 마지막으로 정상 종료된 세션 시간을 기록합니다.
주문 번호, 노드 코드, 발생 시간과 네트워크 비교 결과를 제출하세요. 지원 담당자가 먼저 노드 전원, 네트워크와 시스템 상태를 확인한 뒤 복구 작업이 필요한지 판단합니다.
파일 시스템에 데이터를 쓰거나 빌드 산출물을 보관하거나 캐시 데이터베이스를 업데이트하는 중에 전원을 반복해서 끄면 문제가 커질 수 있습니다. 작업 후에는 상태 응답을 기다리고 작업 시간을 기록하세요.
콘솔 티켓은 주문과 관련된 연결, 노드 및 결제 문제에 적합하고 이메일은 아직 주문하지 않은 구성 문의에 적합합니다. 두 채널 모두 개인 키, 전체 접속 자격 증명 또는 비식별화되지 않은 업무 데이터를 제출하지 마세요.
두 가지 구성, 여섯 개 노드와 모든 이용 기간별 가격이 공개되어 있습니다. 주문 전에 작업 메모리, 스토리지 증설과 접속 지역을 기준으로 선택할 수 있습니다.