클라우드 Mac 지원 센터: SSH 시작하기, macOS 재설치, 문제 해결

네 가지 채널

급한 정도에 따라 가장 빠른 길을 선택하세요

자가 문서가 가장 빠르고, 티켓이 가장 폭넓으며, 이메일은 기록을 남기기에 적합합니다. 상태 페이지에서 먼저 "플랫폼 문제인지" 확인해 보세요.

문서 센터

이 페이지에 시작하기, 재설치, CI/CD, 문제 해결 매뉴얼이 모두 모여 있으며 명령어를 그대로 복사해 쓸 수 있습니다.

바로 아래에서 확인 →

티켓 시스템

콘솔에 로그인해 티켓을 등록하면 서버 정보가 자동으로 연결되며, 긴급 장애는 우선 처리를 선택할 수 있습니다.

콘솔에서 등록하기 →

이메일 지원

support@hirevps.com, 스크린샷이나 로그처럼 기록이 필요한 문의에 적합합니다.

이메일 보내기 →

상태 페이지

모든 리전의 실시간 가용성을 한눈에 확인할 수 있어, 문의 전에 먼저 확인하면 시간을 절약할 수 있습니다.

실시간 상태 보기 →

빠른 시작

접속 정보를 받은 후 첫 10분

개통 후 2분 안에 콘솔과 이메일로 SSH/VNC 접속 정보를 받게 됩니다. 아래 세 단계를 따라가면 10분 안에 데스크톱에서 바로 작업을 시작할 수 있습니다.

1. 첫 SSH 로그인

접속 정보에 있는 호스트명은 jp1-1024.hirevps.com과 같은 형태이며, 시스템 기본 터미널로 바로 연결할 수 있습니다:

# replace host and user with your credentials
ssh omac@jp1-1024.hirevps.com
# first login: change your password
passwd

로그인 후 바로 비밀번호를 변경하고, 콘솔에서 SSH 공개 키를 등록한 뒤 비밀번호 로그인을 비활성화하면 더 안전하고 편리합니다.

2. VNC/화면 공유 활성화

인도 시점에는 화면 공유가 기본적으로 활성화되어 있습니다. 직접 껐다면 SSH로 접속해 한 줄 명령으로 다시 켤 수 있습니다:

# enable macOS remote management (screen sharing)
sudo /System/Library/CoreServices/RemoteManagement/ARDAgent.app/Contents/Resources/kickstart \
  -activate -configure -access -on -restart -agent

Mac에서는 "화면 공유" 앱을, Windows/Linux에서는 임의의 VNC 클라이언트를 사용하세요. 주소는 호스트명, 포트는 5900번입니다.

3. 개발 환경 점검 체크리스트

제공되는 이미지에는 Homebrew, Git, Xcode Command Line Tools가 미리 설치되어 있습니다. 터미널에서 xcodebuild -version과 brew --version으로 버전을 확인하세요.
CI/CD 환경이라면 먼저 전체 빌드를 한 번 실행해 기준값을 잡아두세요: 콜드 스타트와 증분 빌드 소요 시간을 기록해두면 이후 성능 문제를 비교 분석할 수 있습니다.
인증서와 키는 별도의 키체인에 보관하고 빌드 스크립트에서 명시적으로 잠금을 해제하는 것을 권장합니다. 그래야 화면이 잠긴 상태에서 서명이 실패하는 것을 방지할 수 있습니다.
서비스를 해지하기 전에 코드와 산출물을 저장소나 오브젝트 스토리지로 동기화하세요. 초기화 후에는 데이터를 복구할 수 없습니다(이용 약관의 데이터 경계 조항 참고).

자주 사용하는 기능

재설치, 버전 변경, 데이터 이전 모두 콘솔에서 몇 번의 클릭으로

이 세 가지 작업은 모두 직접 처리할 수 있어 티켓을 등록할 필요가 없습니다. 재설치와 버전 변경은 무료이며 횟수 제한도 없습니다.

macOS 재설치

콘솔 → 인스턴스 선택 → "시스템 재설치"에서 버전을 선택하고 확인하면 전체 과정에 약 15~25분이 걸립니다(실측 기준).

재설치는 SSD 전체를 초기화합니다. 코드를 원격 저장소로 푸시하고 산출물을 복사해 둔 뒤 확인을 클릭하세요.

OS 버전 변경

현재 정식 버전과 이전 메이저 버전(예: Sequoia / Sonoma) 중에서 선택할 수 있으며, 일부 리전은 베타 이미지도 제공합니다. 자세한 내용은 콘솔 목록을 참고하세요.

버전 변경도 재설치 과정을 거치므로 마찬가지로 디스크가 초기화됩니다. 다중 버전 호환성 테스트가 필요하다면 일 단위로 새 서버를 열어 테스트 후 바로 해지하는 방법을 권장합니다.

스냅샷 및 데이터 마이그레이션

재설치 전에는 APFS 로컬 스냅샷으로 안전장치를 마련할 수 있으며, 서버 간 이전에는 rsync를 추천합니다:

