실행 시트

작업에 맞는 SSH 또는 브라우저 그래픽 인터페이스 선택

명령줄 빌드, 자동화 스크립트 및 장시간 작업에는 SSH를 우선 사용하세요. Xcode 조작, 그래픽 출력 확인 또는 데스크톱 앱 작업이 필요할 때만 콘솔의 기기 상세 정보에서 브라우저 원격 세션을 시작하세요.

DplyMini는 클라우드에서 사용하는 독립 물리 Mac을 제공합니다. 주문 하나당 물리 노드 하나가 배정되며 기기는 가상 머신이 아닙니다. 연결하기 전에 호스트 주소, 사용자 이름 및 호스트 지문을 확인한 후 프로젝트를 전송하거나 빌드를 실행하세요.

SSH 스크립트, 빌드 및 백그라운드 작업
브라우저 인터페이스 Xcode 및 그래픽 데스크톱 작업
노드 5개 연결 정보는 주문별로 제공
DEVICE CONNECTION SHEET RUN-SSH-GUI
연결 정보 제공 완료 주문 1건 = 독립 물리 노드 1대
명령줄 채널
SSH 공개 키 인증
그래픽 채널
콘솔 기기 상세 정보에서 시작
최초 확인
호스트 주소, 사용자 이름, 지문
권장 작업
xcodebuild, fastlane, CI Runner
확인 인증 연결 실행 종료
연결 방식 개요

먼저 그래픽 인터페이스가 정말 필요한지 판단하세요

연결 방식은 기기 설정을 바꾸지 않지만 작업 효율, 네트워크 민감도 및 세션 복구 방식에는 영향을 줍니다. 지속 작업은 백그라운드에서 실행하고, 그래픽 세션은 데스크톱을 직접 확인해야 하는 단계에만 사용하세요.

기본 방식

SSH: 반복 가능하고 기록하기 쉬운 작업에 적합

종속성 설치, 코드 가져오기, 컴파일, 테스트, 로그 확인 및 파일 검증은 SSH로 처리하는 것이 좋습니다. 네트워크가 잠시 불안정해도 tmux, screen 또는 CI Runner를 사용하면 기기에서 작업을 계속 실행할 수 있습니다.

  • xcodebuild, fastlane 및 스크립트 기반 파이프라인에 적합
  • 명령, 출력 및 오류 코드를 로그에 쉽게 보존
  • 대부분의 작업에서 데스크톱 화면을 계속 전송할 필요 없음
필요할 때 사용

브라우저 그래픽 인터페이스: 데스크톱을 직접 확인해야 하는 단계에 적합

Xcode를 열거나 시뮬레이터 화면을 확인하고 그래픽 도구를 조정하거나 데스크톱 앱 상태를 확인해야 할 때는 콘솔의 기기 상세 정보에서 원격 세션을 시작하세요. 지속적인 빌드를 브라우저 탭이 계속 열려 있어야 하는 방식으로 실행해서는 안 됩니다.

  • 짧은 상호작용, 설정 확인 및 그래픽 앱 조작에 적합
  • 사용 환경은 로컬 네트워크 안정성과 왕복 지연 시간의 영향을 크게 받음
  • 작업 후 데스크톱을 잠그고 세션을 직접 종료해야 함

간단한 판단:명령으로 표현할 수 있고 반복 실행해야 하는 단계는 SSH를 우선 사용하세요. macOS 그래픽 인터페이스를 직접 확인하거나 조작해야 하는 단계에만 브라우저 원격 액세스를 사용하세요.

SSH 준비

첫 연결 전에 네 가지 식별 정보를 모두 확인하세요

