엔지니어링 지원 가이드

문제를 먼저 찾고, 클라우드 Mac을 순서대로 복구하세요

RunAMac M4를 연결하거나 설정하는 개발 팀을 위한 안내입니다. 실행 가능한 점검 순서, 완료 기준, 지원 요청 정보 템플릿을 제공해 흩어진 답변을 찾아다닐 필요가 없습니다.

지원 범위
자주 묻는 문제 6가지
배포 참고
약 4분
지원 대상
전용 물리 머신
RUNAMAC SUPPORT RUN SHEET 문제 해결 작업 시트
먼저 수집하고, 나중에 변경하세요
INPUT
원본 오류 출력을 보관하세요

발생 시간, 노드, 명령어, 전체 오류를 먼저 기록하세요. 마지막 한 줄만 남기지 마세요.

CHECK
로컬 연결부터 호스트까지 단계별로 점검하세요

네트워크, 포트, 세션, 환경 의존성을 각각 확인하고 한 번에 하나의 조건만 변경하세요.

PROOF
재현 가능한 단계로 결과를 확인하세요

성공 기준 또는 실패 로그를 기록해 다음 담당자가 같은 결과를 재현할 수 있게 하세요.

최초 연결

네 번 확인한 후 개발 세션을 시작하세요

연결 정보는 콘솔의 배포 기록을 기준으로 하세요. 채팅 기록이나 오래된 문서에서 주소를 복사하지 말고 호스트 인증 확인도 건너뛰지 마세요.

01

이번 주문의 연결 정보 확인

콘솔에 로그인한 뒤 해당 주문과 인스턴스 세부 정보로 이동하여 노드, 호스트 주소, 포트, 사용자 이름, 연결 방식을 확인하세요. 주문이 여러 개라면 먼저 주문 번호와 노드가 일치하는지 확인하세요.

완료 기준: 주소, 포트, 사용자 이름이 모두 동일한 배포 기록에서 확인됩니다.
02

호스트 인증 확인

암호화 연결을 처음 설정하면 클라이언트에 호스트 지문이 표시됩니다. 콘솔 기록과 대조하세요. 이미 연결한 호스트에서 갑자기 인증 변경 안내가 나타나면 연결을 중지하고 지원 요청을 제출해 확인하세요.

완료 기준: 호스트 지문이 현재 인스턴스 기록과 일치합니다.
03

명령줄 또는 그래픽 세션 설정

먼저 배포 정보를 사용해 세션을 설정한 뒤 키보드 입력, 클립보드 정책, 기본 네트워크 접근이 작업 요구 사항에 맞는지 확인하세요. 지연이 큰 네트워크에서는 먼저 화면 품질을 낮춘 후 호스트 장애인지 판단하세요.

완료 기준: macOS 그래픽 인터페이스 또는 명령줄에 안정적으로 진입할 수 있습니다.
04

초기 자격 증명 변경 및 복구 정보 저장

연결에 성공하면 즉시 초기 자격 증명을 변경하고 팀에서 승인한 자격 증명 관리 방식을 사용해 저장하세요. 비밀번호, 개인 키, 인증서 내용을 빌드 로그, 지원 요청 본문, 코드 저장소에 기록하지 마세요.

완료 기준: 새 자격 증명 확인이 완료되고 이전 자격 증명은 이후 세션에 사용되지 않습니다.
인증 안내가 변경되어도 로컬 기록을 바로 덮어쓰지 마세요

안내 화면, 발생 시간, 주문 번호를 먼저 저장한 후 콘솔 지원 요청으로 확인하세요. 새 호스트 인증을 성급히 수락하면 중요한 보안 확인 기회를 잃을 수 있습니다.

배포 타임라인

주문 확인부터 연결 정보 수신까지 약 4분

각 단계에는 확인 가능한 완료 기준이 있습니다. 실제 진행 상태는 콘솔 응답을 기준으로 하며 페이지를 새로 고쳐도 제출된 주문은 변경되지 않습니다.

  1. 01 약 1분

    주문 확인

    시스템이 RunAMac M4, 이용 기간, 노드, 추가 옵션을 확인하고 이번 주문 기록을 생성합니다.

    완료 기준: 콘솔에 주문 번호와 확인된 구성이 표시됩니다.
  2. 02 약 1분

    물리 노드 할당

    주문이 선택한 지역의 전용 물리 머신에 할당되며 장비 리소스는 다른 이용자와 공유되지 않습니다.

    완료 기준: 인스턴스 세부 정보에 노드와 장비 식별자가 표시됩니다.
  3. 03 약 1분

    시스템 초기화

    시스템이 기본 접근 환경을 준비하고 필요한 인스턴스 점검을 수행합니다. 이때 같은 주문을 다시 생성하지 마세요.

    완료 기준: 인스턴스 상태가 배포 가능 단계로 전환됩니다.
  4. 04 약 1분

    연결 정보 전달

    콘솔에 호스트 주소, 포트, 사용자 이름, 호스트 인증 정보와 연결 안내가 기록됩니다.

    완료 기준: 인스턴스 세부 정보에서 전체 연결 필드를 확인할 수 있습니다.
