본문으로 건너뛰기

예제

agent 등록, mac test, 스위치 접속 설정, 기본 로그인과 비밀번호 복구도 참고하세요.

프라이빗 미러로 전환​

MAC과 SDK 이미지를 미러에 복사하고 이미지를 다운로드하는 사용자로 docker login을 실행한 뒤 다음 명령을 실행하세요.

sudo mac env set --global MAC_REGISTRY=<registry-host>/<mac-path>
sudo mac env set --global SDK_AGENT_IMAGE=<registry-host>/<sdk-image>:<tag>
mac pull all
sudo mac restart all

Prometheus, Loki와 제조사 exporter 이미지의 위치는 바뀌지 않습니다.

mac clean 전 Prometheus 백업​

umask 077
docker stop mac-prometheus
docker cp mac-prometheus:/prometheus/. - > prometheus-backup.tar
docker start mac-prometheus
tar tf prometheus-backup.tar

이 백업에는 metric 데이터만 들어 있습니다. 전체 백업에는 API 데이터와 알림 설정, mac-loki-data, 설정 파일과 토큰 파일도 포함해야 합니다. 백업은 비공개 디렉터리에 보관하세요.

Prometheus 복원​

경고

다음 명령은 현재 metric을 모두 삭제합니다. 아카이브를 먼저 검증하고, 기본 MAC 볼륨에만 사용하세요.

컨테이너가 제거된 상태라면 master를 한 번 시작해 컨테이너를 생성한 뒤 다음 명령을 실행하세요.

docker stop mac-prometheus
docker run --rm --pull=never --user 0 -v mac-prometheus-data:/data --entrypoint sh \
  "$(docker inspect -f '{{.Image}}' mac-prometheus)" -c 'rm -rf /data/* /data/.[!.]*'
docker run --rm -i --pull=never --user 0 -v mac-prometheus-data:/data --entrypoint sh \
  "$(docker inspect -f '{{.Image}}' mac-prometheus)" -c 'tar xpf - -C /data' < prometheus-backup.tar
docker start mac-prometheus

계정, node 등록, 알림 설정 백업 및 복원​

master에서 API 데이터와 mac-prometheus-targets 볼륨을 백업하세요. API 데이터에는 저장된 BMC 자격 증명을 복호화하는 키, 계정, 감사 기록과 혼잡 이벤트가 있습니다. api-server를 중지한 상태에서 숨김 파일(.bmc_key, .jwt_secret)과 SQLite 데이터베이스의 WAL/SHM 보조 파일을 함께 보관하세요. mac-prometheus-targets에는 알림 규칙, 알림 확인 상태와 패브릭 링크가 저장됩니다.

umask 077
docker stop mac-api-server
docker cp mac-api-server:/app/data/. - > api-data-backup.tar
docker cp mac-api-server:/etc/prometheus/targets/. - > targets-backup.tar
docker start mac-api-server
tar tf api-data-backup.tar
tar tf targets-backup.tar
경고

복원하면 현재 계정, node 등록 정보, 알림 규칙과 그 밖의 API 데이터가 삭제되고, 백업 이후의 변경 내용도 사라집니다. 아카이브를 먼저 검증하고, 기본 MAC 볼륨에만 사용하세요.

컨테이너가 제거된 상태라면 master를 한 번 시작해 컨테이너를 생성한 뒤 다음 명령을 실행하세요.

docker stop mac-api-server
docker run --rm --pull=never --user 0 -v mac-api-data:/app/data --entrypoint sh \
  "$(docker inspect -f '{{.Image}}' mac-api-server)" -c 'rm -rf /app/data/* /app/data/.[!.]*'
docker run --rm -i --pull=never --user 0 -v mac-api-data:/app/data --entrypoint sh \
  "$(docker inspect -f '{{.Image}}' mac-api-server)" -c 'tar xpf - -C /app/data' < api-data-backup.tar
docker run --rm --pull=never --user 0 -v mac-prometheus-targets:/targets --entrypoint sh \
  "$(docker inspect -f '{{.Image}}' mac-api-server)" -c 'rm -rf /targets/* /targets/.[!.]*'
docker run --rm -i --pull=never --user 0 -v mac-prometheus-targets:/targets --entrypoint sh \
  "$(docker inspect -f '{{.Image}}' mac-api-server)" -c 'tar xpf - -C /targets' < targets-backup.tar
docker start mac-api-server

로그인, 등록된 node, 저장된 BMC 연결과 알림 규칙을 확인하세요.

드라이버 업그레이드 후 agent 다시 시작​

GPU 드라이버를 업그레이드한 뒤 mac restart agent와 mac test --expect agent를 실행하고, GPU metric이 표시되는지 확인하세요.