클라우드 Mac 연결·빌드·문제 해결 가이드

작업별로 시작하기

문제가 발생한 단계를 먼저 선택하세요

여섯 가지 진입점을 한눈에 확인할 수 있습니다. 문제가 여러 단계에 걸쳐 있다면 전체 환경을 먼저 초기화하지 말고, 이상이 처음 나타난 단계부터 시작하세요.

SSH

첫 연결

키 권한, 호스트 지문, 사용자 이름, 포트와 로컬 네트워크를 점검해 연결 실패가 인증 전인지 후인지 확인하세요.

연결 문제 해결 시작

XCODE

Xcode 빌드

현재 도구 체인, 프로젝트 scheme, 종속성 상태, 서명 파일, 디스크 여유 공간과 내보낼 수 있는 결과 패키지를 확인하세요.

빌드 명령 보기

FASTLANE

자동화 파이프라인

Ruby 환경, 플러그인, lane 매개변수와 Xcode 반환 오류를 구분하고 마지막 한 줄만 자르지 말고 전체 로그를 보존하세요.

자동화 출력 점검

TRANSFER

파일 전송

먼저 결과물을 패키징하고 체크섬을 생성한 뒤 아카이브를 전송하세요. 쓰기 중인 빌드 디렉터리나 종속성 캐시를 그대로 옮기지 마세요.

전달 순서 보기

SESSION

원격 개발 세션

로컬 네트워크가 안정적인지, 연결이 끊겨도 작업이 계속되는지 확인하고 기기를 떠나기 전에 대화형 세션을 종료하고 임시 자료를 정리하세요.

세션 경계 확인

MLX

MLX 환경

통합 메모리, 모델 파일, 격리 환경과 실험 기록을 기준으로 점검하세요. 검증할 수 없는 속도 수치만으로 환경이 정상인지 판단하지 마세요.

실험 환경 점검

첫 연결 기준

SSH 연결 실패 시 핸드셰이크 순서대로 점검

원본 오류를 먼저 저장한 뒤 한 번에 하나의 변수만 변경하세요. 사용자 이름, 포트와 키를 계속 바꾸면 오류 원인을 찾기 어려워집니다.

01

키 권한

로컬에서 실행하세요 chmod 600 ~/.ssh/oakvps_key 다른 사용자가 개인 키를 읽을 수 있으면 SSH 클라이언트가 인증을 시작하기 전에 해당 키 사용을 거부합니다.

02

호스트 지문

처음 연결할 때는 터미널에 표시된 지문을 콘솔의 연결 정보와 대조한 후 확인하세요. 호스트 정보가 바뀌었다고 기존 기록을 바로 삭제하고 검증을 건너뛰지 마세요.

03

사용자 이름

주문 연결 정보에 표시된 시스템 사용자 이름을 사용하세요. 이메일 주소나 로컬 컴퓨터 사용자 이름을 원격 명령에 입력하지 마세요.

04

포트

연결 정보의 포트를 명시적으로 전달하세요. 예: ssh -p 22 user@host 시간 초과는 대개 인증 전에 발생하고, 권한 거부는 대개 인증 단계에서 발생합니다.

05

네트워크 허용

회사 네트워크, VPN, 로컬 방화벽과 송신 정책이 대상 포트를 허용하는지 확인하세요. 신뢰할 수 있는 네트워크로 바꿔 재확인할 수 있지만, 신뢰할 수 없는 네트워크에서 프로젝트 자격 증명을 전송하지 마세요.

06

첫 확인

접속에 성공하면 먼저 다음을 실행하세요. whoami、sw_vers 및 df -h 을 실행해 사용자, 시스템 버전과 디스크 여유 공간을 기록한 다음 프로젝트 자료를 가져오세요.

명령 반환값으로 원인 찾기

연결·빌드·자동화 출력을 나누어 확인하세요

터미널의 마지막 줄은 대개 결과일 뿐 원인은 아닙니다. 아래 세 명령은 각각 연결 사용자, Xcode 빌드 진입점과 fastlane lane 상태를 확인합니다. 실행 전에 예시 매개변수를 자신의 연결 정보, workspace와 scheme으로 바꾸세요.

연결 성공원격 사용자 이름, 시스템 버전과 디스크 정보를 반환합니다.
빌드 진입점 유효workspace, scheme과 대상 플랫폼을 Xcode가 올바르게 인식합니다.
자동화 체인 확인 가능Bundler, 플러그인과 lane의 오류를 각각 전체 맥락과 함께 보존합니다.

oakvps-task-session

연결 및 환경 확인

$ ssh -i ~/.ssh/oakvps_key -p 22 oak@203.0.113.10
$ whoami
oak
$ sw_vers -productVersion
15.x
$ df -h /

확인 포인트:명령이 원격 사용자 이름을 반환했다면 네트워크와 인증 단계는 통과한 것입니다. 이후 문제는 시스템 권한이나 프로젝트 환경을 확인해야 합니다.

Xcode 빌드 진입점