개발 환경 체크리스트

재현 가능한 환경 기준선을 먼저 만들고 빌드 작업을 연결하세요

RunAMac은 전용 Mac mini와 완전한 macOS 사용 환경을 제공합니다. 구체적인 소프트웨어, 버전, 프로젝트 의존성은 팀이 빌드 기준에 따라 확인해야 하며 주문에 명시되지 않은 소프트웨어는 사전 설치된 것으로 간주되지 않습니다.

A

Xcode 및 활성 개발 디렉터리

프로젝트에서 요구하는 Xcode 버전을 기록하고 활성 개발 디렉터리가 빌드 스크립트와 일치하는지 확인하세요. 버전을 변경한 후 SDK, 시뮬레이터 런타임, 아카이브 명령을 다시 검증하세요.

B

명령줄 도구

컴파일러, Git, 셸, 패키지 관리 명령을 사용할 수 있는지 확인하세요. 그래픽 인터페이스에서 Xcode가 실행된다는 사실만으로 자동화 빌드가 준비되었다고 판단하지 마세요.

C

인증서 및 서명 자료

서명 인증서, 프로비저닝 프로파일, 키체인 접근 정책이 프로젝트 요구 사항에 맞는지 확인하세요. 민감한 자료는 통제된 절차로 가져오고 저장소, 일반 로그, 지원 요청 첨부 파일에는 포함하지 마세요.

D

의존성 및 캐시

의존성 잠금 파일, 캐시 디렉터리, 만료 정책을 각각 기록하세요. 최초 빌드는 캐시 없이 기준선을 실행한 다음 캐시를 활성화하여 소요 시간과 적중 결과를 비교하세요.

E

지속적 통합 실행기

실행기 태그, 작업 디렉터리, 동시 실행 수, 시작 방식, 로그 수집 경로를 확인하세요. 실행기 하나가 실패하면 작업이 다른 환경에 잘못 할당되었는지 먼저 확인하세요.

네트워크 문제 해결 가이드

연결 경로를 따라 장애 범위를 단계별로 좁히세요

네트워크, 클라이언트, 연결 매개변수를 동시에 바꾸지 마세요. 한 번에 하나의 조건만 변경해야 어느 단계에서 복구되었는지 판단할 수 있습니다.

L1

로컬 연결 점검

로컬 네트워크가 다른 서비스에 안정적으로 접근할 수 있는지 확인하고 유선, 무선, 대체 연결을 각각 테스트하세요. 지속적인 패킷 손실, 프록시 개입, 기업 네트워크 제한 여부를 기록하세요.

근거: 로컬 출구, 테스트 시간, 연속 실패 횟수.
L2

대상 노드 확인

콘솔에서 현재 인스턴스 주소를 다시 확인하여 이전 주문이나 이전 노드 정보를 계속 사용하지 않도록 하세요. RunAMac M4는 싱가포르, 일본(도쿄), 한국(서울), 홍콩, 미국 서부를 선택할 수 있습니다.

근거: 주문 번호, 노드 이름, 대상 주소.
L3

포트 정책 검증

연결 포트가 배포 기록과 일치하는지 확인하고 로컬 방화벽, 회사 네트워크 출구 정책, 보안 소프트웨어가 차단하는지 점검하세요. 테스트를 위해 보호 기능을 영구적으로 끄지 마세요.

근거: 포트, 클라이언트 오류 코드, 정책 변경 결과.
L4

세션 상태 확인

문제가 연결 설정 전, 인증 단계, 데스크톱 진입 후 중 언제 발생하는지 판단하세요. 화면만 끊기는 경우 입력 지연과 연결 중단 여부를 각각 기록하세요.

근거: 실패 단계, 지속 시간, 재현 가능 여부.
L5

진단 로그 수집

클라이언트 로그와 전체 오류 출력을 보관하고 시간대가 명확한 타임스탬프를 기록하세요. 로그에 호스트 주소, 사용자 이름, 경로가 포함되어 있다면 제출 전에 필요한 비식별 처리를 하세요.

근거: 로그 일부, 타임스탬프, 재현 단계.
지원 요청 정보 템플릿

지원팀이 바로 문제를 해결할 수 있도록 하세요

필드별로 상황을 제공하면 “연결할 수 없음”이라고만 쓰는 것보다 재현하기 쉽습니다. 비밀번호, 개인 키, 인증서 본문, 결제 자격 증명은 지원 요청에 입력하지 마세요.

