환경 변수
mac env 명령으로 MAC의 동작을 결정하는 변수들(레지스트리, 마스터 IP, 스위치 자격
증명 등)을 조회·설정·삭제할 수 있습니다.
mac env
~$ mac env # 관리 대상 변수와 출처를 나열
~$ mac env set KEY=VAL [...] # ~/.mac/env에 저장 (사용자별, 영속)
~$ mac env unset KEY [...] # ~/.mac/env에서 삭제
파일 우선순위
MAC은 다음 파일들에서 변수를 읽습니다. 우선순위가 높은 순서대로입니다.
~/.mac/env— 사용자별 오버라이드 (mac env set이 기록)/etc/mango/mac/env— 전역 기본값 (설치 시 작성, root 권한으로 편집)
mac을 호출하는 셸 환경에 같은 변수가 지정되어 있다면, 그 값이 가장 우선합니다.
정보
$HOME이 NFS로 마운트되는 클러스터라면, ~/.mac/env는 같은 홈 디렉터리를 마운트하는
모든 호스트가 함께 보게 됩니다. NODE_NAME 같은 호스트별 값은 절대 여기에 넣지
마세요 — 호스트별 설정은 /etc/mango/mac/env에 두고, ~/.mac/env에는 로그인하는
어느 서버에서나 동일한 값 (예: MASTER_IP)만 둡니다.
변수 레퍼런스
공통
| 변수 | 사용처 | 용도 |
|---|---|---|
MASTER_IP | 에이전트 | 마스터 노드 IP (필수, 기본값 없음) |
MAC_REGISTRY | 모두 | 컨테이너 이미지 레지스트리(공개 기본값 repo.mangoboost.io/public-docker/mac) |
MAC_CONFIG_DIR | 모두 | Compose 파일 디렉터리 (기본 /etc/mango/mac) |
MAC_AUTH_ENABLED | 마스터 | JWT 인증 활성화 (기본 true) |
MAC_ADMIN_PASSWORD | 마스터 | 최초 기동 시 admin 비밀번호 (기본 admin) |
NODE_NAME | 에이전트 | 노드 이름 강제 지정 (기본: 호스트네임) |
SDK_AGENT_IMAGE | 에이전트 | mango-sdk-agent 이미지(공개 기본값 repo.mangoboost.io/public-docker/mango-sdk-agent:latest) |
TZ | 모두 | 컨테이너 타임존(IANA 이름). 미설정 시 호스트에서 자동 감지 |
서비스 포트
| 변수 | 사용처 | 용도 |
|---|---|---|
MASTER_API_PORT | 마스터 | API 서버 노출 포트 (기본 28080) |
MASTER_WEB_PORT | 마스터 | 웹 UI 노출 포트 (기본 23000) |
PROMETHEUS_PORT | 마스터 | Prometheus 노출 포트 (기본 29090) |
LOKI_PORT | 마스터 | Loki 노출 포트 (기본 29210) |
SNMP_PORT | 마스터 | switch-exporter SNMP 포트 (기본 161) |
ALERT_RULES_PATH | 마스터 | Prometheus 알림 규칙 JSON 경로 재정의 |
TLS (HTTPS)
| 변수 | 사용처 | 용도 |
|---|---|---|
MAC_TLS_ENABLED | 마스터 | api-server / web-ui의 HTTPS 활성화 (기본 false) |
MAC_TLS_CERT_DIR | 마스터 | server.crt와 server.key가 위치한 호스트 디렉터리 |
MAC_TLS_PORT | 마스터 | API 서버 HTTPS 포트 (기본 28443) |
MAC_WEB_TLS_PORT | 마스터 | 웹 UI HTTPS 포트 (기본 23443) |
MAC_TLS_CERT_FILE | 마스터 | 컨테이너 안에서의 TLS 인증서 경로 (기본 /etc/mac/certs/server.crt) |
MAC_TLS_KEY_FILE | 마스터 | 컨테이너 안에서의 TLS 키 경로 (기본 /etc/mac/certs/server.key) |
스위치 접속
| 변수 | 사용처 | 용도 |
|---|---|---|
SWITCH_USER | 마스터 | 스위치 CLI SSH 사용자명 (기본 admin) |
SWITCH_PASSWD_LIST | 마스터 | 쉼표로 구분한 SSH 비밀번호 목록 (순차 시도) |
SWITCH_PASSWD | 마스터 | 레거시 단일 SSH 비밀번호 (_LIST가 비었을 때만 사용) |
SNMP_COMMUNITY | 마스터 | 기본 SNMP community |
LLMBoost
| 변수 | 사용처 | 용도 |
|---|---|---|
LLMBOOST_API_ENDPOINT | 마스터 | LLMBoost API 엔드포인트 강제 지정 (미설정 시 자동 탐색) |
LLMBOOST_K8S_API_URL | 마스터 | K8s API URL 강제 지정 |
LLMBOOST_K8S_TOKEN | 마스터 | LLMBoost 전체 뷰를 위한 K8s 서비스 어카운트 토큰 |
LLMBOOST_DASHBOARD_URL | 마스터 | LLMBoost 관리 UI URL 강제 지정 |
현재 상태 확인
~$ mac env
KEY VALUE SOURCE
MASTER_IP 10.1.5.7 user
MAC_REGISTRY registry.example.com/mac user
SWITCH_USER admin user
SWITCH_PASSWD_LIST admin,123455 user