$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ xcodebuild -version
Xcode 16.x
$ xcodebuild -workspace App.xcworkspace \
  -scheme App \
  -destination 'generic/platform=iOS' \
  build | tee build.log

확인 포인트:먼저 개발자 디렉터리를 확인한 다음 workspace와 scheme을 점검하세요. build.log을 보존하고 마지막 실패 요약만 복사하지 마세요.

fastlane 출력 예시

$ bundle exec fastlane lanes
$ bundle exec fastlane ios build \
  --verbose 2>&1 | tee fastlane.log
[09:24:18]: Driving the lane 'ios build'
[09:24:19]: Resolving package dependencies

확인 포인트:lane 목록이 표시되면 Ruby 종속성 진입점이 정상적으로 작동하는 것입니다. 이후 실패하더라도 종료 코드만 보지 말고 로그에서 가장 먼저 나타난 오류를 계속 찾으세요.

빌드 실패 진단

종속성 관계에 따라 점검하고 전체 환경을 먼저 재설치하지 마세요

버전, 캐시, 서명, 디스크와 로그는 서로 영향을 줍니다. 아래 순서를 따르면 불필요한 변경을 줄이고 다음 담당자가 같은 문제를 재현할 수 있습니다.

빌드 실패 점검 순서·명령·판단 기준
순서	점검 대상	실행 또는 기록	판단 기준
01	Xcode 버전	`xcodebuild -version` 및 `xcode-select -p`	프로젝트가 요구하는 도구 체인과 현재 활성 디렉터리가 일치하며, 명령줄과 그래픽 인터페이스가 서로 다른 버전을 가리키지 않습니다.
02	종속성 캐시	먼저 잠금 파일을 기록한 뒤 Swift Package, CocoaPods 또는 프로젝트 자체 캐시 상태를 확인하세요.	잠금 파일이 의도치 않게 변경되지 않았는지 확인하세요. 현재 오류와 관련된 캐시만 정리하고 재사용 가능한 모든 종속성을 삭제하지 마세요.
03	서명 자료	대상, bundle 식별자, 인증서 유효성과 provisioning profile의 대응 관계를 확인하세요.	자료가 현재 빌드 대상과 일치하며 비밀번호와 비공개 내용이 로그, 저장소 또는 티켓 첨부 파일에 포함되지 않아야 합니다.
04	디스크 공간	`df -h`、프로젝트 디렉터리 크기 및 DerivedData 크기를 확인하세요.	빌드 디렉터리, 종속성, 아카이브와 임시 파일을 위한 공간이 충분하며 비정상적으로 커진 디렉터리를 별도로 식별합니다.
05	전체 로그	다음 명령으로 `tee` 출력을 동시에 표시하고 저장하며 명령, 시간과 종료 코드를 기록하세요.	로그에 최초 오류, 맥락과 최종 종료 상태가 포함되어 다른 엔지니어가 같은 명령으로 재현할 수 있어야 합니다.

종속성 문제

잠금 파일을 먼저 비교한 뒤 캐시를 정리하세요

종속성 해석이 갑자기 바뀌었다면 먼저 커밋 전후의 잠금 파일 차이, 패키지 소스 설정과 네트워크 결과를 확인하세요. 캐시 자체가 손상된 것이 확인된 경우에만 해당 범위를 삭제해 재현 가능한 문제를 일회성 상태로 만들지 마세요.

서명 문제

자료 누락과 대상 불일치를 구분하세요

인증서를 사용할 수 없거나, 프로비저닝 프로파일과 bundle 식별자가 일치하지 않거나, 빌드 대상을 잘못 선택했을 수 있습니다. 오류 코드와 대상 이름은 기록하되 인증서 비밀번호, 개인 키 또는 전체 서명 자료를 티켓에 입력하지 마세요.

로그 문제

첫 실패의 전체 맥락을 보존하세요

반복 실행하면 캐시와 임시 파일이 달라질 수 있습니다. 첫 실패 후 먼저 로그, 명령, workspace 상태와 디스크 정보를 저장한 다음 한 번에 하나의 변수만 바꿔 재시험하세요. 변경으로 문제가 실제로 해결됐는지 판단하기 쉽습니다.

세션 및 결과물 전달

원격 개발 세션과 파일 전달을 각각 복구 가능하게 만들기

원격 창은 작업 진입점일 뿐 작업 상태를 저장하는 유일한 장소가 되어서는 안 됩니다. 명령, 로그, 결과물과 체크섬을 모두 명확한 디렉터리에 저장하세요.

원격 세션

연결 전과 종료 전에 각각 상태를 확인하세요

