배포 모드

master 한 대를 구성하고 모니터링할 서버마다 agent를 실행하세요. 한 서버에서 둘을 함께 실행하거나(All-in-One), 전용 master를 사용하거나(Multi-Node), All-in-One master에 원격 agent를 추가할 수 있습니다(Hybrid).

All-in-One 배포

mac pull all
sudo mac start all

브라우저에서 http://<this-host-ip>:23000에 접속하세요.

Multi-Node 배포

1단계 — master 시작

mac pull master
sudo mac start master

master에는 GPU가 필요하지 않습니다. MAC_NODE_TOKEN을 설정하지 않았다면 처음 시작할 때 /etc/mango/mac/node_token에 node 토큰이 생성됩니다(node 인증).

2단계 — agent 등록

master의 토큰을 안전한 방법으로 복사한 뒤, 각 서버에서 다음 명령을 실행하세요.

sudo mac env set --global MASTER_IP=<master-ip>
sudo mac env set --global MAC_NODE_TOKEN=<master-token>
mac pull agent
mac start agent

agent가 잘못된 주소로 등록되면 MAC_NODE_IP_PREFIX를 설정하세요.

agent 등록 해제

mac stop agent                     # 서버 폐기: 등록 해제
mac stop agent --keep-registration  # 일시 중지: 등록 유지

Hybrid 배포

master에서 sudo mac start all을 실행한 뒤 2단계와 같이 원격 agent를 등록하세요.

설치 확인

mac status -v
mac test --expect all       # 로컬 역할에 따라 master 또는 agent 사용

그런 다음 대시보드에 각 node가 최신 데이터와 함께 표시되는지 확인하세요. mac test를 참고하세요.

업그레이드

업그레이드는 0.5.6 이상 버전에서만 지원합니다. 이전 버전은 데이터와 함께 제거한 뒤 새 릴리스를 설치하세요. 더 이상 필요 없는 MAC_VERSION 고정 값을 제거한 뒤 master를 먼저 업그레이드하고 agent를 업그레이드하세요.

sudo apt update
sudo apt install --only-upgrade mango-ai-center
# 별도로 받은 패키지: sudo dpkg -i mango-ai-center_<version>_amd64.deb
# RHEL 계열: sudo dnf upgrade ./mango-ai-center-<version>-<release>.<arch>.rpm
mac status -v
mac test --expect master     # 다른 역할은 all 또는 agent

패키지는 실행 중이던 역할을 새 이미지로 다시 시작하며, 데이터와 node 등록, 사용자 계정은 유지됩니다. 다시 시작에 실패하면 /var/lib/mango-ai-center/upgrade-restart.log를 확인하고 node 단위 설정(agent가 사용하는 토큰은 유지)이나 이미지를 바로잡은 뒤 sudo env MAC_IGNORE_USER_ENV=1 mac start <mode>를 실행하세요.

오프라인 호스트에서는 새 번들의 설치 프로그램을 다시 실행하세요.

경고

업그레이드하면 직접 수정한 릴리스 설정 파일도 교체됩니다. 배포 환경별 설정은 /etc/mango/mac/env에 두세요.

제거

데이터를 유지하려면 다음 명령을 실행하세요.

mac stop all
sudo apt remove mango-ai-center

MAC 데이터를 모두 삭제하려면 다음 명령을 실행하세요.

mac stop all
mac clean --all
sudo apt purge mango-ai-center

위험

purge하면 MAC 볼륨과 node 토큰을 포함한 /etc/mango/mac이 삭제됩니다. 업그레이드 중에는 mac clean --all을 실행하지 마세요.

RHEL 계열 호스트에서 sudo dnf remove mango-ai-center를 실행해도 데이터는 유지됩니다. 데이터까지 삭제하려면 먼저 mac clean --all을 실행한 뒤 /etc/mango/mac과 /var/lib/mango-ai-center를 삭제하세요.

새 컨테이너 설정 적용

대시보드에서 업데이트하면 이미지만 교체됩니다. 새 Compose 파일, 권한, 포트, 변수를 적용하려면 모든 node의 패키지를 업그레이드한 뒤 master부터 차례로 각 역할을 다시 생성하세요.

sudo env MAC_IGNORE_USER_ENV=1 mac restart <mode>