개발 환경 인수인계 체크리스트

주문부터 첫 빌드까지

전용 물리 클라우드 Mac을 대여해 기존 저장소, 개발 도구, CI 파이프라인을 연결하세요. 이 페이지는 작업 순서에 따라 안내합니다. 저장소와 빌드 스크립트가 이미 있다면 환경 이전에 약 30~60분을 확보하세요. 데이터 전송과 Xcode 다운로드 시간은 별도입니다.

이미 인스턴스가 있나요?콘솔에 로그인해 연결 정보를 확인하세요. 아래 명령과 출력은 작업 예시입니다. 실제 주소와 인증 정보는 콘솔에 표시된 값을 확인하세요.

구성 선택접속 정보 확인환경 이전빌드 검증
시작 전

먼저 주문하고 연결 정보를 기록하세요

주문할 때 세 가지를 정하세요. 모델은 컴파일 및 병렬 작업에 사용할 리소스를, 데이터 센터는 원격 작업의 지연 시간을, 요금제는 사용 기간을 결정합니다. 세 가지 모델 모두 가상 머신이 아닌 전용 물리 장비입니다. 실제 사용 가능 여부는 콘솔에 표시되는 최신 정보를 확인하세요.

01 / 구성

모델, 데이터 센터, 요금제 선택

ZSH 16은 단일 빌드 파이프라인을 먼저 검증하기에 적합합니다. 병렬 컴파일이나 상시 실행 러너에는 ZSH 24를 고려하세요. MLX 실험에 더 큰 통합 메모리가 필요하다면 ZSH Pro 64를 확인하세요. 이어서 팀의 주요 접속 위치에 맞는 데이터 센터를 선택하세요.

확인 항목: 모델, SSD 용량, 데이터 센터, 일·주·월·분기 요금제

02 / 결제

미국 달러로 결제

USDT-TRC20 또는 Stripe를 통한 Visa / Mastercard / Amex 결제를 지원합니다. USDT를 송금하기 전에 TRC20 네트워크인지 확인하세요. 카드 결제는 결제 페이지에 표시된 게이트웨이를 이용하세요.

확인 항목: 결제 결과와 콘솔의 주문 상태. 실제 이용 가능한 결제 게이트웨이는 서버 응답을 확인하세요.

03 / 인스턴스 제공

SSH 및 화면 공유 접속 정보 확인

인스턴스가 제공되면 콘솔에서 연결 주소, 사용자 이름, 최초 로그인 인증 정보, 호스트 지문을 기록하세요. 저장소, 빌드 로그, 팀 공용 문서에는 이러한 정보를 남기지 마세요.

확인 항목: SSH 로그인 및 macOS 그래픽 인터페이스 접속

이전 순서

데이터, 개발 도구, CI 순서로 이전하세요

먼저 새 장비에서 저장소 하나를 독립적으로 빌드해 보세요. 성공한 뒤 자동화 작업을 연결하면 오류 원인이 자료 누락인지, 도구 버전 불일치인지, 러너 설정 문제인지 구분하기 쉽습니다.

01자료

저장소와 서명 자료부터 이전하세요

다음 명령으로 rsync 를 사용해 저장소를 전송하거나 관리되는 원격 저장소에서 새로 체크아웃하세요. 인증서, 프로비저닝 프로파일, 키체인 내보내기 파일은 각각 암호화해 전송하세요. 개인 키를 일반 동기화 폴더에 넣지 마세요.

  • 저장소 브랜치, 서브모듈, Git LFS 파일이 모두 있는지 확인하세요.
  • 서명 자료를 가져온 뒤 빌드 사용자 세션에서 키체인 접근을 확인하세요.
  • 빌드에 필요한 환경 변수를 비교하고 로컬 비밀 키를 평문으로 복사하지 마세요.

수동 점검 참고 시간: 10~20분. 전송 시간은 데이터 양에 따라 달라집니다.

02개발 도구

버전을 고정한 뒤 캐시를 복원하세요

