연결 및 마이그레이션 가이드

로컬 개발 흐름을 클라우드 Mac에 안전하게 연결하세요

PingMini는 클라우드 Mac 독점 물리 머신을 제공합니다. 작업 방식에 따라 그래픽 데스크톱, SSH 또는 자동화 작업을 선택한 뒤 코드, 툴체인과 빌드 구성을 마이그레이션하세요. 각 단계에 입력, 작업, 검수 결과를 제시합니다.

클라우드 Mac 바로 대여하기 문제 해결 지원 보기

3가지 경로: 그래픽 데스크톱, SSH, 자동화 작업
4가지 마이그레이션 대상: 코드, 툴체인, 서명 자료, CI 구성
1가지 원칙: 먼저 검증한 후 단계적으로 마이그레이션

연결 오케스트레이션 로컬 Mac → 클라우드 Mac

실행 대기

대상 노드 SG / JP / KR / HK / US-E

제공 대상 독점 물리 머신

09:00

데스크톱 해상도 및 키보드 레이아웃 확인 검수: 화면, 입력 및 클립보드 정책이 예상대로 작동

연결

09:12

SSH 호스트 지문 확인 및 키 테스트 검수: 비대화형 명령이 올바른 호스트 정보를 반환

검증

09:25

마이그레이션 리포지토리 및 의존성 잠금 파일 동기화 검수: 깨끗한 환경에서 빌드를 재현 가능

재현

09:40

CI 실행 노드 등록 및 프로브 작업 실행 검수: 로그, 산출물 및 종료 코드를 모두 추적 가능

제공

연결 정보는 주문 확인 결과를 기준으로 합니다 PLAN → CONNECT → VERIFY

접속 경로 선택

먼저 작업을 확인하고 연결 방식을 선택하세요

세 가지 방식을 함께 사용할 수 있지만, 최초 개통 시 모든 진입점을 한꺼번에 구성하는 것은 권장하지 않습니다. 먼저 최소 연결을 검증한 뒤 자동화와 팀 협업 권한을 추가하세요.

시각적 작업

그래픽 데스크톱

최초 시스템 점검, Xcode 실행, 서명 자료 처리, 빌드 화면 확인 및 수동 확인이 필요한 작업에 적합합니다.

입력: 호스트 주소, 계정 및 임시 자격 증명
검수: 화면이 선명하고 키보드, 마우스 및 클립보드 정책이 올바름

명령줄

SSH

리포지토리 동기화, 의존성 설치, 로그 수집, 스크립트 실행 및 저대역폭 환경에 적합합니다. 장기간 공유 비밀번호보다 키 사용을 우선하세요.

입력: 호스트 주소, 사용자 이름 및 공개 키
검수: 지문을 확인했으며 비대화형 명령이 안정적으로 반환됨

지속 실행

자동화 작업

CI/CD, 자체 호스팅 작업 실행, 예약 빌드 및 대규모 테스트에 적합합니다. 별도의 실행 계정, 작업 디렉터리 및 취소 가능한 자격 증명을 사용하세요.

입력: 러너 구성, 최소 권한 및 작업 디렉터리
검수: 작업 종료 코드, 로그 및 산출물 위치를 추적 가능

최초 그래픽 연결

먼저 세션을 작업 가능한 상태로 조정하세요

최초 연결의 목표는 프로젝트를 바로 모두 옮기는 것이 아니라 호스트, 디스플레이, 입력 및 데이터 교환 경계를 확인하는 것입니다. 각 항목을 완료할 때마다 결과를 기록하세요.

세션 점검표 GRAPHICAL SESSION

STEP 01–04

01

호스트 정보 확인

주문의 노드, 모델, 호스트 주소 및 계정 이름을 항목별로 대조하세요. 이전 기록으로 연결하거나 기존 프로젝트의 주소를 새 주문에 그대로 사용하지 마세요.

호스트 일치
02

최초 세션 설정

신뢰할 수 있는 네트워크에서 연결을 시작하세요. 최초 접속 후 시스템 정보, 시간대, 디스크 용량 및 네트워크 상태를 먼저 확인하고 민감한 자료는 바로 가져오지 마세요.

세션 안정
03

