개발 작업 지원

상황을 먼저 보존하고, 작업 흐름을 따라 문제를 찾으세요

연결 실패, 빌드 오류와 성능 저하는 대개 서로 다른 문제입니다. PingMini는 개통, 접속, 도구 체인, 작업 실행, 스토리지와 계정의 6개 경로로 문제를 정리해 각 단계에 입력값, 확인 작업과 검증 가능한 결과를 제공합니다.

콘솔에서 티켓 제출 원격 연결 가이드 보기

6개 진입점: 현재 작업에 맞는 경로 선택
5가지 상황 정보: 주문, 노드, 시간, 오류 및 단계
2가지 문의 채널: 콘솔 티켓 또는 지원 이메일

BUILD SUPPORT BOARD 작업 상황 분류

문제 해결 준비

ACCESS

주소와 지문 확인

네트워크

XCODE

버전을 고정하고 빌드 재현

로그

RUNNER

실패 작업 디렉터리 격리

작업

STORAGE

공간과 캐시 증가량 확인

용량

발생 시간과 마지막 정상 상태를 먼저 기록 CASE READY

진입점 선택

오류 코드가 아니라 현재 작업에서 시작하세요

현재 막힌 지점과 가장 가까운 진입점을 먼저 선택하세요. 각 경로에는 보존해야 할 정보와 다음 작업이 정리되어 있습니다. 여러 경로에 걸친 문제라면 이상이 처음 발생한 단계에서 시작하세요.

최초 개통

연결 정보가 아직 확인되지 않음

주문을 완료한 직후 노드, 모델, 호스트 주소, 로그인 방식과 초기 네트워크 상태를 확인해야 하는 경우에 적합합니다.

개통 확인 항목 보기

원격 연결

세션, 네트워크 또는 인증 정보 문제

그래픽 데스크톱, SSH, 호스트 지문, 연결 시간 초과, 키보드 레이아웃 또는 클립보드 정책 관련 문제에 사용합니다.

연결 경로 확인

개발 환경

Xcode와 도구 체인이 일치하지 않음

버전 전환, 명령줄 도구, 인증서와 프로비저닝 프로파일, 의존성 캐시 및 빌드 로그를 확인할 때 사용합니다.

도구 체인 문제 해결

CI/CD

셀프 호스팅 작업 실행 실패

작업 등록, 작업 디렉터리 권한, 키체인 접근, 동시 실행 정책과 실패 작업 정리가 하나의 흐름으로 이어지는지 확인하세요.

작업 실행 흐름 확인

스토리지 및 성능

공간이 늘거나 작업이 느려짐

시스템 디스크, 추가 SSD, 빌드 캐시와 프로젝트 데이터를 구분해 용량 문제를 연산 성능 문제로 오해하지 않도록 하세요.

용량 계획 보기

계정 및 주문

주문, 갱신 또는 권한 확인 필요

주문 번호, 노드 코드, 발생 시간과 작업 범위를 준비한 뒤 콘솔에서 서비스 상태와 연결된 요청을 제출하세요.

지원 요청 준비

최초 사용 경로

네 번의 확인으로 재현 가능한 출발점 만들기

첫 연결에서 프로젝트를 이전하고 도구 체인을 변경하며 자동화 작업까지 추가하지 마세요. 먼저 노드, 인증 정보와 네트워크가 작동하는지 확인한 뒤 개발 환경을 단계적으로 추가하세요.

01

연결 정보 확인

콘솔에서 해당 주문을 열고 호스트 주소, 연결 방식, 계정 이름과 노드 코드를 기록하세요. 스크린샷만 저장하지 말고 주문 번호와 연결 정보를 팀이 관리할 수 있는 인수인계 기록에 남기세요.

결과: 필드 완비
02

노드와 모델 확인

주문의 노드, 칩, 메모리와 SSD가 실제 용도에 맞는지 확인하세요. 세 가지 구성은 각각 M4 / 16GB / 256GB, M4 / 24GB / 512GB, M4 Pro / 64GB / 2TB입니다.

결과: 구성 일치
03

최초 로그인 후 인증 정보 변경

먼저 최소 세션을 한 번 열어 데스크톱 또는 명령줄에 접속되는지 확인한 뒤 초기 인증 정보를 변경하세요. 변경 직후 로그아웃하고 다시 연결해 새 인증 정보가 실제로 적용됐는지 확인하세요.

