연결 및 마이그레이션 매뉴얼

제공 정보부터 재현 가능한 클라우드 Mac 워크플로까지

먼저 노드, 자격 증명, 로컬 네트워크를 확인한 뒤 원격 세션을 설정하세요. 연결이 안정되면 코드·데이터, 툴체인, CI를 세 경로로 나누어 이전하고 로컬 환경을 한 번에 통째로 옮기지 않습니다.

클라우드 Mac 대여 연결 문제 해결 보기
연결 순서
제공 정보 확인 → 세션 설정 → 자격 증명 변경
마이그레이션 순서
코드·데이터 → 툴체인 → CI
세션 인계 보드 REMOTE / READY
01 제공 정보 확인 노드 주소, 사용자 이름, 접속 방식
02 세션 설정 네트워크, 화면, 키보드, 권한
03 워크플로 마이그레이션 데이터, 툴체인, Runner, 산출물
물리 구성 전용 물리 서버
실행 환경 가상 머신 아님
진행 원칙 소규모 이전, 검증 가능한 롤백
제공 후 시작

실제 노드 주소와 접속 정보는 콘솔의 제공 정보를 기준으로 합니다.

연결 전 확인

세션 실패 요인을 먼저 로컬에서 제거하세요

첫 연결과 동시에 프로젝트를 이전하지 마세요. 먼저 5가지 기본 점검을 완료해 로컬 클라이언트, 네트워크, 제공 자료가 안정적인 세션을 지원하는지 확인합니다.

클라이언트

지원되는 연결 도구 준비

클라이언트 버전이 정상적으로 작동하는지 확인하고 예비 접속 방법을 하나 마련하세요. 첫 세션 전에 키보드 매핑, 프록시 또는 화면 배율을 변경하는 확장 기능을 종료합니다.

네트워크

안정적인 연결로 첫 접속

유선 네트워크나 안정적인 Wi‑Fi를 우선 사용하고 대용량 파일 동기화와 로컬 업로드를 일시 중지하세요. 기업 프록시를 거치는 경우 원격 세션과 SSH 트래픽이 변경되지 않는지 먼저 확인합니다.

제공 자료

주소와 자격 증명을 항목별로 확인

콘솔에서 노드 주소, 사용자 이름, 접속 방식을 확인하고 채팅 기록이나 이전 티켓에서 복사하지 마세요. 자격 증명은 비밀번호 관리 도구에만 저장하고 스크립트나 저장소에는 기록하지 않습니다.

화면

보수적인 해상도로 먼저 접속

첫 연결은 단일 모니터와 일반적인 배율로 진행하세요. 텍스트, 커서, 단축키가 정상인지 확인한 뒤 해상도를 높여 화면 문제를 네트워크 문제로 오해하지 않도록 합니다.

로컬 파일

첫 검증에 필요한 데이터만 준비

첫 전송에는 프로젝트 목록, 의존성 잠금 파일, 검증 가능한 소규모 브랜치 하나만 포함하세요. 미디어 원본, 이전 캐시, 아카이브는 연결 검증 후 나누어 전송합니다.

첫 연결 절차

한 번에 변수 하나만 검증

첫 세션을 주소, 연결, 자격 증명, 입력, 화면의 5단계로 나누세요. 각 단계에 명확한 완료 조건을 두면 문제가 발생했을 때 가장 최근 변경 사항을 추적할 수 있습니다.

  1. 01

    노드 주소 확인

    콘솔의 제공 정보와 호스트 이름 또는 주소, 사용자 이름, 연결 프로토콜을 대조하세요. 대상 노드가 일치하는지 확인한 뒤 세션을 설정합니다.

    완료 조건: 대상 정보가 항목별로 일치
  2. 02

    최소 세션 설정

    단일 모니터, 일반 해상도, 기본 화질로 접속해 몇 분간 유지하면서 창 전환, 텍스트 입력, 파일 탐색을 수행합니다.

    완료 조건: 입력과 화면이 끊김 없이 사용 가능
  3. 03

    초기 자격 증명 변경

    처음 접속한 즉시 독립적인 강력한 자격 증명을 설정하고 비밀번호 관리 도구의 기록을 업데이트하세요. 제공 단계에서 사용한 초기 자격 증명은 일상적인 사용 흐름에서 제거합니다.

    완료 조건: 새 자격 증명으로 재로그인 성공
  4. 04

    키보드 배열 확인

    Command, Option, Control, 방향키와 자주 사용하는 한국어·영어 입력을 테스트하세요. 원격 클라이언트와 macOS의 키보드 배열이 일치해야 합니다.

    완료 조건: 편집기 단축키 충돌 없음
  5. 05

    화면 설정 조정

    기본 세션이 안정된 뒤 해상도, 배율, 화질을 높이세요. 한 번에 한 항목만 변경하고 텍스트 선명도, 커서 지연, 네트워크 사용량을 확인합니다.

    완료 조건: 목표 화면에서 안정적으로 작업 가능
