SSH 터미널
프로젝트 체크아웃, 종속성 확인, xcodebuild실행, 로그 확인, macOS CI 러너 연결에 적합합니다.
- 로컬에 SSH 클라이언트를 준비하고 권한이 부여된 계정을 사용하세요.
- 처음 접속할 때 호스트 지문을 확인하고 인증 절차를 건너뛰지 마세요.
접속 가이드
클라우드 Mac에 접속하고 작업에 맞는 터미널 또는 데스크톱을 선택하세요.
빌드 스크립트를 실행하려면 SSH를, Xcode 그래픽 인터페이스를 확인하려면 원격 데스크톱을 사용하세요. UDPMac은 전용 물리 Mac을 제공하며, 접속 주소와 계정 권한, 사용 가능한 방식은 콘솔에 표시된 정보를 따릅니다.
이미 인스턴스가 있나요? 먼저콘솔에서 기기 상태와 접속 정보를 확인한 다음 아래 단계에 따라 진행하세요.
접속 방식 선택
작업 흐름
01
명령 실행 및 CI 작업SSH · 터미널, 스크립트, 빌드 로그
02
macOS 데스크톱 확인VNC · 그래픽 작업 및 디스플레이 확인
03
Xcode 프로젝트 확인프로젝트 열기 → 툴체인 확인 → 테스트 빌드
이 안내는 작업 순서만 설명하며 인스턴스 상태나 실제 접속 정보를 표시하지 않습니다.
접속 방식 선택
작업에 맞는 접속 방식을 선택하세요.
터미널과 그래픽 데스크톱은 각각 용도가 다릅니다. 자동화 스크립트를 실행할 때 데스크톱 세션을 계속 열어 둘 필요는 없고, 화면으로 확인해야 하는 Xcode 작업을 터미널로 대신할 필요도 없습니다.
VNC 원격 데스크톱
macOS 그래픽 인터페이스 확인, 디스플레이 설정 점검, 데스크톱에서만 가능한 작업에 적합합니다.
- 콘솔에 표시된 접속 정보와 승인된 클라이언트를 사용하세요.
- 공용 기기에는 접속 주소 외의 인증 정보를 저장하지 마세요.
Xcode 그래픽 작업 흐름
먼저 원격 데스크톱에서 프로젝트를 열고 Xcode 버전, 프로젝트 설정, 서명에 필요한 항목을 확인한 뒤 테스트 빌드를 실행하세요.
- 프로젝트 호환 여부는 종속성, 툴체인, 설정에 따라 달라집니다.
- 빌드 결과는 실제 출력과 로그를 기준으로 확인하세요.
접속 전 확인
접속 정보를 입력하기 전에 네 가지 항목을 확인하세요.
비밀번호, 개인 키, 서명 인증서 또는 전체 접속 정보를 공개 페이지나 채팅 기록, 장애 화면 캡처에 붙여 넣지 마세요.
01기기 상태
콘솔에서 인스턴스가 준비되었는지 확인하고 현재 주문의 모델과 노드를 확인하세요. 다른 기기의 이전 주소를 사용하지 마세요.
02계정 권한
해당 인스턴스에 권한이 부여된 계정을 사용하고 있는지 확인하세요. 팀 내 역할이 나뉘어 있다면 로그인 권한과 툴체인 또는 프로젝트 파일 수정 권한을 먼저 확인하세요.
03네트워크 연결
로컬 네트워크와 접속에 필요한 대상 포트에 연결할 수 있는지 확인하세요. 시간 초과가 발생하면 네트워크 문제와 인증 실패를 구분하세요.
04로컬 클라이언트
SSH 작업에는 터미널 클라이언트를, 데스크톱 작업에는 호환되는 VNC 클라이언트를 준비하고 로컬 기기에서 해당 연결을 허용하는지 확인하세요.
SSH 접속 순서
세션을 연결하고 호스트를 확인한 뒤 명령을 실행하세요.
아래 호스트명과 사용자 이름은 명령어 구조를 설명하기 위한 예시입니다. 실제 주소, 계정, 인증 정보는 콘솔에서 확인하세요.
01
접속 정보를 확인하고 연결 시작
콘솔에서 호스트, 계정, 필요한 인증 방식을 확인하고 예시의 자리 표시자를 해당 인스턴스 정보로 바꾸세요. 다른 인스턴스의 접속 기록을 재사용하지 마세요.
02
첫 접속 시 호스트 확인
처음 접속할 때 호스트 지문이 표시되면 신뢰할 수 있는 인스턴스 정보와 대조한 뒤 진행하세요. 지문이 확인된 기록과 다르면 접속을 중단하고 원인을 확인하세요.
03
작업을 실행하고 로그아웃
현재 디렉터리, Xcode 툴체인, 디스크 공간을 확인한 다음 프로젝트 명령을 실행하세요. 필요한 산출물과 로그를 저장한 뒤 exit 를 입력해 세션을 종료하세요.
명령어 구조 예시실제 인증 정보 아님
ssh USER@HOST.example.invalid
xcode-select -p
xcodebuild -version
exit예시 도메인으로는 접속할 수 없습니다. 프로젝트 빌드 명령, 작업 디렉터리, 서명 설정은 실제 프로젝트에 맞게 확인하세요. 이 예시만으로 설정을 추정하지 마세요.
그래픽 데스크톱
네 단계로 원격 데스크톱 세션을 시작하세요.
그래픽 작업이 필요할 때만 데스크톱 세션을 시작하세요. SSH와 VNC의 접속 정보는 다를 수 있으니 각각 콘솔에 표시된 내용을 확인하세요.
01접속 정보 확인
인스턴스가 준비되었는지 확인한 뒤 콘솔에서 해당 기기의 원격 데스크톱 주소, 접속 방식, 계정 요건을 확인하세요. 오래된 이메일이나 다른 사람의 화면 캡처에 있는 인증 정보를 옮겨 적지 마세요.
02세션 연결
로컬 VNC 클라이언트에 해당 접속 정보를 입력하세요. 인증이 필요하면 권한이 부여된 정보를 사용하세요. 오류를 우회하려고 클라이언트의 연결 보안 경고를 끄지 마세요.
03디스플레이 조정
연결한 뒤 화면 크기에 맞게 배율이나 해상도를 조정하세요. 프로젝트나 시스템 설정을 변경하기 전에 입력 포커스와 키보드 레이아웃을 확인하세요.
04안전하게 로그아웃
작업을 저장하고 민감한 데이터가 있는 창을 닫은 뒤 클라이언트에서 연결을 끊으세요. 공용 기기에 인증 정보를 저장하지 마세요.
Xcode 점검 목록
첫 그래픽 빌드의 결과를 항목별로 확인 가능하게 기록하세요.
클라우드 Mac은 실행 환경을 제공하지만 프로젝트가 별도 수정 없이 빌드된다는 뜻은 아닙니다. 먼저 범위를 좁혀 테스트한 뒤 일상적인 빌드에 연결할 방법을 정하세요.
올바른 프로젝트 열기
프로젝트를 체크아웃하거나 가져온 뒤 브랜치, 종속성 파일, 프로젝트 진입점이 일치하는지 확인하세요. 누락된 종속성과 처음 열 때 표시되는 설정 안내를 기록하고, 메인 브랜치에서 바로 수정하지 마세요.
점검 완료: 프로젝트와 예상한 브랜치를 확인했습니다.
버전 및 권한 확인
Xcode 버전, 선택한 명령줄 도구, 프로젝트 대상 설정을 확인하세요. 빌드에 서명 자료가 필요하다면 팀의 보안 절차에 따라 보관하고 권한을 부여하세요. 해당 자료를 로그에 남기지 마세요.
점검 완료: 툴체인과 빌드 대상을 기록했습니다.
테스트 빌드 실행
명확한 대상을 지정해 빌드를 시작하고 실패 단계, 주요 오류, 산출물 위치를 기록하세요. 출력을 확인한 뒤에야 종속성, 설정, 접속 중 무엇을 해결할지 판단할 수 있습니다.
점검 완료: 결과와 민감 정보를 제거한 로그를 다시 확인할 수 있습니다.
접속 문제 해결
먼저 어느 단계에서 실패했는지 확인하세요.
팀에 문제를 알릴 때 발생 시각, 접속 방식, 인스턴스 주문 식별자, 민감 정보를 가린 오류 메시지를 기록하세요. 전체 인증 정보나 프로젝트 기밀이 포함된 화면 캡처는 보내지 마세요.
| 증상 | 먼저 확인할 항목 | 기록할 내용 |
|---|---|---|
| 인증 실패 | 계정, 인증 방식, 인스턴스가 서로 일치하는지 확인하세요. 첫 접속이라면 호스트 신원 안내도 확인하세요. | 클라이언트 오류 원문, 접속 방식. 사용자 이름 외의 민감한 정보는 가리세요. |
| 접속 시간 초과 | 인스턴스 상태, 로컬 네트워크, 대상 주소, 접속에 필요한 포트를 확인하고 시간 초과와 비밀번호 오류를 구분하세요. | 발생 시각, 선택한 노드, 네트워크 환경, 시간 초과가 발생한 단계. |
| 화면 지연 | 로컬 네트워크의 안정성을 확인하고 원격 데스크톱의 화면 처리 부하를 낮춰 보세요. 터미널 작업에도 영향이 있는지 확인하세요. | 발생 시각, 클라이언트 디스플레이 설정, 재현 가능한 작업. |
| 세션 연결 끊김 | 로컬 네트워크 변경, 클라이언트 안내, 인스턴스 상태를 확인하세요. 다시 연결하기 전에 진행 중이던 파일 작업이 없는지 확인하세요. | 끊기기 전 마지막 작업, 클라이언트 안내, 재접속 결과. |
마무리 점검
연결을 끊는 것만으로 인계가 끝나지는 않습니다.
SSH 또는 원격 데스크톱 세션을 종료한 뒤 계정, 작업 파일, 이후 접속 계획을 확인하세요. 대여 기간이 끝나기 전에 팀에서 보관할 프로젝트 데이터와 빌드 산출물을 내보내세요.
계정 확인
불필요한 활성 세션이나 임시 권한이 남아 있는지 확인하고 팀 절차에 따라 처리하세요.
파일 정리
산출물이 보관되었는지 확인하세요. 불필요한 임시 파일을 정리하기 전에 다음 빌드에 영향을 주지 않는지 확인하세요.
인증 정보 보호
공용 기기에 저장된 접속 정보를 삭제하고 개인 키, 서명 자료, 민감한 정보가 포함된 로그를 공개된 위치에 두지 마세요.
사이트 및 서비스 정보의 처리 방식은개인정보 처리방침에서 확인하세요.
시작하기
노드를 선택하고 빌드 작업을 클라우드 Mac에 연결하세요.
모델, 대여 기간, 노드를 먼저 확인하세요. 이용을 시작한 뒤 콘솔에서 실제 접속 정보를 확인하고 이 가이드에 따라 SSH 또는 그래픽 데스크톱을 선택하세요.