# create a local snapshot before risky changes
tmutil localsnapshot
# sync your workspace to the new machine
rsync -avz ~/work/ omac@new-host:~/work/

당사는 서버 내 데이터를 읽거나 백업하지 않습니다(개인정보 보호정책 참고). 중요한 데이터는 반드시 직접 원격 저장소나 오브젝트 스토리지에 정기적으로 동기화해 주세요. 로컬 스냅샷도 재설치하면 함께 삭제됩니다.

CI/CD 연동

이 Mac을 빌드 노드로 활용하세요

독점 전용 물리 서버 + root 권한으로 주요 CI 도구와 연동할 때 표준 공식 절차만 따르면 됩니다. 별도의 커스텀 설정이 필요 없습니다. 사용 중인 도구를 선택하세요:

self-hosted 러너 연동하기

저장소나 조직의 Actions 설정 페이지에서 "새 self-hosted runner 추가(macOS / ARM64)"를 선택하고, 표시된 다운로드 및 설정 명령을 클라우드 Mac 터미널에 붙여넣어 실행하세요:

# run these on your cloud Mac (values come from your Actions settings page)
./config.sh --url <your-repo-url> --token <runner-token> \
  --labels macos,arm64,hirevps
# install as a service so it survives reboots
./svc.sh install && ./svc.sh start

워크플로에서 runs-on을 [self-hosted, macos, arm64]로 바꾸면 됩니다. M4 전용 물리 서버에서 실행하는 xcodebuild는 보통 GitHub 호스팅 러너보다 훨씬 빠르며, 정확한 차이는 프로젝트별 실측 결과에 따라 다릅니다.

Jenkins 노드 연동하기

Jenkins "노드 관리"에서 새 에이전트를 추가하고(시작 방식은 inbound 선택) 클라우드 Mac에서 에이전트 프로세스를 실행하세요:

# download agent.jar from your Jenkins controller first
java -jar agent.jar \
  -url <your-jenkins-url> \
  -name hirevps-m4 \
  -secret <agent-secret> \
  -workDir ~/jenkins-agent

launchd를 이용해 에이전트를 부팅 시 자동 실행되는 서비스로 등록하는 것을 권장하며, 노드에 macos-arm64 태그를 붙여두면 파이프라인에서 태그 기반으로 스케줄링하기 편리합니다. 예제 plist 파일이 필요하면 티켓을 등록해 주시면 바로 전달해 드립니다.

문제 해결

자주 발생하는 세 가지 문제, 먼저 체크리스트로 확인하세요

티켓을 등록하기 전 2분만 투자해 해당 체크리스트를 따라가 보세요. 문의의 절반 이상이 2단계에서 해결됩니다.

서버에 접속할 수 없음 (SSH 시간 초과 / VNC 화면이 검게 나옴)

상태 페이지를 열어 해당 리전이 정상인지 확인하세요. 정상이라면 문제는 대부분 사용자 측 환경에 있을 가능성이 큽니다.
로컬에서 ping으로 호스트명이 응답하는지 확인하세요. 휴대폰 테더링으로 바꿔서 다시 시도해보면 회사 네트워크나 통신사가 22/5900 포트를 차단하는지 확인할 수 있습니다.
콘솔에서 인스턴스 상태를 확인하세요. "실행 중"으로 표시된다면 콘솔의 "원격 재시작"을 먼저 시도하고, 부팅 중에 멈춰 있다면 3분 정도 기다린 후 다시 새로고침하세요.
SSH 포트나 방화벽 규칙(pfctl)을 변경한 적이 있는지 확인하세요. 이는 스스로 접근을 차단하는 가장 흔한 원인이며, 콘솔의 "복구 터미널"을 이용하면 네트워크를 거치지 않고 시스템에 직접 접속해 설정을 되돌릴 수 있습니다.
위 방법을 모두 시도해도 여전히 접속이 안 되면 티켓을 등록하고 "접속 불가"에 체크해 주세요. P1로 처리합니다.

빌드 속도가 느려짐 (xcodebuild 소요 시간이 눈에 띄게 증가)

작업 자체가 바뀌지 않았는지 먼저 확인하세요. 의존성 업그레이드나 Xcode 메이저 버전 업데이트 후 첫 빌드는 인덱스와 캐시를 다시 구축하므로 한 번 느려지는 것은 정상입니다.
top -o cpu로 비정상적으로 CPU를 점유하는 프로세스가 있는지 확인하세요. Spotlight가 처음 인덱싱할 때 CPU를 모두 사용할 수 있는데, mdutil -a -i off로 비활성화할 수 있습니다.
CI가 매번 DerivedData를 비우고 있는지 확인하세요. 캐시 디렉터리를 유지하면 증분 빌드 시간을 크게 줄일 수 있는 경우가 많습니다.
df -h로 디스크 여유 공간을 확인하세요. SSD 사용량이 90%를 넘으면 쓰기 성능이 저하되므로 먼저 공간을 정리한 뒤 다시 비교해 보세요.
사용 중인 서버는 독점 전용 물리 서버이므로 다른 사용자와 자원을 나눠 쓸 일이 없습니다. 위 요인을 모두 배제했는데도 계속 느려진다면 이전 빌드와 현재 빌드 로그를 첨부해 티켓을 등록해 주시면 하드웨어 레벨을 점검해 드립니다.