마이그레이션 경로

로컬 Mac에서 클라우드 Mac으로, 롤백 가능한 3가지 경로

세 경로를 순서대로 실행하세요. 각 항목에 입력, 작업, 검증 결과, 롤백 지점을 기록해 원격 환경이 안정되기 전에 코드, 도구 버전, 자동화 설정을 동시에 바꾸지 않도록 합니다.

경로 A

데이터 마이그레이션

입력
코드 저장소, 의존성 잠금 파일, 필수 리소스, 검증 목록
작업
먼저 빌드 가능한 소규모 브랜치를 전송한 뒤 캐시, 리소스, 아카이브를 디렉터리별로 나누어 동기화
검증 결과
저장소 상태가 일치하고 핵심 파일 검증을 통과하며 샘플 프로젝트를 읽을 수 있음
롤백 지점
로컬 원본을 보관하고 원격 배치는 별도 임시 디렉터리에 저장
경로 B

툴체인 재현

입력
macOS, Xcode, 명령줄 도구, 패키지 관리자, 스크립트 버전 목록
작업
의존성 순서대로 설치하고 버전을 고정한 뒤 진단 명령을 항목별로 실행
검증 결과
동일한 커밋으로 분석, 빌드, 테스트, 아카이브 전 점검을 완료할 수 있음
롤백 지점
버전 목록과 설정 사본을 저장하고 실패하면 이전에 검증한 버전 그룹으로 복귀
경로 C

CI 연동

입력
Runner 설정, 변수 목록, 키 범위, 빌드 디렉터리, 산출물 규칙
작업
격리된 Runner를 먼저 등록한 뒤 최소 빌드 작업과 산출물 업로드를 연동
검증 결과
작업을 반복 실행할 수 있고 로그, 종료 코드, 산출물 위치가 명확함
롤백 지점
새 Runner를 비활성화하고 기존 실행기로 복구한 뒤 원격 임시 디렉터리를 정리
데이터 마이그레이션 가이드

재구축 가능성에 따라 전송 우선순위 결정

코드와 설정을 먼저 옮기고 다시 생성할 수 있는 캐시는 나중에 처리하세요. 재구축이 어려운 서명 자료와 미디어 원본은 별도로 검증합니다. 대용량을 이전하기 전에 소규모 샘플로 경로와 권한을 먼저 확인하세요.

