첫 세션 실행 체크리스트

액세스 정보부터
첫 성공 빌드까지

먼저 콘솔에서 장치 상태, 노드, 사용자 이름, 호스트 주소 및 지문을 확인한 다음 SSH 또는 그래픽 데스크톱을 선택하세요. 포트에 연결된다고 환경을 바로 사용할 수 있는 것은 아닙니다. 인증, 디스크 점검 및 최소 빌드까지 완료해야 연결이 완전히 검증됩니다.

이 가이드는 HopVM 전용 클라우드 Mac에 적용됩니다. 각 주문은 전용 물리 Mac 한 대에 해당하며 가상 머신이 아닙니다. 접속 정보는 권한이 부여된 프로젝트 구성원에게만 제공해야 합니다.

5개 항목 연결 전 확인
2가지 접속 경로
1회 최소 빌드 검증
싱가포르, 도쿄, 서울, 홍콩, 미국 동부 및 미국 서부 노드의 연결 관계를 보여 주는 네트워크 구성도
연결 전 확인 SESSION / FIRST-RUN
장치 상태
콘솔에 연결 가능으로 표시됨
노드
주문 기록과 일치함
인증 정보
사용자 이름, 키, 지문
로컬 조건
시스템 시간 및 네트워크 출구가 정상임

주소, 포트 및 인증 정보는 콘솔에 현재 표시된 값을 사용하세요. 채팅 기록이나 오래된 문서에서 복사하지 마세요.

확인 후 연결

첫 연결은 네 단계를 거칩니다

연결은 주소를 받자마자 로그인하는 작업이 아닙니다. 상태, 인증, 신뢰 및 환경을 모두 기록해야 나중에 시간 초과, 권한 거부 또는 빌드 실패가 발생했을 때 빠르게 원인을 찾을 수 있습니다.

  1. 01

    현재 실행 체크리스트 확인

    콘솔에 로그인해 주문 식별자, 실제 노드, 장치 상태, 접속 방식, 사용자 이름, 주소, 포트 및 호스트 지문을 확인하세요. 정보가 팀의 이전 기록과 다르면 콘솔의 현재 내용을 기준으로 삼으세요.

  2. 02

    로컬 인증 정보 준비

    개인 키는 현재 사용자가 읽을 수 있는 디렉터리에 저장하고 파일 권한을 제한하세요. 전체 키를 이메일, 단체 채팅 또는 지원 티켓으로 보내지 마세요. 그래픽 클라이언트도 별도의 연결 설정을 사용해야 합니다.

  3. 03

    원격 인증 확인

    첫 SSH 연결에서는 지문을 먼저 대조한 후 호스트 기록을 수락하세요. 그래픽 데스크톱 연결에서는 장치 이름, 노드 및 세션 정보를 확인해 출처가 불분명한 주소에 연결하지 않도록 하세요.

  4. 04

    개발 기준선 설정

    시스템에 들어간 후 시간, 디스크, 현재 사용자 및 세션을 확인한 다음 Xcode 버전 조회, Git 가져오기 및 최소 빌드를 실행하세요. 명령, 종료 코드 및 소요 시간을 기록하세요.

명령줄 경로

SSH 연결: 인증 정보와 지문을 먼저 확인하세요

아래 명령은 문서용 예약 주소를 사용합니다. 실제 사용자 이름, 호스트 주소, 포트 및 지문은 반드시 콘솔에서 확인하세요. 예시 값을 그대로 사용해 실제 세션을 만들지 마세요.

SSH 체크리스트

키 권한부터 안전한 종료까지

MODE / CLI
A

개인 키 권한 제한

개인 키는 현재 로컬 사용자만 읽을 수 있어야 합니다. 권한이 너무 넓으면 SSH 클라이언트가 해당 파일 사용을 거부할 수 있습니다.

chmod 600 ~/.ssh/hopvm_ed25519
ls -l ~/.ssh/hopvm_ed25519
B

첫 연결 시작

203.0.113.24 는 문서용 예시 주소입니다. 콘솔에서 사용자 지정 포트를 제공하면 -p 매개변수를 추가하세요.

ssh -i ~/.ssh/hopvm_ed25519 \
  -p 22 developer@203.0.113.24
C

호스트 지문 대조

터미널에 지문이 표시되면 작업을 멈추고 콘솔의 지문과 문자를 하나씩 대조하세요. 완전히 일치할 때만 yes 를 입력해 기록을 수락하세요.

ED25519 key fingerprint is
SHA256:EXAMPLE_ONLY_REPLACE_FROM_PANEL
D

종료 후 세션 종료 확인