Homebrew로 명령줄 의존성을 설치하고 xcodes로 프로젝트에 필요한 Xcode 버전을 관리하세요. 먼저 xcode-select 이 올바른 경로를 가리키는지 확인한 다음 fastlane, CocoaPods, SPM에 필요한 의존성을 설치하세요.

  • 기록하세요: xcodebuild -version 을 실행하고 프로젝트에서 요구하는 버전과 비교하세요.
  • 의존성 확인을 한 번 실행하고 이전 장비의 절대 경로가 캐시에 남지 않도록 하세요.
  • 단일 scheme으로 로컬 빌드를 성공시킨 다음 병렬 테스트를 설정하세요.

수동 점검 참고 시간: 10~20분. 소프트웨어 다운로드 시간은 별도입니다.

03CI 파이프라인

마지막으로 전용 러너를 등록하세요

장비를 기존 GitHub Actions 또는 GitLab Runner 워크플로에 연결하세요. 저장소나 조직에서 제공하는 등록 절차를 사용하고, 전용 시스템 계정으로 빌드 작업을 실행하세요.

  • 모델과 데이터 센터를 명확히 식별할 수 있는 러너 라벨을 설정하세요.
  • 테스트 작업으로 Xcode, 서명, 산출물 출력 경로를 확인하세요.
  • 동시 실행 수를 제한하고 작업 종료 후 민감한 임시 파일이 남지 않는지 확인하세요.

수동 점검 참고 시간: 10~20분. 첫 작업 시간은 별도입니다.

안내된 시간은 수동 점검을 계획하기 위한 참고치이며, 인스턴스 제공이나 다운로드 시간을 보장하지 않습니다. 빌드가 대용량 캐시에 의존한다면 먼저 재현 가능한 설정을 이전한 뒤 캐시 파일도 전송할지 결정하세요.

검증 기록

명령 세 단계로 환경을 확인하세요

아래는 터미널 작업 예시이며 실제 인스턴스 주소, 지문, 빌드 결과가 아닙니다. 예시 주소와 scheme은 콘솔 및 프로젝트의 실제 값으로 바꾸세요. SSH에 처음 연결할 때는 콘솔에 표시된 호스트 지문이 정확히 일치하는지 먼저 확인해야 합니다.

zsh — mac@sg-node 예시 출력

연결 및 지문 확인

zsh % ssh -o StrictHostKeyChecking=ask mac@203.0.113.10
The authenticity of host '203.0.113.10' can't be established.
Host key verification required before continuing.
확인 메시지가 표시되면 진행을 멈추세요. 터미널에 표시된 ED25519 지문을 콘솔에 기록된 값과 비교하세요. 다르면 연결을 중단하고 지원 티켓을 제출하세요.

빌드 검증

zsh % xcodebuild -version
Xcode 16.2
zsh % xcodebuild -scheme App -configuration Release build
** BUILD SUCCEEDED **
먼저 Xcode 버전을 확인한 뒤 프로젝트에서 사용하는 scheme과 구성을 지정해 빌드하세요. 예시 버전은 인스턴스에 사전 설치된 버전과 다를 수 있습니다.

배포 경로 검증

zsh % fastlane beta
Running lane 'beta'
Archive complete
Upload to TestFlight complete
업로드 전에 팀의 서명 자료와 권한, fastlane lane 설정을 확인하세요. 실제 토큰이 CI 로그에 출력되지 않도록 주의하세요.
그래픽 인터페이스

데스크톱이 필요할 때 화면 공유로 연결하세요

SSH는 의존성 설치, 코드 가져오기, 빌드 실행에 적합합니다. Xcode 설정, 시뮬레이터, 그래픽 도구는 macOS 화면 공유로 사용하세요. 콘솔에서 해당 인스턴스의 화면 공유 주소와 접속 정보를 확인한 뒤 로컬 화면 공유 클라이언트로 연결하세요.

처음 데스크톱에 접속한 뒤 현재 네트워크에 적합한 해상도와 배율인지 확인하세요. 원격 조작이 느리다면 먼저 해상도를 낮추고 불필요한 그래픽 애니메이션을 끈 다음, 네트워크별 연결 품질을 비교하세요. 클립보드 동기화는 민감하지 않은 텍스트에만 사용하세요. 인증서나 개인 키는 관리되는 암호화 경로로 전송해야 합니다.