01
연결 전 준비
로컬 네트워크, 호스트 지문, 대상 사용자 이름과 프로젝트 자료 출처를 확인하세요. 민감한 파일은 작업에 필요할 때만 가져옵니다.
02
장시간 작업을 창에서 분리
빌드나 실험이 복구 가능한 세션 관리 방식으로 실행되게 하고 표준 출력을 로그 파일에도 동시에 기록하세요.
03
종료 전 정리
파일이 저장되고 작업 상태가 기록되었는지 확인한 후 그래픽 인터페이스나 SSH 세션을 종료하세요. 저장하지 않은 편집 내용을 창에 남겨두지 마세요.
04
권한 회수
팀원이 떠나거나 작업이 끝난 후 더 이상 필요하지 않은 키와 접근 권한을 취소하고 공유 디렉터리를 확인하세요.

파일 전달

결과물·로그·민감한 자료를 분리해 처리하세요

01
쓰기 중지
빌드가 끝났는지 확인한 후 결과물을 아카이브하세요. 아직 생성 중인 디렉터리나 데이터베이스 파일을 전송하지 마세요.
02
목록 생성
파일 이름, 빌드 버전, 환경 버전, 생성 명령과 체크섬을 기록해 수신자가 무결성을 확인할 수 있게 하세요.
03
다운로드 검토
로컬에서 압축을 풀고 주요 파일을 확인하세요. 아카이브가 빈 디렉터리가 아니며 필요한 로그가 누락되지 않았는지 확인합니다.
04
민감한 파일 정리
팀 정책에 따라 임시 키, 토큰, 서명 자료와 더 이상 필요하지 않은 모델 사본을 삭제하되 공개 가능한 빌드 기록은 보존하세요.

MLX 실험 점검 항목

모델·환경·메모리 한계를 먼저 기록한 뒤 실험 결과를 논의하세요

MLX는 Apple Silicon의 통합 메모리를 사용합니다. 모델 파일, 런타임 사용량, 컨텍스트 길이와 중간 결과가 모두 사용 가능한 공간에 영향을 주므로 모델 파일 크기만 확인해서는 안 되며, 단일 실행 시간만으로 환경 성능을 판단해서도 안 됩니다.

세 등급 모두 독점 물리 서버입니다. 기본형은 M4, 16GB 메모리와 256GB 스토리지를 사용하고, 고급형은 M4, 24GB 메모리와 512GB 스토리지를 사용하며, 고메모리형은 M4 Pro, 64GB 메모리와 2TB 스토리지를 사용합니다. 구체적인 선택은 모델, 데이터셋과 동시 작업의 실제 사용량을 기준으로 결정하세요.

01

실험 환경 격리

각 프로젝트의 Python 환경과 종속성 버전을 고정하고 재현 가능한 종속성 목록을 저장하세요. 시스템 환경에 여러 실험 버전을 섞어 설치하지 마세요.

02

모델 파일 용량 확인

다운로드 패키지, 압축 해제 후 파일, 캐시와 출력 디렉터리의 크기를 각각 기록하고 임시 파일을 위한 공간을 남겨 실험 중 디스크 부족으로 중단되지 않게 하세요.

03

메모리 등급 선택

활성 상태 모니터 정보나 명령줄로 최대 사용량을 기록하세요. 시스템에 계속 뚜렷한 메모리 압박이 나타나면 동시 작업을 줄이거나 작업 규모를 축소하거나 설정을 조정하세요. 단순히 반복 실행하지 마세요.

04

실험 로그 보존

코드 버전, 종속성 버전, 모델 식별자, 매개변수, 입력 요약, 출력 위치와 오류 정보를 기록해 다음 실행이 같은 조건에서 재현되도록 하세요.

지원 요청 제출 전

티켓을 재현 가능한 기록으로 정리하세요

지원팀은 문제가 어느 주문, 어느 노드, 어느 단계와 어느 시간대에 발생했는지 알아야 합니다. 정보가 구체적일수록 바로 진단을 시작하기 쉽습니다.

주문 식별자

콘솔에 표시되는 주문 식별자를 제공하고 결제 증빙이나 전체 결제 정보를 보내지 마세요.

필수

물리 서버

주문에 사용된 서버와 현재 연결 경로를 명시해 네트워크 경로와 환경 범위를 구분할 수 있게 하세요.

필수

발생 시간

시간대가 포함된 시간을 사용하고 문제가 계속 발생하는지, 간헐적인지 또는 한 번의 작업에서만 발생했는지 설명하세요.

필수

재현 단계

정상 상태에서 시작해 명령, 매개변수, 예상 결과와 실제 결과를 순서대로 나열하고 중간 작업을 생략하지 마세요.

필수

민감 정보 제거 로그

전체 오류 맥락과 종료 코드를 첨부하되 개인 키, 토큰, 인증서 비밀번호, 저장소 자격 증명과 프로젝트의 민감한 내용을 삭제하세요.

첨부 권장

바로 작업을 시작할 수 있는 클라우드 Mac이 필요하신가요?

Oak M4, Oak M4 Plus 또는 Oak M4 Pro를 선택하고 작업 기간에 맞춰 독점 물리 서버를 대여하세요. 주문 후 콘솔에서 주문, 연결 정보와 지원 티켓을 확인할 수 있습니다.

클라우드 Mac 대여 구성 및 가격 보기