작업을 마치면 먼저 포그라운드 프로그램을 중지한 다음 셸에서 정상적으로 로그아웃하세요. 애플리케이션 종료 절차 대신 로컬 터미널을 바로 닫지 마세요.

jobs
exit

첫 확인은 형식적인 클릭이 아닙니다

호스트 지문은 원격 장치의 신원을 확인하는 기준입니다. 지문 변경 알림이 표시되면 먼저 연결을 중지하고 콘솔 정보를 확인하세요. 경고를 우회하려고 로컬 기록을 삭제하지 마세요.

재현 가능한 기록 유지

연결 시간, 시간대, 로컬 네트워크, 실제 노드, 명령 매개변수 및 종료 코드를 기록하세요. 문제 해결 시 비식별화한 기록을 제공하면 단순히 “연결되지 않음”이라고 쓰는 것보다 원인을 찾기 쉽습니다.

그래픽 세션

Xcode 및 그래픽 앱이 필요할 때는 관리되는 데스크톱 세션을 사용하세요

그래픽 데스크톱은 Xcode 프로젝트 작업, 서명 설정, 시뮬레이터 확인 및 미디어 앱에 적합합니다. SSH와 사용 목적은 다르지만 연결 전 장치, 노드 및 접속 정보를 확인해야 합니다.

연결 전

로컬 환경의 신뢰성 확인

관리되는 업무용 컴퓨터와 신뢰할 수 있는 네트워크를 우선 사용하세요. 로컬 시스템 시간을 확인하고 불필요한 화면 녹화, 클립보드 동기화 및 파일 자동 공유를 끄세요.

  • 장치 이름이 콘솔 기록과 일치함
  • 접속 정보가 공개 문서에 저장되지 않음
  • 로컬 네트워크에서 필요한 연결 방식을 허용함
세션 중

작업에 필요한 기능만 활성화

데스크톱에 들어간 후 현재 사용자와 시스템 시간을 먼저 확인한 다음 Xcode 또는 대상 앱을 여세요. 프로젝트 자료를 복사할 때는 팀에서 승인한 전송 경로를 사용하세요.

  • 관리자 인증 정보를 공유하지 않음
  • 민감한 토큰을 클립보드에 남기지 않음
  • 대용량 전송 후 파일 무결성을 확인함
종료 전

인증 정보 저장을 끄고 직접 로그아웃

공용 장치나 임시 컴퓨터에서는 비밀번호 및 연결 정보 저장을 반드시 끄세요. 종료할 때 그래픽 세션에서 로그아웃하고 화면 잠금으로 연결 종료를 대신하지 마세요.

  • 임시 다운로드 파일과 클립보드 내용을 삭제함
  • 빌드 및 전송 프로세스가 종료되었는지 확인함
  • 콘솔로 돌아가 장치 상태를 확인함
재현 가능한 첫 작업

연결, 빌드 및 결과물을 하나의 실행 기록으로 관리하세요

터미널 기록은 SSH, Xcode 빌드 및 Fastlane 출력을 순서대로 보여 줍니다. 예시에는 실제 주소나 인증 정보가 없으며, 명령, 성공 표시 및 종료 코드를 보존하는 데 초점을 둡니다.

노드 SG / 첫 검증 세션 / zsh
local % ssh -i ~/.ssh/hopvm_ed25519 developer@203.0.113.24 Host key fingerprint verified against control panel record Authenticated to documentation host using public key   hopvm % sw_vers && xcodebuild -version ProductName: macOS Xcode 16.x   hopvm % xcodebuild -scheme SampleApp -configuration Debug build Resolve Package Graph CompileSwift normal arm64 ** BUILD SUCCEEDED ** xcodebuild exit code: 0   hopvm % bundle exec fastlane verify_build Running lane verify_build Artifact manifest written to ./artifacts/manifest.json fastlane finished successfully process exit code: 0   hopvm % exit Connection closed after task completion
기준선 기록 노드, 명령, 소요 시간, 종료 코드, 결과물 경로
비식별화 후 제출 주소, 키, 토큰, 저장소 인증 정보 및 프로젝트 비공개 내용 제거
시스템 진입 후 첫 1분

보안 기준선을 먼저 확인한 후 프로젝트를 가져오세요

연결 성공은 세션이 설정되었다는 뜻일 뿐입니다. 코드, 모델 또는 자료를 다루기 전에 시스템 시간, 디스크 여유 공간, 현재 신원, 키 권한 및 열린 세션을 차례로 확인하세요.

시스템 시간

실행 datesystemsetup -gettimezone를 실행해 시간대와 현재 시간이 작업 기록과 일치하는지 확인하세요. 시간 편차는 인증서, 로그 정렬 및 종속성 다운로드에 영향을 줍니다.

