Fleet으로 여러 기기 관리하기

Fleet은 무엇인가

Fleet은 지금 워크스페이스에 연결된 Msty Nexus 기기를 모두 보여 주는 화면입니다. 기기마다 어떤 주소로 접속할 수 있는지도 함께 보여 줍니다. Console 왼쪽 메뉴의 Workspace 묶음에 Overview와 나란히 있습니다.

예를 들어(설명을 위한 예입니다) 사무실에 Mac Studio 한 대와 직원 노트북 두 대에 Nexus를 깔았다면, Fleet에 세 대가 줄지어 나타나고 각각 준비 상태가 표시됩니다.

요금제별 기기 수

요금제	Fleet에서 다루는 기기
Free	지금 쓰는 로컬 컴퓨터 한 대
Pro	관리 기기 3대
Enterprise	조직에 배정된 관리 기기 한도

로컬 기기와 관리 기기

데스크톱 앱을 열면 계정 등록 없이 바로 로컬 워크스페이스가 열리고, 지금 쓰는 컴퓨터가 목록에 나타납니다.

Pro나 Enterprise로 로그인하면 현재 기기를 계정에 추가하거나 다른 기기를 연결할 수 있습니다. 문서는 등록(enrollment)을 해도 그 기기에 원래 있던 모델, 제공업체, 경로, 설정, 로컬 토큰 저장소가 그대로 유지된다고 적었습니다.

기기 추가하기

방법은 두 가지입니다.

방법	순서
설정 명령	Add a machine을 고르고, 만들어진 설정 명령을 대상 컴퓨터에서 실행합니다
앱에서 승인	대상 컴퓨터의 데스크톱 앱에서 로그인하고 Add this device를 승인합니다

두 방법 모두 같은 관리 기기 한도를 씁니다. Nexus는 등록 예약을 만들 때 한 번, 기기가 실제로 합류할 때 한 번 더 남은 자리를 확인합니다.

주의할 점이 하나 있습니다. 다른 계정에 속한 연결 식별 정보(connector identity)를 덮어쓰면 안 됩니다. 그런 경우에는 계정을 바꾸거나, 그 기기를 추가하지 않고 진행하라고 문서는 안내합니다.

기기 찾기와 구분하기

기기마다 알아보기 쉬운 이름과 위치를 붙여 둡니다. 기기가 늘어나면 Fleet 검색이 이 표시를 이용합니다.

Console 맨 위의 기기 전환기(machine switcher)는 나머지 화면이 어느 Runtime을 관리할지를 바꿉니다. 제공업체, 모델, 경로, 토큰, 설정을 고치기 전에 지금 선택된 기기가 맞는지 꼭 확인해야 합니다. 엉뚱한 기기의 설정을 바꾸는 실수를 막기 위해서입니다.

Private network access (사설 네트워크 접근)

이 기능을 켜면 Runtime이 자신이 알리는 LAN 주소 또는 사설 네트워크 주소에서 접속을 받습니다. 켜면 Runtime의 수신 설정이 바뀌므로 다시 시작해야 합니다.

문서가 권하는 사용법은 다음과 같습니다.

• 주소를 다른 사람에게 알리기 전에 표시된 주소가 맞는지 확인합니다.
• 믿을 수 있는 LAN이나 사설 VPN으로 연결합니다.
• 앱마다, 운영자마다 클라이언트 토큰을 따로 씁니다.

Access from anywhere (어디서나 접근)

문서에 Pro, Enterprise 표시가 붙은 기능입니다.

무엇을 해 주는가

관리 기기에 호스팅된 HTTPS 주소를 하나 붙여 줍니다. 사설 네트워크 밖에 있는 앱이 그 주소로 Nexus를 부를 수 있습니다. 데스크톱 도구, 서버, 믿을 수 있는 동료가 같은 LAN이나 VPN에 들어오지 않고 접속해야 할 때 씁니다.

요금제	사용 가능 여부
Free	켤 수 없습니다
Pro	관리 기기 한 대당 원격 엔드포인트 하나가 기본으로 포함됩니다
Enterprise	조직에 배정된 원격 엔드포인트 한도를 씁니다

작동 방식

관리 기기가 Msty Nexus 쪽으로 나가는 연결을 계속 유지합니다. 호스팅 주소로 들어온 요청은 그 연결을 타고 해당 기기의 게이트웨이로 중계됩니다. 그래서 방화벽의 수신 포트를 열거나, 공유기 포트 포워딩을 설정하거나, Runtime을 직접 인터넷에 내놓을 필요가 없습니다.