디스플레이 설정 조정

로컬 화면과 연결 상태에 맞는 해상도를 선택하세요. 글자가 흐리면 먼저 배율을 확인하고, 조작 지연이 있으면 호스트 성능 이상으로 판단하기 전에 화질을 낮추세요.

선명한 화면
04

입력 범위 확인

한국어·영어 입력, 자주 사용하는 단축키 및 키보드 레이아웃을 테스트하세요. 클립보드 양방향 동기화 허용 여부를 확인하고 민감한 내용을 공유 클립보드에 장기간 보관하지 마세요.

입력 제어

연결 전

로컬 점검 기록을 준비하세요

연결을 시작한 네트워크, 클라이언트 버전, 대상 노드 및 시작 시간을 기록하세요. 이후 지연이나 연결 끊김이 발생하면 로컬 연결과 원격 세션 문제를 구분하는 데 도움이 됩니다.

연결 문제 해결 보기

연결 후

먼저 검증하고 복사하지 마세요

소규모 테스트 프로젝트를 실행해 컴파일, 로그 및 출력 디렉터리가 정상인지 확인하세요. 검증이 끝난 후 대규모 리포지토리, 미디어 자료 또는 서명 관련 파일을 마이그레이션하세요.

모델 구성 확인

SSH 초기 설정

검증 가능하고 취소 가능한 명령줄 채널을 구성하세요

키, 호스트 지문 및 계정 권한을 분리해 관리하세요. 단계를 줄이려고 장기 개인 키, 프로젝트 키 및 팀 공유 자격 증명을 같은 디렉터리에 섞지 마세요.

로컬 실행

독립 키를 생성하고 용도를 등록하세요

현재 장치와 현재 협업자를 위한 독립 키를 생성하세요. 파일명에서 장치와 용도를 알 수 있어야 하며, 키 주석에는 필요한 식별 정보만 기록하고 프로젝트 비밀은 넣지 마세요.

ssh-keygen -t ed25519 -a 64 -f ~/.ssh/pingmini_dev
chmod 600 ~/.ssh/pingmini_dev
ssh-add ~/.ssh/pingmini_dev

개인 키는 통제된 로컬 장치에 보관하고 공개 키만 제출하세요. 팀원이 프로젝트를 떠나면 해당 공개 키를 삭제하고 공유 자격 증명 전체를 교체하지 마세요.

원격 검증

지문을 확인한 후 비대화형 명령을 테스트하세요

최초 연결에 표시되는 호스트 지문은 신뢰할 수 있는 출처의 정보와 반드시 대조해야 합니다. 확인이 끝나면 읽기 전용 명령으로 호스트 신원과 명령 실행 경로를 검증하세요.

ssh -i ~/.ssh/pingmini_dev user@host
ssh -i ~/.ssh/pingmini_dev user@host \
  'sw_vers && uname -m && whoami'

예상 결과에는 macOS 버전, arm64 아키텍처와 올바른 계정 이름이 포함되어야 합니다. 결과가 다르면 마이그레이션을 중지하고 주문 및 연결 정보를 먼저 확인하세요.

계정 권한 제한

자동화 계정에는 작업에 필요한 권한만 부여하세요. 대화형 계정과 CI 계정을 분리해 스크립트가 불필요한 개인 디렉터리 접근 권한을 상속하지 않도록 하세요.

호스트 구성 고정

로컬 SSH 구성에서 독립 별칭과 지정 키 파일을 사용하고 관련 없는 신원 시도를 끄면 다른 개인 키를 잘못 사용할 가능성을 줄일 수 있습니다.

종료 코드 테스트

명령 출력뿐 아니라 스크립트 종료 코드도 확인하세요. 자동화 시스템은 종료 코드로 성공과 실패를 판단하므로 로그의 마지막 줄만 보고 판단해서는 안 됩니다.

마이그레이션 경로

마이그레이션을 독립적으로 검수 가능한 세 경로로 나누세요

로컬 Mac에서 클라우드 Mac으로 옮기는 것은 전체 디스크 복사가 아닙니다. 먼저 데이터를 옮기고, 툴체인을 재현한 다음 CI를 연결하세요. 각 경로에 입력 목록과 검수 증거를 남기세요.