로컬 데이터를 클라우드 Mac으로 옮기는 단계별 전략
데이터 유형 첫 번째 배치 권장 작업 검증 방법 롤백 처리
코드 저장소 주 저장소, 서브모듈, 의존성 잠금 파일 깨끗한 클론에서 시작하고 로컬 상태가 포함된 작업 디렉터리를 직접 복사하지 않음 브랜치, 커밋 번호, 서브모듈, 추적되지 않은 파일 확인 원격 사본을 삭제한 뒤 다시 클론
빌드 캐시 재사용 가능성이 확인된 캐시만 이전 먼저 캐시 없이 한 번 빌드한 뒤 도구별로 캐시 복원 히트 로그, 빌드 결과, 디스크 사용량 비교 해당 캐시 디렉터리를 비우고 다시 생성
서명 자료 프로젝트에 실제로 필요한 최소 항목 통제된 암호화 채널로 전송하고 파일 및 키체인 권한 제한 산출물을 업로드하지 않는 서명 검증 실행 가져온 항목을 제거하고 임시 접근 권한 철회
미디어 리소스 전체 흐름을 검증할 수 있는 소규모 샘플 프로젝트, 배치, 용도별 디렉터리를 만들고 캐시와 섞지 않음 파일 수, 크기, 콘텐츠 체크섬 확인 현재 배치를 삭제하고 로컬 원본에서 다시 전송
대용량 아카이브 인덱스, 목록, 테스트 아카이브 하나 분할 전송하고 각 볼륨의 상태를 기록해 대상 디렉터리를 한 번에 덮어쓰지 않음 볼륨별 검증 및 압축 해제 결과 샘플 확인 실패한 볼륨만 다시 전송하고 전체를 반복 전송하지 않음
마이그레이션 완료 기준

‘파일 전송이 끝났다’가 기준이 아닙니다. 명확한 커밋과 의존성 목록을 바탕으로 원격 환경에서 대조 가능한 빌드 결과를 재현할 수 있어야 합니다.

툴체인 재현

먼저 버전을 기록한 뒤 프로젝트 환경 복원

‘자주 쓰는 도구를 전부 설치’하는 것부터 시작하지 마세요. 프로젝트의 실제 의존성을 기준으로 시스템, 컴파일러, 명령줄 도구, 의존성 관리, 인증서, 스크립트 순서로 재현합니다.

기록 항목 확인 작업 통과 신호
macOS

시스템 버전, 아키텍처, 디스크 공간, 지역 설정을 기록하고 프로젝트 요구 사항과 시스템 기능의 호환성 확인

시스템 정보 보관 완료
Xcode

프로젝트 지정 버전, 첫 실행 구성 요소, 현재 개발자 디렉터리를 확인하고 그래픽 인터페이스의 임시 선택에 의존하지 않음

버전과 경로 일치
명령줄 도구

컴파일러, SDK, Git, Ruby 또는 프로젝트에 필요한 기타 런타임을 확인하고 실제로 해석된 경로 기록

명령 해석에 모호함 없음
패키지 관리자

잠금 파일에 따라 의존성을 복원하고 전역 도구와 프로젝트 내부 의존성을 구분해 로컬 캐시로 누락 항목을 가리지 않음

깨끗한 설치를 반복 가능
인증서 및 권한

현재 작업에 필요한 자료만 가져오고 키체인 접근 범위, 파일 권한, 자동화 프로세스의 가시성 확인

최소 범위 검증 통과
프로젝트 스크립트

읽기 전용 점검부터 시작한 뒤 의존성 분석, 테스트, 빌드를 실행하세요. 스크립트가 로컬에만 등록된 절대 경로에 의존해서는 안 됩니다.

동일 커밋의 결과 일치
CI 연동

최소 작업을 먼저 통과시킨 뒤 정식 파이프라인 연동

Runner 연동을 툴체인 마이그레이션과 동시에 진행하지 마세요. 먼저 수동 세션에서 빌드가 반복 가능한지 확인한 뒤 동일한 명령을 자동화 작업에 넣습니다.

01 / Runner

격리된 실행기 등록

클라우드 Mac에 독립적인 Runner 식별자와 태그를 사용하고 수신 가능한 저장소와 작업 유형을 제한하세요. 먼저 시스템 정보만 출력하는 진단 작업을 실행합니다.

02 / Variables

변수와 시크릿 분리 설정

일반 환경 변수에는 버전과 경로를 기록하고 민감한 값은 통제된 시크릿 저장소에 맡기세요. 로그에 토큰, 개인 키, 서명 자료를 출력해서는 안 됩니다.

03 / Workspace

빌드 디렉터리 경계 고정

소스 코드, 의존성 캐시, 임시 출력, 최종 산출물 디렉터리를 구분하세요. 작업 시작 전에 남은 용량을 확인하고 종료 후 재생성 가능한 항목만 정리합니다.

04 / Artifact

