본문으로 건너뛰기

예제

mac으로 자주 마주치는 실전 워크플로우의 복붙용 스니펫을 모았습니다.

새 에이전트 등록​

~$ mac env set MASTER_IP=10.1.5.7
~$ mac pull agent
~$ mac start agent

클러스터 전체 헬스 체크​

~$ mac test                 # 마스터에서, 또는 MASTER_IP가 설정된 어느 노드에서든
~$ echo $?                  # 0 = 전부 통과, 1 = 실패 있음, 2 = 마스터 도달 불가

명령 한 번으로 해당 노드의 모든 MAC 서비스 — 올인원 배포에서는 마스터와 에이전트 서비스를 함께 — 와 핵심 클러스터 API를 점검합니다. 로그인이 필요 없어 cron 작업이나 CI 게이트에 적합합니다. 먼저 mac start로 스택을 띄우세요. mac test는 실행 중인 배포를 점검만 합니다.

로컬 개발 빌드 실행​

~$ export MAC_CONFIG_DIR=$PWD/deploy    # 소스 체크아웃에서
~$ mac build master                     # ./services에서 이미지 빌드
~$ mac start master --local             # 방금 빌드한 이미지를 그대로 실행

프라이빗 미러로 전환​

~$ mac env set MAC_REGISTRY=registry.internal.example.com/mac
~$ mac pull all
~$ mac restart all

혼재된 플릿의 스위치 SSH 자격 증명 설정​

~$ mac env set SWITCH_USER=admin SWITCH_PASSWD_LIST=admin,123455,YourThirdPassword
~$ mac restart master

mac clean 전에 Prometheus 백업​

~$ docker run --rm \
    -v mac-prometheus-data:/data \
    -v $(pwd):/backup \
    alpine tar czf /backup/prometheus-backup-$(date +%Y%m%d).tgz /data
~$ mac clean

Prometheus 복구​

~$ docker volume create mac-prometheus-data
~$ docker run --rm \
    -v mac-prometheus-data:/data \
    -v $(pwd):/backup \
    alpine tar xzf /backup/prometheus-backup-20260128.tgz -C /
~$ mac start master

최초 admin 비밀번호 미리 설정​

~$ mac env set MAC_ADMIN_PASSWORD='S3curity!'
~$ mac start master      # 최초 기동 한 번만 이 값이 반영됩니다

admin 비밀번호 사후 재설정​

~$ mac stop master
~$ docker volume rm mac-auth-data
~$ mac env set MAC_ADMIN_PASSWORD='New-S3cur1ty!'
~$ mac start master

드라이버 업그레이드 후 에이전트 재로드​

~$ sudo apt install -y --only-upgrade nvidia-driver-590
~$ mac restart agent

마스터의 metrics-bridge가 자동으로 다시 에이전트를 인식하므로, 마스터 재시작은 필요하지 않습니다.