주소를 받은 즉시 여러 사용자 이름을 시도하거나 확인되지 않은 지문을 반복해서 수락하지 마세요. 먼저 콘솔의 기기 상세 정보에서 제공 정보를 확인한 뒤 로컬 터미널로 연결하세요.

  1. 01

    개인 SSH 키 생성

    각 작업자는 자신의 키를 사용하고 팀원 사이에 개인 키를 복사하지 마세요. 최신 키 유형을 사용하고 개인 키에는 로컬 보호 암호를 설정하는 것이 좋습니다.

    ssh-keygen -t ed25519 -C "deploymini-access"
  2. 02

    공개 키 내용만 제출

    공개 키는 일반적으로 ~/.ssh/id_ed25519.pub에서 가져옵니다. 개인 키 파일을 업로드하거나 채팅 기록에 붙여 넣거나 코드 저장소 또는 지원 티켓 첨부 파일에 넣지 마세요.

    cat ~/.ssh/id_ed25519.pub
  3. 03

    호스트 주소 및 사용자 이름 확인

    주소, 포트 및 사용자 이름은 현재 주문의 기기 상세 정보에 따릅니다. 다른 주문의 연결 명령을 재사용하거나 노드 이름만 보고 주소를 추측하지 마세요.

    ssh -p <port> <user>@<host>
  4. 04

    첫 연결 시 호스트 지문 확인

    터미널에서 처음 호스트를 신뢰할지 물으면 표시된 지문을 기기 상세 정보의 값과 구간별로 대조하세요. 정보가 일치하지 않으면 연결을 중단하고 지원 티켓을 제출하세요. 바로 yes를 입력하지 마세요.

    SHA256:<fingerprint-from-device-details>

키 교체 원칙

구성원이 프로젝트를 떠나거나 기기를 인계하거나 임시 협업이 끝나면 해당 공개 키를 즉시 삭제하세요. 하나의 공유 키를 팀 전체가 계속 사용하게 두지 마세요.

로컬 설정 원칙

로컬 SSH config에서 기기 별칭을 설정할 수 있지만 호스트, 포트 및 사용자 이름은 여전히 현재 콘솔에 제공된 정보가 기준입니다.

문제 발생 시 원칙

알려진 호스트 항목이 갑자기 변경되면 먼저 주문 또는 주소가 변경되었는지 확인하세요. 확인하기 전에는 기존 기록을 바로 삭제하고 새 지문을 수락하지 마세요.

브라우저 원격 액세스

기기 상세 정보에서 시작하고 세션 링크는 저장하지 마세요

  1. 콘솔에 로그인 현재 주문에 해당하는 기기 상세 정보로 이동해 노드, 모델 및 연결 상태를 확인하세요.
  2. 브라우저 세션 시작 기기 상세 정보의 원격 액세스 기능을 사용하세요. 임시 세션 주소를 북마크하거나 다른 사람에게 전달하지 마세요.
  3. 디스플레이 설정 조정 도구 모음에서 해상도 배율, 전체 화면 및 클립보드를 설정할 수 있습니다. 고해상도는 화면 전송량을 늘리므로 연결이 불안정하면 먼저 표시 크기를 낮추세요.
  4. 종료 후 기기 잠금 작업을 마치면 먼저 저장한 뒤 앱을 종료하고 데스크톱을 잠근 다음 브라우저 세션을 닫으세요.

클립보드 제어

클립보드는 짧은 텍스트와 일회성 명령에 적합하며 개인 키, 전체 결제 정보 또는 긴 민감 설정을 전송하는 데 사용해서는 안 됩니다. 복사가 끝나면 로컬 및 원격 클립보드 내용을 삭제하세요.

해상도 및 전체 화면

현재 창에 맞는 배율로 시작하세요. 정밀한 조작이 필요할 때만 전체 화면으로 전환하고, 입력 지연이 증가하면 전체 화면을 종료하고 해상도를 낮춘 뒤 연결 상태를 다시 확인하세요.

연결 및 빌드 예시

로그인, 빌드 및 전달 결과를 확인 가능한 출력으로 분리하세요

다음은 일반적인 SSH 세션의 예입니다. 실제 주소, 사용자 이름, 프로젝트 경로, Scheme 및 내보내기 설정은 주문과 프로젝트에 따라 달라집니다. 예시 매개변수를 그대로 복사하지 마세요.

build-session — ssh
SESSION ACTIVE
$ ssh -p <port> <user>@<host>
The authenticity of host cannot be established.
ED25519 key fingerprint is SHA256:<fingerprint>
Are you sure you want to continue connecting? yes

Connected to dedicated physical Mac mini
$ sw_vers
ProductName:            macOS
ProductVersion:         <installed-version>

$ cd ~/work/ExampleApp
$ xcodebuild \
  -workspace ExampleApp.xcworkspace \
  -scheme ExampleApp \
  -configuration Release \
  build

** BUILD SUCCEEDED **

$ bundle exec fastlane ios build
[fastlane] Resolving project configuration
[fastlane] Running archive workflow
[fastlane] Build artifacts ready for verification