DISPLAY / CONNECT연결 전 확인
주소 및 접속 정보
현재 인스턴스의 콘솔 페이지에서 확인하세요. 다른 인스턴스의 기록을 재사용하지 마세요.
화면 설정
먼저 안정적으로 읽을 수 있는 해상도를 선택한 뒤 대역폭에 맞춰 화질을 조정하세요.
클립보드
필요한 텍스트만 동기화하세요. 민감한 파일은 별도 전송 절차를 이용하세요.
연결 문제
인스턴스 상태와 주소를 확인한 다음 로컬 네트워크 및 방화벽 규칙을 점검하세요.
인스턴스 제공 후 점검

첫 보안 설정을 완료하세요

연결에 성공했다고 인수인계가 끝난 것은 아닙니다. 아래 네 가지 항목을 완료한 뒤 상시 CI에 인스턴스를 연결하세요. 한 번 로그인에 성공한 화면만으로 판단하지 말고, 실제로 이 장비를 사용할 팀이 각 항목을 확인해야 합니다.

  1. 01 초기 비밀번호 변경 macOS에서 제공된 계정의 비밀번호를 새로 설정하고 팀의 관리되는 인증 정보 기록도 업데이트하세요. 채팅 기록이나 파이프라인 변수 설명에 평문 비밀번호를 붙여 넣지 마세요.
  2. 02 SSH 키 사용 먼저 공개 키를 설치하고 새 터미널에서 로그인이 되는지 확인한 뒤 비밀번호 로그인 정책을 조정하세요. 설정 오류로 연결이 끊기지 않도록 기존 세션은 유지하세요.
  3. 03 방화벽 확인 macOS 방화벽을 켜고 개발 및 화면 공유에 필요한 접근 권한을 하나씩 확인하세요. 변경 전 현재 규칙을 기록하고 관리 연결이 계속 가능한지 확인하세요.
  4. 04 시스템 업데이트 예약 정기적으로 softwareupdate -l 을 실행해 업데이트를 확인하세요. 빌드 환경에 영향을 줄 수 있는 업데이트를 설치하기 전에 자료를 백업하고 Xcode와 프로젝트의 호환성을 확인하세요.
사용 기간 관리

갱신 전 요금제를 확인하고 반납 전 데이터를 백업하세요

현재 요금제의 시작 및 종료 시각, 청구 내역, 갱신 방법은 콘솔의 주문 페이지를 확인하세요. 만료 알림도 콘솔과 실제로 받은 서비스 알림을 기준으로 확인하고, 개인 캘린더만 보고 판단하지 마세요. 계속 사용하려면 콘솔에서 모델, 데이터 센터, 요금제, 금액을 확인한 뒤 갱신하세요.

사용을 마치기 전에 저장소의 미푸시 변경 사항, 서명 자료, 빌드 산출물, 필요한 감사 기록을 백업하세요. 다른 장비에서 백업 파일을 열 수 있는지 확인한 다음 콘솔에서 반납을 진행하세요. 반납 후에는 디스크가 삭제되고 시스템이 재설치되므로 반납 절차를 백업 수단으로 사용하지 마세요.

더 알아보기

현재 문제에 맞는 다음 안내를 확인하세요

SSH, VNC, 일상적인 개발 환경 설정은 기술 문서 목록에서 원격 Mac 개발 환경 구축 안내를 찾아보세요. 빌드 매개변수, 캐시, 러너 설정은 클라우드 Xcode 빌드 가이드를 참고하세요. 인스턴스 오류나 청구 관련 문의는 기술 지원을 이용하세요.

환경 및 연결

원격 Mac 개발 환경 설정

SSH 키, Homebrew 초기 설정, 화면 공유 구성, 원격 편집기 연결 방법을 확인하세요.

빌드 및 CI

클라우드 Xcode 빌드 가이드

Xcode 버전, 빌드 캐시, 테스트 명령, 셀프 호스팅 러너 연결 방법을 자세히 확인하세요.

인스턴스 및 청구

기술 지원 센터

연결 실패, 빌드 환경 오류, 갱신 문의가 있다면 먼저 점검 항목을 확인한 뒤 콘솔에서 지원 티켓을 제출하세요.

다음 단계 / 구성 시작

첫 빌드를 실행하세요

모델, 데이터 센터, 요금제를 선택하세요. 인스턴스가 준비되면 이 페이지의 체크리스트에 따라 연결, 이전, 검증을 진행하세요.