호스팅 주소는 기기로 가는 길일 뿐입니다. 자격 증명이 아니며, Nexus 인증을 건너뛰게 해 주지도 않습니다. 앱은 그 기기에서 발급한 기존 클라이언트 토큰을 API 키로 씁니다. 제공업체 자격 증명은 관리 기기에 그대로 남고, 엔드포인트 설정으로 복사되지 않습니다.

켜는 순서

1. Fleet을 열고 온라인 상태인 관리 기기를 고릅니다.
2. Connection details를 펼칩니다.
3. Access from anywhere 아래에서 Turn on을 고릅니다.
4. 확인 창에 나온 호스팅 접근 주소를 복사합니다.
5. Client Tokens를 열어 그 앱 전용 토큰을 만듭니다.
6. 앱의 Nexus 기본 주소(base URL)에 호스팅 주소를, API 키에 클라이언트 토큰을 넣습니다.

호스팅 주소로도 그 기기에서 쓰던 게이트웨이 경로, 모델 이름, 프리셋, Smart Routes, Smart Balancer 풀을 똑같이 부를 수 있습니다.

끊기는 경우

기기는 등록된 상태로, 온라인으로, Fleet에 연결된 채로 있어야 합니다. 기기가 꺼지거나, Fleet 연결을 끝내거나, 엔드포인트 사용 자격을 잃으면 호스팅 주소로는 Runtime에 닿지 않습니다.

Access from anywhere를 끄면 그 주소로 가는 트래픽이 즉시 멈춥니다. 그 주소로 설정한 앱은 다른 주소로 바꿀 때까지 작동하지 않습니다.

보안과 개인정보

• 앱마다 클라이언트 토큰을 따로 만들어, 범위를 정하고 따로 폐기할 수 있게 합니다.
• 호스팅 주소는 공개된 정보로, 클라이언트 토큰은 비밀로 다룹니다.
• 요청과 응답은 Msty가 운영하는 중계 서버를 지납니다. 전송 구간은 HTTPS로 보호되지만, 문서는 이것이 로컬 전용 데이터 경로가 아니라고 분명히 적었습니다.
• 추론 트래픽이 호스팅 중계를 지나는 것을 사내 정책이 허용하지 않으면, 사설 네트워크 접근이나 믿을 수 있는 VPN을 씁니다.
• 호출하는 쪽이 웹 페이지라면 브라우저 CORS 설정을 따로 점검합니다.

민감하거나 규제를 받는 업무에 원격 접근을 켜기 전에는 Nexus 보안 모델을 먼저 읽기를 문서는 권합니다.

여러 기기에 한꺼번에 작업 보내기

Fleet의 일괄 작업(batch action)은 고른 기기들에 같은 변경을 준비해 보냅니다. 지원되는 모델 엔진 설치와 업데이트, 모델 내려받기, Nexus 업데이트가 여기에 들어갑니다.

• 시작하기 전에 각 기기가 대상이 되는지(eligibility) 검토합니다.
• 남은 일괄 작업의 실행을 멈춰도, 기기가 이미 받아들인 작업은 계속 진행됩니다.
• 진행 상황은 Activity에서 봅니다.

기기 해지와 삭제

두 가지는 다릅니다.

동작	결과
Revoke (해지)	기기를 관리 대상 워크스페이스에서 뺍니다. 그 기기에 깔린 로컬 설치는 지워지지 않습니다
Erase (삭제)	설정 명령으로 관리하던 Nexus 설치를 폐기할 때만 쓰는 별도 절차입니다

삭제 절차에서 Nexus가 지우는 것은 자기 자신의 서비스, 설정, 기록, Fleet 상태, 저장된 Nexus 자격 증명뿐입니다. 내려받은 모델은 명시적으로 골랐을 때만 지워지고, 외부 런타임과 외부 캐시는 건드리지 않습니다.

팀별 접근과의 관계

Fleet은 기기, 연결, 엔드포인트, 기기 단위 작업을 관리합니다. 어느 팀이 어느 기기에 닿을 수 있는지는 Teams에서 정합니다.

참고한 문서

• Nexus 문서: Fleet
• Nexus 문서: Overview
• Nexus 문서: Security