$ shasum -a 256 ./output/ExampleApp.ipa
<checksum>  ./output/ExampleApp.ipa
확인 지점 A

빌드 전 환경 기록

macOS, Xcode, Ruby, 종속성 관리 도구 및 프로젝트 커밋 버전을 보존하세요. 차이가 발생하면 모든 종속성을 즉시 다시 설치하기보다 먼저 환경 기록을 비교하세요.

확인 지점 B

빌드 후 산출물 검증

출력 경로, 파일 크기, 체크섬 및 주요 빌드 로그를 기록하세요. 다운로드가 완료되면 수신 측에서 체크섬을 다시 계산해 전송 중 변경이 없었는지 확인하세요.

네트워크 문제 해결

연결 순서대로 확인하고 여러 변수를 동시에 변경하지 마세요

한 번에 한 계층만 확인하고 각 단계의 결과를 기록하세요. 이를 통해 문제가 로컬 DNS 확인, 외부 네트워크, 액세스 규칙, 인증 정보 또는 기기 서비스 중 어디에서 발생했는지 판단할 수 있습니다.

  1. 01

    DNS 및 주소

    연결 명령에 현재 기기 상세 정보에서 제공된 호스트 주소를 사용했는지 확인하세요. 호스트 이름을 사용한다면 먼저 예상 주소로 확인되는지 점검하고 로컬 hosts 재정의를 배제하세요.

    nslookup <host>
  2. 02

    로컬 외부 네트워크

    현재 네트워크에서 외부 연결을 허용하는지 확인하세요. 기업 네트워크, 게스트 Wi-Fi, 프록시 또는 VPN이 외부 경로를 바꿀 수 있으므로 정상 작동이 확인된 네트워크로 전환해 비교해 보세요.

    traceroute <host>
  3. 03

    방화벽 및 대상 포트

    주문에 제공된 포트를 확인하고 로컬 보안 소프트웨어와 조직 네트워크 정책이 연결을 차단하는지 점검하세요. 모든 기기가 기본 SSH 포트를 사용한다고 가정하지 마세요.

    nc -vz <host> <port>
  4. 04

    사용자 이름 및 인증 정보

    포트에 연결할 수 없는 경우와 인증 실패를 구분하세요. 인증 실패 시 사용자 이름, 공개 키 경로, 키 권한 및 ssh-agent를 확인하고 여러 비밀번호를 연속으로 시도해 문제를 해결하지 마세요.

    ssh -vv -i ~/.ssh/id_ed25519 <user>@<host>
  5. 05

    원격 서비스 상태

    포트에는 연결되지만 세션이 즉시 종료되면 연결이 끊기기 전의 전체 오류 메시지를 기록하세요. 브라우저 세션에 문제가 있을 때는 SSH 연결도 가능한지 확인해 그래픽 채널 문제인지 기기 전체 상태 문제인지 구분하세요.

    Connection reset | timeout | permission denied
  6. 06

    노드 및 주문 상태

    마지막으로 콘솔에서 주문, 노드 및 기기 정보를 확인하세요. 모든 노드는 365일 연중 정상적으로 운영됩니다. 구체적인 연결 가능 여부는 콘솔이 실시간으로 반환하는 상태를 기준으로 합니다.

    콘솔 상태 확인

ping만으로 결론을 내리지 마세요.일부 네트워크는 ICMP를 제한할 수 있지만 SSH 대상 포트 연결은 정상적으로 설정될 수 있습니다. 판단할 때 DNS 확인 결과, 대상 포트 테스트 및 SSH 상세 출력을 함께 기록하세요.

세션 보안

모든 액세스를 특정 작업자까지 추적할 수 있게 하세요

독립 물리 Mac은 리소스 경합을 줄여 주지만 팀 내부의 액세스 제어를 대신하지는 않습니다. 키, 임시 인증 정보, 프로젝트 데이터 및 원격 데스크톱은 여전히 최소 권한 원칙으로 관리해야 합니다.

액세스 제어 기준

개인 키로 시작하고 직접 폐기하는 것으로 마무리하세요.

  • 1인 1키:여러 구성원이 하나의 개인 키를 장기간 공유하지 마세요.
  • 자리를 비우면 즉시 화면 잠금:브라우저 세션을 사용하지 않을 때는 데스크톱을 잠그고 작업이 끝나면 직접 로그아웃하세요.
  • 공유 계정 제한:현재 작업에 필요한 구성원에게만 액세스 권한을 부여하세요.
  • 임시 인증 정보 폐기:작업이 끝나면 임시 공개 키, 토큰 및 환경 변수를 삭제하세요.
  • 로그는 먼저 민감 정보 제거:제출 전에 키, 토큰, 개인정보 및 전체 결제 정보를 삭제하세요.