디스크 여유 공간

실행 df -h를 실행해 시스템 볼륨, 프로젝트 디렉터리 및 캐시 공간을 확인하세요. 빌드 전에 소스 코드, 종속성, 파생 데이터, 아카이브 및 최종 결과물에 필요한 용량을 확보하세요.

현재 사용자

실행 whoamiid를 실행해 현재 신원이 프로젝트 권한 설계에 부합하는지 확인하세요. 편의를 위해 관리자 인증 정보를 공유하거나 모든 작업을 높은 권한 세션에서 실행하지 마세요.

키 권한

프로젝트에서 사용하는 SSH 키, 설정 파일 및 인증 정보 디렉터리의 권한을 확인하세요. 비밀 정보를 셸 기록, 빌드 스크립트, 저장소 커밋 또는 다른 구성원이 읽을 수 있는 공개 디렉터리에 기록하지 마세요.

열린 세션

다음 명령으로 who,w 및 팀에서 정한 세션 기록을 사용해 현재 연결을 확인하세요. 알 수 없는 세션을 발견하면 민감한 작업을 중지하고 비식별화한 증거를 저장한 뒤 콘솔 지원 티켓을 제출하세요.

개발 환경 검수

최소 작업으로 비교 가능한 기준선을 설정하세요

처음부터 전체 파이프라인을 실행하지 마세요. 버전, 저장소 및 최소 빌드 세 가지를 먼저 검증하면 연결, 종속성 및 프로젝트 문제를 구분할 수 있습니다.

  1. 01

    시스템 및 Xcode 버전 기록

    다음 결과를 저장하세요: sw_vers,uname -m,xcodebuild -versionxcode-select -p . 이후 빌드 차이를 비교할 때 가장 기본이 되는 환경 정보입니다.

  2. 02

    Git 읽기 경로 테스트

    위험도가 낮은 저장소에서 먼저 git ls-remote를 실행해 네트워크, 저장소 권한 및 호스트 신뢰를 확인한 다음 얕은 복제를 실행하세요. 실패 시 종료 코드를 보존하고 원래 문제를 숨기려고 인증 정보를 반복해서 수정하지 마세요.

  3. 03

    최소 빌드 대상 실행

    종속성이 적고 실행 시간이 짧은 scheme을 선택해 구성을 명시하고 전체 명령을 기록하세요. 먼저 컴파일 경로를 검증한 후 테스트, 아카이브 및 자동화된 배포 단계를 단계적으로 추가하세요.

  4. 04

    기준선 소요 시간 및 종료 코드 저장

    시작 시간, 종료 시간, 종속성 해결 시간, 빌드 시간, 최대 디스크 사용량 및 종료 코드를 기록하세요. 성능 변동이 있으면 동일한 작업으로 재측정하고 서로 다른 프로젝트를 비교하지 마세요.

현상별 문제 해결

일반적인 연결 문제 5가지: 먼저 중단 지점을 찾고 설정을 변경하세요

한 번에 하나의 조건만 변경하고 변경 전후 결과를 보존하세요. 지원이 필요하면 주문 식별자, 실제 노드, 문제 발생 시간과 시간대, 재현 단계, 예상 결과 및 비식별화한 출력을 첨부하세요.

연결 시간 초과: 어디서부터 확인해야 하나요?
  1. 먼저 콘솔에서 장치 상태와 접속 정보가 변경되지 않았는지 확인하세요.
  2. 로컬 시스템 시간, 네트워크 출구, 대상 주소 및 포트를 확인하고 오래된 스크린샷의 정보를 사용하지 마세요.
  3. 신뢰할 수 있는 다른 네트워크로 전환해 재현하고 로컬 네트워크 유형과 문제 발생 시간을 기록하세요.
  4. 상세 출력 SSH 명령으로 연결이 어느 단계에서 멈추는지 확인하세요:ssh -vvv
  5. 티켓 제출 시 비식별화한 출력을 첨부하고 개인 키나 전체 연결 설정은 제출하지 마세요.
호스트 지문이 변경되었습니다. 기존 기록을 바로 삭제해도 되나요?

기록을 먼저 삭제한 후 계속하면 안 됩니다. 즉시 연결을 중지하고 콘솔의 현재 지문, 노드 및 주문 식별자를 확인하세요. 변경 근거가 명확할 때만 해당 호스트 항목을 제거하세요. 확인할 수 없다면 콘솔에서 티켓을 제출하고 이전 지문, 새 지문 및 최초 발생 시간을 첨부하세요.