디스크 용량 부족 (No space left on device)

먼저 용량을 많이 차지하는 항목을 찾으세요: du -sh ~/Library/Developer/* — Xcode의 DerivedData, 사용하지 않는 시뮬레이터 런타임, Archives가 보통 가장 많은 공간을 차지합니다.
안전하게 정리: rm -rf ~/Library/Developer/Xcode/DerivedData로 삭제하고, 사용하지 않는 시뮬레이터 런타임은 xcrun simctl runtime delete로 삭제하세요.
APFS 로컬 스냅샷도 공간을 차지합니다. tmutil listlocalsnapshots /로 확인하고 tmutil deletelocalsnapshots로 오래된 스냅샷을 삭제하세요.
CI 서버라면 파이프라인에 정기적인 정리 단계를 추가하는 것을 권장합니다. 용량이 가득 찰 때까지 기다리지 마세요.
정리해도 여전히 부족하다면 업그레이드가 필요한 시점입니다. SSD 업그레이드는 차액만 결제하면 되고, 데이터 마이그레이션 방법은 위 매뉴얼을 참고하거나 요금제 페이지에서 더 큰 플랜을 바로 선택할 수 있습니다.

SLA 및 응답 시간

문서로 남긴 명확한 응답 약속

티켓은 영향 범위에 따라 3단계로 분류되며, 등급은 등록 시 선택한 내용을 저희가 검토해 확정합니다. 실제로 지킬 수 있는 내용만 약속합니다.

티켓 등급별 응답 시간 비교표
등급	대표 사례	최초 응답	서비스 시간
P1 긴급	서버 접속 불가, 하드웨어 장애, 리전 서비스 중단	30분 이내	연중무휴 24시간
P2 장애	성능 이상, 재설치 중단, 네트워크 간헐적 불안정	4시간 이내	연중무휴 24시간
P3 일반	이용 관련 문의, 결제 관련 문의, 설정 제안	12시간 이내	영업일 기준

가용성 및 보상 규정

단일 인스턴스의 월간 가용성 목표는 99.9%이며, 모든 리전은 연중 365일 계획된 중단 없이 운영됩니다.
실측 가용성이 목표치보다 0.1% 낮아질 때마다 해당 월 이용료의 5%에 해당하는 크레딧을 보상하며, 월 최대 보상 한도는 해당 인스턴스 월 이용료의 100%입니다.
보상은 콘솔에서 신청하며 장애 발생 시간대만 첨부하면 됩니다. 모니터링 데이터와 대조해 산정한 뒤 영업일 기준 7일 이내에 지급합니다.
불가항력이나 사용자 측 작업(예: 시스템 파일 삭제, 네트워크 설정 오류)으로 인한 서비스 중단은 보상 범위에 포함되지 않지만, 복구는 그래도 도와드립니다.

가장 빠르게 응답받는 티켓 작성법

콘솔에 로그인해 티켓을 등록하면 서버 번호와 리전 정보가 자동으로 첨부되어 이메일보다 확인 과정이 한 단계 줄어듭니다.
"언제, 무엇을 했는지, 어떤 오류가 발생했는지"를 명확히 적고 스크린샷 대신 오류 텍스트 전체를 붙여넣으면 문제 파악 시간을 크게 줄일 수 있습니다.
P1 문제는 티켓에서 바로 "긴급"에 체크해 주세요. 이메일로 보내면 P3 기준으로 처리됩니다.
전체 보상 조항은 이용 약관을 참고하시고, 세부 내용은 약관 원문을 기준으로 합니다.

연중 365일 운영 · 계획된 중단 없음

서비스 상태와 공지, 한 페이지에서 확인

싱가포르, 도쿄, 서울, 홍콩, 미국 서부 세 리전의 실시간 가용성, 과거 데이터, 이벤트 공지가 모두 상태 페이지에 공개되어 있습니다. 서비스에 영향을 주는 이벤트가 발생하면 진행 상황도 같은 페이지에서 계속 업데이트됩니다. 문의하기 전에 먼저 확인하면 "플랫폼 문제"인지 "내 환경 문제"인지 바로 구분할 수 있습니다.

실시간 상태 페이지 열기 콘솔에서 이벤트 알림 구독하기

JP 도쿄실시간 가용성과 과거 데이터는 상태 페이지 참고
SG 싱가포르실시간 가용성과 과거 데이터는 상태 페이지 참고
US-W 미국 서부실시간 가용성과 과거 데이터는 상태 페이지 참고

클라우드 Mac에 문제가 생겼나요? 먼저 매뉴얼로 직접 해결해 보세요