01 데이터 마이그레이션

프로젝트에 필요한 데이터만 옮기세요

입력: 코드 리포지토리, 필요한 자료, 구성 템플릿, 데이터베이스 덤프 및 의존성 잠금 파일.
작업: 리포지토리를 우선 새로 클론하고, 대용량 파일은 나누어 검증하며, 민감한 구성은 통제된 채널을 통해 별도로 배치하세요.
검수: 리포지토리 상태가 깨끗하고 핵심 파일의 체크섬이 일치하며 프로젝트 디렉터리에 로컬 임시 캐시가 없음.

02 툴체인 재현

버전 목록에 따라 환경을 재구축하세요

입력: Xcode 버전, 명령줄 도구, 패키지 관리자 목록, SDK 요구 사항 및 의존성 잠금 파일.
작업: 기본 도구를 먼저 설치한 후 의존성을 복원하세요. 기존 장치의 전역 캐시와 파생 데이터 디렉터리를 그대로 복사하지 마세요.
검수: 동일한 커밋이 깨끗한 디렉터리에서 빌드되고 테스트 버전, 컴파일러 버전 및 산출물 정보를 기록할 수 있음.

03 CI 연결

노드를 작업 오케스트레이션에 포함하세요

입력: 러너 등록 정보, 작업 디렉터리, 동시성 정책, 캐시 규칙 및 산출물 전달 위치.
작업: 독립 실행 계정으로 노드를 등록하고 짧은 프로브 작업부터 실행한 뒤 테스트, 보관 및 출시 준비 절차를 단계적으로 연결하세요.
검수: 작업을 시작, 취소 및 회수할 수 있고 로그를 조회할 수 있으며 실패한 작업이 리소스를 점유하는 백그라운드 프로세스를 남기지 않음.

개발 환경 마이그레이션

목록으로 환경을 재현하고 기존 장치의 불필요한 요소는 복사하지 마세요

마이그레이션 완료의 기준은 파일 수가 로컬 장치와 완전히 같은 것이 아니라 동일한 커밋을 새 환경에서 안정적으로 빌드할 수 있는지입니다.

마이그레이션 체크리스트

의존성에 따라 계층별로 복원하세요

코드 리포지토리

신뢰할 수 있는 원격 저장소에서 다시 클론하고 브랜치, 서브모듈, 대용량 파일 참조 및 커밋되지 않은 변경 사항을 확인하세요.

의존성 잠금 파일

프로젝트에서 사용하는 잠금 파일과 버전 선언을 동기화해 새 장치에서 의존성이 의도치 않게 업그레이드되지 않도록 하세요.

Xcode 및 명령줄 도구

실제 버전, 선택한 개발자 디렉터리 및 SDK 요구 사항을 기록한 다음 전체 빌드를 한 번 실행하세요.

인증서 및 프로비저닝 프로파일

프로젝트에 필요한 자료만 가져오고 보관 담당자, 용도 및 취소 경로를 명확히 하며 자동화 계정의 접근 범위를 제한하세요.

빌드 및 테스트 결과

커밋 번호, 도구 버전, 작업 소요 시간, 종료 코드 및 산출물 위치를 마이그레이션 검수 기록으로 보관하세요.

동기화할 항목

빌드 결과를 결정하는 입력

리포지토리, 잠금 파일, 구성 템플릿, 스크립트, 필요한 자료, 서명 자료 및 명확한 버전 요구 사항. 각 항목의 출처와 용도를 파악해야 합니다.

목표: 설명 가능, 재현 가능, 취소 가능

복사하지 않을 항목

다시 생성할 수 있는 캐시

파생 빌드 디렉터리, 패키지 관리자 캐시, 시뮬레이터 임시 데이터, 이전 로그 및 관련 없는 다운로드 파일. 이러한 항목을 복사하면 호환성 문제가 커집니다.

원칙: 먼저 재구축하고 부족할 때만 보충

세션 보안

접근 권한을 시작과 종료가 있는 작업으로 관리하세요

원격 세션, SSH 키 및 CI 자격 증명에는 명확한 담당자, 용도 및 취소 시점을 지정해야 합니다. 협업이 끝났다고 세션을 닫는 것만으로 충분하지 않으며, 접근 권한을 회수하고 잔여 데이터도 정리해야 합니다.