Permission denied가 표시됩니다. 어떤 항목을 확인해야 하나요?
  1. 사용자 이름이 콘솔과 일치하는지 확인하세요. 로컬 사용자 이름을 원격 사용자 이름으로 착각하지 않도록 주의하세요.
  2. 개인 키 경로와 권한을 확인하고 SSH가 예상한 키를 실제로 불러오는지 확인하세요.
  3. 다음 명령으로 ssh -v 클라이언트가 어떤 키를 제공하는지 확인하세요. 명령에 비밀 정보를 출력하지 마세요.
  4. 복사한 공개 키가 잘리지 않았고 불필요한 줄바꿈이 추가되지 않았는지 확인하세요.
  5. 출처가 불분명한 인증 정보를 연속해서 시도하지 마세요. 최초 실패 출력을 보존한 후 티켓을 제출하세요.
그래픽 세션은 끊겼지만 SSH는 연결됩니다. 어떻게 판단하나요?

먼저 SSH로 시스템 시간, 디스크 여유 공간, 현재 사용자 및 관련 프로세스를 확인해 장치 자체가 응답하는지 확인하세요. 그런 다음 로컬 그래픽 클라이언트 버전, 네트워크 변경, 자동 재연결 및 인증 정보 저장 설정을 점검하세요. 알 수 없는 프로세스를 강제 종료하며 추측하지 마세요. 지원이 필요하면 중단 시간, 클라이언트 유형, SSH 연결 가능 여부 및 비식별화한 로그를 제공하세요.

회사 또는 학교 네트워크가 연결을 제한합니다. 범위를 어떻게 좁히나요?
  1. 제한이 주소 확인, 포트 연결 또는 인증 단계 중 어디에서 발생하는지 확인하세요.
  2. 조직의 보안 규칙을 준수하면서 다른 신뢰할 수 있는 네트워크로 재현하세요.
  3. 네트워크 관리자에게 대상 포트와 업무 용도를 제공하되 개인 키나 로그인 인증 정보는 보내지 마세요.
  4. 제한된 네트워크와 사용 가능한 네트워크의 차이를 기록해 로컬 네트워크 문제를 노드 장애로 오인하지 않도록 하세요.

여전히 연결을 완료할 수 없나요?

콘솔 티켓은 실제 주문 및 장치와 연결할 수 있습니다. 제출 전에 주문 식별자, 노드, 시간 및 시간대, 재현 단계, 최근 정상 작동 시간 및 비식별화한 오류 출력을 준비하세요.

종료 및 인계

작업 완료가 창을 바로 닫는다는 뜻은 아닙니다

세션을 종료하기 전에 작업을 중지하고 결과물을 확인하며 임시 인증 정보를 정리하고 인계 기록을 업데이트하세요. 다음 구성원에게는 이전 구성원의 인증 정보 복사본이 아니라 관리되는 접속 권한을 제공해야 합니다.

  1. 01

    백그라운드 작업 중지

    셸 jobs, 빌드 프로세스, 업로드 작업 및 그래픽 앱을 확인하세요. 리소스를 점유하거나 완료되지 않은 프로세스가 남지 않도록 작업이 정상적으로 끝난 후 세션을 종료하세요.

  2. 02

    필요한 결과물 저장

    아카이브, 로그, 체크섬 및 결과물 목록을 확인해 팀에서 승인한 위치로 전송하세요. 유일한 사본을 임시 디렉터리나 현재 세션에만 남겨 두지 마세요.

  3. 03

    임시 인증 정보 정리

    임시 키, 단기 토큰, 클립보드 내용 및 로컬 다운로드 파일을 삭제하고 셸 기록과 프로젝트 설정에 비밀 정보가 남아 있지 않은지 확인하세요.

  4. 04

    관리되는 인계 완료

    노드, 현재 작업 상태, 마지막 성공 명령, 결과물 위치 및 할 일을 기록하세요. 다음 구성원에게 별도의 권한을 설정하고 관리자 인증 정보를 공유하지 마세요.

마지막으로 콘솔에서 장치 상태 확인

세션이 종료되었고 주문 및 노드 기록이 올바른지 확인하세요. 비정상적인 접속이나 상태 불일치가 발견되면 즉시 관련 권한을 취소하고 콘솔 티켓을 제출하세요.

프로젝트용 Mac 준비

일·주·월·분기 단위로 전용 클라우드 Mac 대여

Apple Silicon 구성 3종으로 빌드, 일상 개발 및 대용량 메모리 추론을 지원하며, 6개 노드가 연중 365일 정상 운영됩니다. 모든 주문은 USD로 결제하며 USDT-TRC20 및 Visa / Mastercard / Amex(Stripe)만 지원합니다.