결과: 재로그인 성공
04

네트워크 및 기본 명령 확인

DNS 확인, 코드 저장소 접근과 의존성 소스 연결을 점검하고 시스템 상태를 변경하지 않는 기본 명령을 실행하세요. 이후 경로 문제를 구분할 수 있도록 로컬 네트워크, 클라이언트와 실패 시간을 기록하세요.

결과: 기준선 재현 가능

Xcode 및 도구 체인

“빌드 실패”를 버전·권한·캐시·로그로 나눠 확인하세요

같은 코드가 환경에 따라 다른 결과를 내면 먼저 도구 체인 입력을 고정하세요. Xcode를 업그레이드하고 캐시를 삭제한 뒤 우연한 한 번의 성공으로 문제가 해결됐다고 판단하지 마세요.

권장 확인 순서

VERSION

현재 Xcode와 명령줄 도구 확인

그래픽 버전, 빌드 번호와 명령줄 도구가 실제로 가리키는 대상을 기록하세요. 프로젝트, 스크립트와 CI는 확인 가능한 동일 도구 체인을 사용해야 합니다.

버전 기록

SIGNING

인증서와 프로비저닝 프로파일 범위 확인

파일 존재 여부와 권한을 확인하고 CI 실행 계정이 필요한 키체인에 접근할 수 있는지 점검하세요. 오류가 해석, 아카이브 또는 서명 중 어느 단계에서 발생했는지도 기록하세요.

권한 범위

CACHE

캐시를 단계별로 정리

먼저 프로젝트 파생 데이터를 정리하고, 다음으로 패키지 관리자 캐시를 처리한 뒤, 마지막으로 더 넓은 환경 정리를 고려하세요. 매번 한 계층만 변경하고 동일한 빌드를 다시 실행하세요.

단일 변수 재테스트

LOG

첫 번째 실제 오류 보존

전체 로그에서 가장 이른 실패 단계, 명령, 대상과 종료 코드를 찾으세요. 마지막 요약 한 줄만 복사하지 마세요.

전체 로그

제출 전 보존

최소 빌드 증거 패키지

Xcode 및 명령줄 도구 버전
프로젝트 대상과 실패 단계
전체 명령, 종료 코드와 로그 일부
마지막 성공 빌드와의 차이

문의 정보 요구사항 보기

오판 방지

환경을 한 번에 모두 변경하지 마세요

버전 업그레이드, 의존성 재설치, 캐시 삭제와 서명 자료 교체를 동시에 하면 빌드가 복구되어도 실제 원인을 확인할 수 없습니다. 매 라운드마다 입력 하나만 변경하세요.

워크플로 사례 보기

CI/CD 문제 해결

러너 상태를 먼저 확인한 뒤 실패 작업을 다시 실행하세요

자동화 실패는 등록 상태, 실행 계정, 작업 디렉터리, 키체인 또는 동시 실행 충돌에서 발생할 수 있습니다. 작업 수명 주기에 따라 확인해 근본 원인을 가리는 러너 재등록을 반복하지 마세요.

1단계

작업 등록 상태 확인

러너가 온라인인지, 태그가 일치하는지, 실행 계정이 예상한 계정인지 확인하세요. 작업이 할당되지 않았다면 먼저 큐 규칙과 태그를 점검하고 도구 체인을 바로 재설치하지 마세요.

입력: 러너 이름, 태그, 큐 상태
검수: 최소 테스트 작업이 할당됨

2단계

디렉터리 및 키체인 권한 확인

실제 실행 계정으로 작업 디렉터리, 캐시 디렉터리와 산출물 디렉터리의 읽기·쓰기 권한을 확인하고 빌드에 필요한 키체인에 접근할 수 있는지도 별도로 검증하세요.

입력: 실행 계정, 디렉터리 경로, 권한 결과
검수: 권한 상승 없이 최소 빌드 완료

3단계

동시 실행 제한 및 잔여 항목 정리

동시 실행 수를 관리 가능한 범위로 낮추고 잔여 프로세스, 잠금 파일, 임시 디렉터리와 미완료 아카이브를 확인하세요. 실패 작업이 끝난 뒤에는 환경을 계속 점유하지 않도록 명확한 정리 정책을 적용하세요.

입력: 동시 실행 수, 프로세스 목록, 디스크 사용량
검수: 연속 재실행 결과가 일관됨

등록 상태 정상 권한 명확 단일 작업 통과 동시 실행 단계적 복구