ACCESS

독립적인 강력한 자격 증명 사용

협업자마다 독립적인 진입점을 사용하세요. 여러 사람이 같은 계정과 키를 공유하지 않아야 구성원이 바뀔 때 접근 권한을 정확히 취소할 수 있습니다.

ROTATE

이벤트 발생 시 키 교체

장치 교체, 구성원 이탈, 프로젝트 인계 또는 자격 증명 유출 의심 시 정해진 주기를 기다리지 말고 즉시 교체하세요.

LIMIT

공유 계정 제한

대화형 작업, 자동화 실행 및 관리 작업에 서로 다른 계정 경계를 사용해 CI 작업이 불필요한 개인 디렉터리 권한을 얻지 않도록 하세요.

인계 및 정리 완료

임대 기간이 끝나기 전에 필요한 산출물을 내보내고 프로젝트 자격 증명을 취소하며 민감한 파일을 삭제하고 협업자 진입점이 회수되었는지 확인하세요.

협업 시작 담당자, 용도 및 권한 등록

작업에 필요한 진입점만 열고 해당 공개 키 또는 실행 계정을 기록하세요.

협업 진행 중 비정상 로그인 및 남은 작업 확인

출처, 시간 또는 작업 동작이 비정상적이면 먼저 접근을 일시 중지하고 필요한 로그를 보존하세요.

협업 종료 진입점 취소 및 민감한 데이터 정리

기존 키로 더 이상 연결할 수 없는지 확인하고 프로젝트 자료가 인계 요구 사항에 따라 처리되었는지 확인하세요.

연결 문제 해결

주문부터 클라이언트 로그까지 계층별로 문제를 제외하세요

주소, 네트워크, 자격 증명 및 클라이언트 설정을 동시에 바꾸지 마세요. 한 번에 한 계층만 검증하고 오류 원문과 발생 시간을 보관해야 문제를 빠르게 찾을 수 있습니다.

01

주문 상태 확인

서비스 제공이 완료되었고 현재 임대 기간이 유효하며 모델과 노드가 주문과 일치하는지 먼저 확인하세요. 실제 사용 가능 상태는 콘솔의 실시간 응답을 기준으로 합니다.

주문 계층
02

호스트 주소 확인

주소, 포트 및 계정 이름을 한 글자씩 확인하고 이전 연결 기록을 사용하지 마세요. 주소가 바뀌면 로컬 별칭과 자동화 구성도 함께 업데이트하세요.

주소 지정 계층
03

로컬 네트워크 정책 확인

신뢰할 수 있는 대체 네트워크로 전환해 비교하고 로컬 방화벽, 기업 출구 정책, 프록시 설정 및 DNS 확인이 연결에 영향을 주는지 점검하세요.

네트워크 계층
04

자격 증명 및 호스트 지문 검증

올바른 키와 계정을 사용하고 있는지 확인하세요. 지문이 비정상적이면 검증을 우회하지 말고 연결을 중지한 후 신뢰할 수 있는 출처의 호스트 정보를 대조하세요.

인증 계층
05

시스템 서비스 확인

SSH는 사용할 수 있지만 그래픽 세션을 사용할 수 없다면 해당 서비스를 각각 확인하세요. 그래픽 세션은 사용할 수 있지만 스크립트가 실패한다면 Shell, 경로 및 권한을 확인하세요.

서비스 계층
06

클라이언트 로그 수집

발생 시간, 클라이언트 버전, 오류 원문, 재현 단계 및 완료한 점검 내용을 보관하세요. 지원 요청을 제출할 때 “연결할 수 없음”이라고만 쓰지 마세요.

증거 계층

시작하기

구성을 먼저 선택한 후 이 체크리스트에 따라 연결하세요

세 가지 고정 구성이 경량 빌드, 일상적인 개발 및 대규모 모델 추론을 지원합니다. 주문 후 주문 확인 정보에 따라 물리 노드에 연결하고 개발 환경을 단계적으로 마이그레이션하세요.

클라우드 Mac 바로 대여하기 세 가지 요금제 보기 지원 경로 보기