주문 번호:
노드:
문제 발생 시간 및 시간대:
연결 방식 및 클라이언트 버전:
전체 오류 출력:
실행한 점검:
최단 재현 단계:
예상 결과 및 실제 결과:
스토리지 및 병렬 연결

데이터 규모와 장비 협업 방식에 따라 추가 옵션을 선택하세요

용량 부족, 비효율적인 읽기·쓰기 경로, 여러 장비 간 협업 요구 사항을 먼저 구분하세요. 추가 옵션은 선택한 이용 기간을 기준으로 과금되므로 변경 전에 데이터 이전과 작업 중단 위험을 확인하세요.

용량 확장

+1TB SSD

의존성 캐시, 여러 중형 코드 저장소, 빌드 아카이브, 테스트 결과물을 장기간 보관해야 하는 워크플로에 적합합니다. 활성화하기 전에 최대 사용량과 정리 정책을 확인하세요.

일간
$2.3
주간
$6.2
월간
$11.4
분기
$31
대용량 확장

+2TB SSD

많은 빌드 결과물, 여러 프로젝트 캐시, 소규모 AI 실험 데이터, 긴 보존 기간에 적합합니다. 용량 확장은 백업을 대신하지 않으므로 중요한 결과는 별도 복사본으로 보관하세요.

일간
$4.6
주간
$12.4
월간
$22.8
분기
$62
장비 병렬 연결

Thunderbolt 5 병렬 연결

장비별로 과금되며 장비 간 고속 연결이 명확히 필요한 협업 작업에 적합합니다. 변경 요청 전에 장비 수, 연결 관계, 데이터 방향, 검수 명령을 명시하세요.

일간
$1.9
주간
$5
월간
$9.3
분기
$25.3

변경 전에 세 가지를 확인하세요

01 현재 상태 기록

사용 중인 용량, 실행 중인 작업, 보존해야 할 데이터 경로를 확인하세요.

02 적용 주기 선택

추가 옵션과 현재 이용 기간, 콘솔에 표시된 USD 결제 금액을 확인하세요.

03 변경 결과 검증

완료 후 마운트, 사용 가능한 용량, 읽기·쓰기 권한, 작업 경로를 다시 확인하세요.

계정 및 이용 기간

주문 기록으로 이용 기간, 구성, 청구서를 관리하세요

콘솔은 배포, 이용 기간, 결제 금액을 확인하는 통합 위치입니다. 여러 인스턴스를 관리할 때는 모든 변경 전에 주문 번호와 노드를 확인하세요.

전문 지원으로 에스컬레이션

바로 재현할 수 있는 상황 정보를 제출하세요

기술 문제는 우선 콘솔 지원 요청으로 주문에 연결하세요. 구매 전 문의, 제휴 또는 계정 로그인이 불가능한 경우에는 문의 페이지에서 이메일 내용을 작성할 수 있습니다.

01

주문 및 노드

주문 번호, RunAMac M4 구성, 노드를 제공하세요. 여러 인스턴스와 관련된 문제라면 각 장비를 구분해 표시하세요.

02

타임스탬프

문제 발생 시간과 시간대를 적고 지속적으로 발생하는지, 간헐적인지, 한 번만 발생했는지 알려주세요.

03

오류 출력

전체 오류 텍스트를 붙여 넣거나 비식별 처리한 스크린샷을 제공하세요. 비밀번호, 개인 키, 인증서 본문 및 기타 비밀 자격 증명은 제출하지 마세요.

04

재현 단계

알려진 초기 상태에서 시작하여 명령어, 입력, 예상 결과, 실제 결과를 단계별로 작성하세요.

지원 요청을 제출한 후 정보는 어떻게 추가하나요?

동일한 콘솔 지원 요청에 새로운 타임스탬프, 로그, 검증 결과를 추가하세요. 같은 문제로 여러 지원 요청을 반복 생성하지 마세요. 이렇게 하면 전체 문제 해결 과정이 보존됩니다.

지원 요청이나 이메일에 어떤 내용을 넣으면 안 되나요?

비밀번호, 개인 키, 인증서 본문, 결제 자격 증명, 비식별 처리하지 않은 프로젝트 기밀을 제출하지 마세요. 경로나 사용자 이름을 설명해야 한다면 문제 해결에 필요한 최소 정보만 남기세요.

콘솔에 로그인할 수 없을 때 팀에 어떻게 연락하나요?

문의 페이지에서 구조화된 이메일을 작성하거나 다음 주소로 직접 이메일을 보내세요. support@runamac.com계정 이메일, 관련 주문 번호, 로그인할 때 표시된 오류 정보를 적어 주세요.

상황 정보를 준비했다면

문제 해결 기록을 지원팀에 전달하여 계속 처리하세요

기존 주문은 콘솔 지원 요청으로 인스턴스에 연결하세요. 구매 전 문의, 제휴 상담, 계정 접근 문제는 문의 페이지를 통해 동일한 지원팀으로 보내면 됩니다.