SSH로 Mac 연결

키, 지문, 네트워크와 권한을 나눠 확인하세요

연결 시간 초과와 인증 실패는 서로 다른 단계의 문제입니다. 먼저 네트워크가 호스트에 도달하는지 확인한 다음 호스트 지문과 키 권한을 점검하고 마지막으로 비대화형 명령을 검증하세요.

최소 연결 절차

명확한 매개변수로 깨끗한 세션을 먼저 한 번 만드세요

키 준비:현재 용도에 맞는 독립 키를 만들고 개인 키 파일 권한을 제한하세요. 동일한 개인 키를 여러 사람에게 복사하지 마세요.
지문 확인:처음 연결하기 전에 신뢰할 수 있는 주문 정보로 호스트 주소를 확인하세요. 지문이 바뀌면 먼저 연결을 중지하고 원인을 파악하세요.
시간 초과 확인:로컬 네트워크, 외부 연결 정책, 호스트 주소와 포트를 확인하세요. 시간 초과를 비밀번호 오류로 오인하지 마세요.
권한 최소화:작업에 필요한 최소 계정 권한만 사용하고 비대화형 명령으로 자동화 가능 여부를 확인하세요.

ssh -i ~/.ssh/pingmini_ed25519 user@host
ssh -i ~/.ssh/pingmini_ed25519 user@host "uname -a"

연결 시간 초과

도달 경로 확인

로컬 네트워크, 호스트 주소, 포트, 발생 시간과 클라이언트 오류를 기록하세요. 먼저 네트워크 도달성을 확인한 뒤 인증을 처리하세요.

출력: 연결 결론

인증 실패

키와 계정 확인

사용한 개인 키, 대상 계정, 파일 권한과 서버 측 허용 범위를 확인하세요. 확실하지 않은 인증 정보를 계속 시도하지 마세요.

출력: 권한 결론

전체 연결 가이드 보기 연결 문제 티켓 제출

스토리지 및 성능

어떤 데이터가 늘고 있는지부터 확인하세요

시스템 디스크, 추가 SSD, 프로젝트 데이터와 빌드 캐시는 수명 주기가 다릅니다. 용량 계획에는 현재 프로젝트, 최대 빌드, 아카이브 산출물과 임대 종료 전 이전 공간을 함께 고려해야 합니다.

클라우드 Mac 스토리지 유형, 적합한 콘텐츠 및 문제 해결 방법
스토리지 범주	적합한 콘텐츠	중점 확인	권장 작업
시스템 디스크	운영체제, 도구 체인, 필수 앱과 기본 구성	가용 공간, 임시 파일과 도구 체인 버전 수	아카이브 산출물을 장기간 쌓지 말고 안전 여유 공간을 확보하세요
추가 SSD	대형 프로젝트, 에셋, 모델, 빌드 산출물과 팀 인수인계 데이터	지속 쓰기량, 프로젝트별 최대 사용량과 이전 소요 시간	활성 데이터와 아카이브 데이터를 디렉터리별로 관리하세요
빌드 캐시	파생 데이터, 의존성 캐시와 재생성 가능한 중간 파일	적중률, 증가 속도와 실패 작업 잔여물	정리 규칙을 설정하고 유일한 프로젝트 데이터와 섞어 보관하지 마세요
프로젝트 데이터	코드, 구성, 에셋, 테스트 데이터와 최종 전달 파일	독립 복사본, 권한 범위와 인수인계 담당자 여부	프로젝트별 백업 및 임대 종료 전 이전 목록을 만드세요

용량 기준선

여유 공간과 일일 증가량 기록

프로젝트를 가져오기 전에 초기 사용량을 기록하고, 정상 운영 후 일반적인 업무일의 증가량을 기록하세요. 두 데이터를 통해 지속 증가, 갑작스러운 아카이브 또는 실패 작업 잔여물인지 판단할 수 있습니다.

최대 사용량 여유

입력, 중간 파일과 산출물을 동시에 수용

동영상 트랜스코딩, 대형 아카이브와 모델 테스트에서는 원본, 중간 파일과 출력 결과가 동시에 남을 수 있습니다. 최종 산출물 크기만으로 공간을 선택하지 마세요.

성능 판단

디스크 부하와 연산 부하 구분