전송 금지

개인 키 및 유효한 액세스 토큰

지원 담당자가 연결 문제를 해결하는 데 개인 키는 필요하지 않습니다. 이메일, 채팅 기록, 코드 저장소 또는 지원 티켓 첨부 파일로 어떤 개인 키 내용도 보내지 마세요.

제공 권장

오류 원문 및 민감 정보 제거 디버그 출력

오류 유형, 명령 매개변수 구조, 발생 시간 및 클라이언트 버전을 보존하고 호스트 주소, 사용자 이름, 프로젝트 이름 및 민감한 값을 명확한 플레이스홀더로 바꾸세요.

성능 권장 사항

대화형 작업은 연결 안정성, 지속 작업은 기기 측 실행을 기준으로 판단하세요

브라우저 그래픽 인터페이스의 반응성은 주로 왕복 지연 시간, 지터 및 사용 가능한 대역폭의 영향을 받습니다. 컴파일 속도는 프로젝트, 캐시 및 기기 설정에 더 크게 좌우되므로 두 요소를 나누어 판단해야 합니다.

데스크톱 상호작용에는 안정적인 연결 우선

팀, 코드 저장소 및 산출물 저장소까지의 전체 경로가 가장 적합한 노드를 선택하세요. 순간적인 최저 지연 시간이 전체 세션의 안정성을 보장하지는 않으며 지터와 패킷 손실도 입력 경험에 영향을 줍니다.

대용량 파일은 나누어 전송하고 검증하세요

소스 자료, 모델 및 빌드 산출물은 나누어 전송하세요. 전송 전후에 파일 수, 전체 크기 및 체크섬을 기록하고 실패하면 차이가 있는 부분만 다시 전송하세요.

지속적인 빌드는 백그라운드 작업으로 실행하세요

장시간 컴파일, 테스트 및 인코딩 작업은 기기에서 백그라운드로 실행하고 로그를 파일에 기록하세요. 브라우저를 닫거나 로컬 네트워크가 불안정해져도 작업이 중단되어서는 안 됩니다.

짧은 작업 브라우저 그래픽 인터페이스
반복 가능한 작업 SSH 스크립트
지속 실행 백그라운드 작업 또는 CI Runner
대용량 파일 전송 분할 처리 및 검증
SUPPORT HANDOFF SHEET 6 REQUIRED FIELDS
지원 전환

바로 문제 해결에 사용할 수 있는 정보를 제출하세요

앞선 순서대로 연결 문제를 해결할 수 없다면 콘솔에서 해당 주문에 대한 지원 티켓을 제출하세요. 정보가 완전할수록 지원팀이 문제를 재현하고 어느 계층에서 발생했는지 판단하기 쉽습니다.

주문 번호 기기 및 제공 기록 식별에 사용
노드 콘솔에 표시된 노드 이름 입력
발생 시간 시간대를 포함하고 현재도 계속 발생하는지 설명
클라이언트 운영 체제, 터미널 또는 브라우저 및 버전
재현 단계 정상 상태에서 오류가 발생하기까지의 작업 순서
민감 정보 제거 로그 오류 원문은 유지하고 민감한 내용은 삭제

운영 문제는 주문 티켓으로 문의하세요

기기에 연결할 수 없거나 세션이 반복적으로 끊기거나 제공 정보에 문제가 있을 때는 콘솔의 해당 주문에서 지원 티켓을 제출하세요. 주문 정보를 여러 이메일 대화로 나누어 보내지 마세요.

일반 문의는 이메일로 보내세요

아직 주문하지 않았거나 연결 방식을 확인해야 한다면 예상 작업, 대상 노드, 클라이언트 환경 및 예상 대여 기간을 적어 support@deploymini.com으로 보내세요.

첫 번째 독립 물리 Mac mini를 사용할 준비를 하세요

구성과 5개 노드 중 하나를 선택한 뒤 주문을 완료하고 콘솔에서 연결 정보를 확인하세요. 처음 로그인할 때는 이 페이지의 순서에 따라 호스트 주소, 사용자 이름 및 지문을 확인하세요.