본문으로 건너뛰기

서비스 제어

pull, start, stop, restart에는 역할로 all, master, agent 중 하나를 지정해야 합니다.

mac pull​

이 호스트에 필요한 GPU exporter를 포함해 역할별 이미지를 다운로드합니다.

mac pull all

mac images​

역할에 필요한 이미지와 각 이미지가 로컬에 있는지 표시합니다.

mac images all --check
mac images prune # 확인을 받은 뒤 사용하지 않는 MAC 이미지 삭제

mac load​

모든 이미지를 갖춘 오프라인 번들에서 이미지를 로드합니다. agent에서도 같은 번들을 사용하세요. 오프라인 설치를 참고하세요.

mac load /opt/mango-ai-center-offline-<version>-ubuntu-amd64
mac load /opt/mango-ai-center-offline-<version>-ubuntu-amd64 --verify-only

mac start​

역할을 시작합니다. all은 master와 agent를 함께 실행합니다. agent에는 MASTER_IP와 master의 토큰이 필요합니다.

mac start all
mac start agent --dry-run # 아무것도 변경하지 않고 설정 검사

MAC_OFFLINE=true가 아니면 누락된 이미지를 다운로드합니다. 재부팅 후에는 남은 Docker 프록시를 정리하기 위해 mac start가 Docker를 다시 시작할 수 있으며, 이때 호스트의 다른 컨테이너도 영향을 받습니다.

mac stop​

역할의 컨테이너를 삭제합니다. 볼륨과 이미지는 유지됩니다. agent는 --keep-registration을 지정하지 않으면 등록이 해제됩니다.

mac stop agent
mac stop agent --keep-registration

mac restart​

설정을 변경한 뒤 역할을 다시 생성합니다. agent는 --deregister를 지정하지 않으면 등록을 유지합니다.

mac restart all

mac status​

로컬 MAC 컨테이너와 상태를 표시합니다. -v는 버전, 역할, master 주소와 GPU 정보를 추가로 표시합니다.

mac status -v

mac logs​

mac logs # 각 컨테이너의 마지막 50줄
mac logs api-server -n 200 # 한 서비스의 마지막 200줄
mac logs api-server -f # 실시간으로 계속 출력

mac test​

master를 통해 실행 중인 클러스터를 검사합니다. master에서 실행하거나, node 단위 설정에 MASTER_IP를 저장한 agent에서 실행하세요.

mac test -v # 모든 검사 결과 표시
mac test --expect all # 이 node에서 모든 서비스가 실행 중인지도 확인

종료 코드 3은 이 node는 통과했고 다른 node만 실패했다는 뜻입니다.

mac version​

mac version

mac clean​

확인을 받은 뒤 MAC 컨테이너, 데이터 볼륨(사용자, node 등록, 알림, metric, 로그)과 로컬 이미지를 삭제합니다. --all은 mac-network, 모든 MAC 이미지와 MAC이 사용하는 Prometheus, Loki, GPU exporter, SDK agent 이미지도 삭제합니다. 다른 컨테이너가 사용하는 이미지는 삭제하지 않습니다.

mac clean
mac clean --all
경고

mac clean은 영구 데이터를 삭제합니다. 데이터를 보존하려면 역할을 중지한 뒤 clean이나 apt purge 대신 apt remove를 실행하세요. apt purge는 볼륨도 삭제합니다.

mac llmboost detect​

로컬의 OpenAI 호환 모델 엔드포인트를 찾고 LLMBOOST_HOST_PORTS에 사용할 값을 제안합니다. 설정은 저장하지 않습니다. 관계없는 추론 서비스가 함께 발견될 수 있으므로 결과를 확인하세요.

mac llmboost detect

mac user reset-password​

대시보드 로그인 없이 master에서 계정을 복구합니다. mac-api-server가 실행 중이어야 합니다. 이 명령은 api-server를 다시 시작하고 해당 사용자의 모든 세션을 무효화하며, admin 계정을 다시 만들 수도 있습니다. 다른 데이터는 유지됩니다.

sudo mac user reset-password admin