작업 시간, 가용 공간, 동시 실행 수와 캐시 상태를 기록하세요. 공간이 한계에 가까워지거나 자주 정리하거나 여러 작업이 같은 디렉터리를 사용하면 작업이 느려질 수 있습니다.

보안 대응 절차

이상이 발견되면 먼저 접근 범위를 좁히세요

인증 정보 유출 의심, 비정상 로그인, 구성원 인수인계와 임대 종료는 서로 다른 네 가지 상황이지만 확산 중지, 기록 보존, 접근 권한 교체와 정리 확인 순서를 따라야 합니다.

이상 상황 정보 기록

주문 번호, 노드, 발견 시간, 이상 출처, 영향을 받은 계정과 최근 정상 작업을 정리하고 필요한 클라이언트 및 작업 로그를 보존하세요.

인증 정보와 키 교체

영향받은 로그인 인증 정보, SSH 키와 자동화 접근 자료를 교체하고 더 이상 필요하지 않은 팀원 권한을 철회하세요. 한 곳만 변경한 뒤 기존 키를 계속 재사용하지 마세요.

확인 후 정리 완료

필요한 접근을 다시 테스트하고 이전 인증 정보가 무효화됐는지 확인하세요. 프로젝트 인수인계 또는 임대 종료 전에 프로젝트 데이터, 빌드 산출물, 키와 인증서 자료를 이전한 뒤 목록에 따라 노드를 정리하세요.

지원 요청 경로

충분한 정보를 담아 바로 문제 해결로 연결하세요

일반 문의와 서비스 사용 중 문제는 영향도와 실행 가능한 상황 정보에 따라 처리됩니다. 정보가 완전할수록 기본 필드를 다시 확인하는 과정이 줄어듭니다.

제출 전 필요한 5가지 정보

주문 번호

모델, 임대 기간과 서비스 기록을 연결하는 데 사용합니다.

노드 코드

주문과 일치하는 SG, JP, KR, HK 또는 US-E 중 하나를 입력하세요.

발생 시간

시간대를 명시하고 마지막 정상 작업 시간도 추가하세요.

오류 메시지

전체 텍스트, 종료 코드와 최초 실패 위치를 보존하세요. 잘린 스크린샷만 제출하지 마세요.

재현 단계

작동하는 시작점부터 명령, 입력, 예상 결과와 실제 결과를 단계별로 작성하세요.

서비스 사용 중 문제

콘솔 티켓을 우선 사용하세요

주문, 노드, 연결 또는 실행 중인 작업에 문제가 발생하면 콘솔 티켓을 통해 요청을 서비스 기록과 연결할 수 있습니다.

로그인 후 티켓 제출

일반 문의

통합 지원 이메일 사용

사양 선택, 팀 구매, 결제 또는 협업 문의는 support@pingmini.com으로 보내고 용도와 원하는 결과를 첨부하세요.

지원 이메일 보내기

연결에 실패하면 스크린샷과 텍스트 오류 중 무엇을 먼저 제출해야 하나요?

복사할 수 있는 전체 오류 텍스트, 클라이언트 이름, 발생 시간과 작업 단계를 우선 제출하세요. 스크린샷은 화면 상태를 보완할 수 있지만 호스트 주소 확인, 종료 코드와 네트워크 단계 판단을 대신할 수 없습니다.

빌드가 가끔 성공하면 노드가 정상으로 복구됐다는 뜻인가요?

한 번의 성공만으로 결론을 내릴 수 없습니다. 고정된 Xcode 버전, 동일한 코드 커밋, 동일한 의존성과 동시 실행 조건에서 연속으로 다시 실행하고 성공과 실패 사이의 입력 차이를 기록하세요.

작업이 느려지면 바로 모델을 업그레이드해야 하나요?

먼저 CPU, 메모리, 가용 공간, 캐시 상태, 동시 실행 수와 작업 단계를 기록하세요. 병목이 공간 부족, 디렉터리 경합 또는 실패 작업 잔여물에서 비롯됐다면 구성만 변경해도 원인은 해결되지 않습니다.

다음 단계

상황 정보를 준비한 뒤 지원팀에 문제를 전달하세요

아직 사양을 선택 중이라면 세 가지 고정 구성을 먼저 확인하세요. 서비스가 이미 개통됐다면 주문 번호, 노드, 시간, 오류 메시지와 재현 단계를 첨부해 티켓을 제출하세요.

콘솔에 로그인해 티켓 제출 구성 및 가격 보기 지금 클라우드 Mac 대여