산출물 업로드 규칙 명확화

업로드 작업은 약속된 출력 디렉터리만 읽어야 합니다. 커밋 번호, 빌드 번호, 검증 정보를 함께 보관해 임시 로그가 전달 패키지에 섞이지 않도록 합니다.

05 / Cleanup

실패한 작업을 안전하게 재실행

종료 코드를 수집하고 잠금 파일, 중단된 프로세스, 임시 디렉터리를 정리하세요. 진단 로그를 보관한 뒤 다음 작업은 알려진 상태에서 시작해야 합니다.

정식 파이프라인으로 전환하기 전

새 작업 디렉터리에서 빌드 1회, 실패 후 재실행 1회, 산출물 업로드 및 검증 1회를 최소한 확인하세요. 세 항목을 모두 통과한 뒤 작업 범위를 넓힙니다.

연결 명령 예시

읽기 전용 명령으로 세션과 기본 환경 확인

다음 점검은 시스템 설정을 변경하지 않습니다. 먼저 로컬 터미널에서 콘솔에 제공된 호스트와 사용자 이름을 설정한 뒤 SSH 세션을 만들고 시스템, 아키텍처, 디스크, 개발 도구 경로를 기록하세요.

저장소에 기록하지 않기

호스트, 사용자 이름, 키 경로, 토큰을 프로젝트 스크립트나 버전 관리에 포함하지 마세요.

즉시 설치하지 않기

먼저 읽기 전용 점검을 완료하고 현재 상태를 확인한 뒤 툴체인을 변경하세요.

세션 검증 체크리스트 READ ONLY 
export SETMINI_HOST="콘솔에 제공된 노드 주소"
export SETMINI_USER="콘솔에 제공된 사용자 이름"

ssh "${SETMINI_USER}@${SETMINI_HOST}"

hostname
sw_vers
uname -m
df -h /
xcode-select -p
xcodebuild -version
git --version
echo "$SHELL"
예상 아키텍처 arm64
세션 보안

원격 세션을 프로덕션 접근 관리처럼 다루세요

전용 물리 서버라고 해서 접근 제어를 완화해도 되는 것은 아닙니다. 자격 증명, 권한, 화면 잠금, 로그아웃, 민감한 파일 정리를 팀 인계 체크리스트에 포함해야 합니다.

강력한 자격 증명

노드에 독립적인 자격 증명을 설정하고 비밀번호 관리 도구에 저장하세요. 구성원 변경, 유출 의심, 비정상 로그인 후에는 즉시 갱신합니다.

최소 권한

일상적인 개발에는 작업에 필요한 최소 권한만 사용하세요. 임시로 권한을 높였다면 즉시 해제하고 높은 권한을 자동화 스크립트에 기록하지 않습니다.

자리 비울 때 화면 잠금

잠시 자리를 비울 때도 세션을 잠그세요. 공유 사무실에서는 로컬 화면 미리보기도 함께 끄고 원격 콘텐츠가 노출되지 않도록 합니다.

세션 완전히 종료

작업이 끝나면 원격 클라이언트와 SSH 세션에서 로그아웃하고 백그라운드에 대화형 프로세스나 임시 포트 포워딩이 남아 있지 않은지 확인하세요.

민감한 파일 정리

임시 다운로드, 디버그 내보내기, 암호화되지 않은 아카이브, 더 이상 필요하지 않은 서명 자료를 제거하고 정리 기록을 보관하세요.

접근 이상 신고

알 수 없는 세션, 비정상 프로세스, 자격 증명 위험을 발견하면 발생 시간과 필요한 로그를 먼저 보존한 뒤 콘솔에서 티켓을 제출하세요.

콘솔에 로그인해 티켓 제출
마이그레이션 시작

안정적인 세션을 먼저 만든 뒤 검증 가능한 첫 워크플로를 이전하세요

전용 Apple Silicon Mac을 선택하고 제공 정보를 받은 뒤 이 페이지의 순서에 따라 연결, 환경 기록, CI 연동을 완료하세요.

클라우드 Mac 만들기 먼저 대여 요금제 보기