본문으로 건너뛰기

설치

이 페이지에서는 Mango AI Center (MAC)를 설치하고 컨테이너 이미지를 받아오는 과정을 다룹니다. 이 단계를 마치면 각 호스트에 mac CLI가 설치되고 이미지가 로컬에 캐시되지만, 아직 어떤 서비스도 기동되지 않습니다. 실제 start 단계는 배포 모드를 참고하세요.

사전 요구 사항​

마스터와 에이전트 호스트마다 다음이 필요합니다.

  • Linux x86_64 — Ubuntu 22.04 / 24.04 / 26.04에서 검증되었습니다
  • Linux 커널 5.4 이상
  • Docker 20.10 이상과 compose 플러그인 (Docker Compose v2)
  • MangoBoost 이미지 레지스트리 (또는 프라이빗 미러 레지스트리)로 향하는 외부망 접속
  • 최초 설치 시 root 권한. 이후에는 사용자를 docker 그룹에 추가하면 sudo 없이도 mac을 쓸 수 있습니다
정보

에이전트가 GPU와 DPU를 모니터링하려면, 해당 벤더의 드라이버 (NVIDIA 드라이버 + DCGM, ROCm, MangoBoost 드라이버)가 호스트에 먼저 설치되어 있어야 합니다. MAC은 GPU 드라이버를 설치하지 않습니다. MangoBoost 장비는 Mango SDK 문서를, 다른 장비는 해당 벤더의 가이드를 참고하세요.

Docker 설치​

~$ sudo apt update
~$ sudo apt install docker-compose-v2
~$ docker compose version
Docker Compose version v2.x.x

sudo 없이 mac 실행하기​

CLI가 root 권한을 요구하지 않도록, 사용자를 docker 그룹에 추가합니다.

~$ sudo usermod -aG docker $USER
~$ newgrp docker     # 또는 로그아웃 후 다시 로그인

이 가이드의 모든 예시는 mac을 sudo 없이 실행한다고 가정합니다.

저장소 자격 증명 받기​

Debian 패키지와 컨테이너 이미지 모두 MangoBoost 공개 Artifactory에서 호스팅됩니다.

자산URL
Debian 패키지https://repo.mangoboost.io/artifactory/public-debian
컨테이너 이미지repo.mangoboost.io/public-docker/mac
정보

repo.mangoboost.io의 외부 접근은 API 전용입니다. 웹 UI는 차단되어 있으며, 브라우저로 저장소를 탐색할 수 없습니다. 동일한 게스트 계정 하나로 apt와 docker 양쪽을 인증합니다.

contact@mangoboost.io로 파트너 게스트 사용자명과 비밀번호를 요청한 뒤 아래 두 단계에서 사용합니다.

MAC 패키지 설치​

MAC Debian 패키지는 마스터든 에이전트든 모든 노드에 같은 패키지를 설치하며, 역할은 시작 시점에 mac start <mode>로 결정합니다.

1. APT 인증 파일 생성​

게스트 자격 증명을 root 전용 APT 인증 파일에 저장합니다. APT가 repo.mangoboost.io로 가는 모든 요청에 자동으로 첨부합니다.

~$ sudo install -d -m 0755 /etc/apt/auth.conf.d
~$ sudo tee /etc/apt/auth.conf.d/mango-sdk.conf >/dev/null <<EOF
machine repo.mangoboost.io
login   <guest-username>
password <guest-password>
EOF
~$ sudo chmod 600 /etc/apt/auth.conf.d/mango-sdk.conf

2. 저장소 서명 키 신뢰​

~$ curl -fsSL \
    https://repo.mangoboost.io/artifactory/api/security/keypair/mb-gpg/public \
    | gpg --dearmor | sudo tee /etc/apt/trusted.gpg.d/mango-sdk.gpg >/dev/null

3. APT 소스 추가​

형식은 호스트의 Ubuntu 릴리스에 따라 다릅니다.

~$ echo "deb https://repo.mangoboost.io/artifactory/public-debian jammy universe" \
    | sudo tee /etc/apt/sources.list.d/mango-sdk.list

4. 설치​

~$ sudo apt update
~$ sudo apt install mango-ai-center
~$ mac --help

repo.mangoboost.io에 접속할 수 없는 망이라면, MangoBoost로부터 단독 .deb 파일을 받아 직접 설치하세요. sudo dpkg -i mango-ai-center_<version>_amd64.deb.

패키지가 설치하는 것들은 다음과 같습니다.

  • /usr/bin/mac — mac CLI
  • /usr/share/bash-completion/completions/mac — Bash 자동완성
  • /etc/mango/mac/ — Docker Compose 파일과 기본 env

컨테이너 이미지 받기​

동일한 게스트 자격 증명으로 Docker를 인증한 뒤 이미지를 받습니다.

~$ docker login repo.mangoboost.io      # contact@mangoboost.io가 발급한 게스트 계정
~$ mac pull all                         # 또는 mac pull master / mac pull agent

docker login이 자격 증명을 ~/.docker/config.json에 저장하므로, 이후 docker pull과 mac pull은 자동으로 같은 인증을 사용합니다.

mac pull은 MAC_REGISTRY를 읽어 동작합니다. 기본값은 repo.mangoboost.io/public-docker/mac이며, 프라이빗 미러를 쓰려면 mac env set MAC_REGISTRY=<host>/<path>로 덮어씁니다.

네트워크 및 방화벽 포트​

마스터, 에이전트, 스위치, 운영자 워크스테이션 사이에서 다음 포트를 열어둡니다.

방향포트서비스
사용자 → 마스터23000웹 대시보드
사용자 → 마스터28080REST API
사용자 → 마스터29090Prometheus UI
사용자 → 마스터29199metrics-bridge (GPU 메트릭 통합)
사용자 → 마스터29400switch-exporter (Prometheus 스크랩 대상)
마스터 → 에이전트29150dcgm-exporter (NVIDIA)
마스터 → 에이전트29200rocm-exporter (AMD)
마스터 → 에이전트29500nic-exporter (호스트 네트워크)
마스터 → 에이전트29300sw-exporter
마스터 → 에이전트29101sys-exporter (메트릭 + 로그)
마스터 → 에이전트29102bmc-agent (in-band IPMI)
마스터 ↔ 에이전트29103sys-manager (컨트롤 플레인)
마스터 → 에이전트28000mango-sdk-agent REST
에이전트 → 마스터28080등록 (api-server /api/v1/register)
에이전트 → 마스터29210Loki (로그 전송)
마스터 → 스위치22, 161SSH, SNMP
사용자 → 마스터 (TLS)23443, 28443HTTPS로 노출되는 웹 UI / REST API (MAC_TLS_ENABLED=true일 때)

다음 단계​

배포 모드로 이동해 실제로 MAC을 기동합니다.