Docker Compose로 Milvus 스탠드얼론 업그레이드하기

이 가이드는 Docker Compose를 사용하여 Milvus 독립 실행형 배포를 v2.5.x에서 v2.6.16으로 업그레이드하는 방법을 설명합니다.

시작하기 전에

v2.6.16의 새로운 기능

Milvus 2.5.x에서 2.6.16으로 업그레이드하려면 아키텍처가 크게 변경됩니다:

  • 코디네이터 통합: 기존의 개별 코디네이터 (dataCoord, queryCoord, indexCoord)가 단일 코디네이터로 통합되었습니다. mixCoord
  • 새로운 구성 요소: 향상된 데이터 처리를 위한 스트리밍 노드 도입
  • 구성 요소 제거: indexNode 제거 및 통합

이 업그레이드 프로세스는 새로운 아키텍처로의 적절한 마이그레이션을 보장합니다. 아키텍처 변경에 대한 자세한 내용은 Milvus 아키텍처 개요를 참조하세요.

요구 사항

시스템 요구 사항:

  • Docker 및 Docker Compose 설치됨
  • Docker Compose를 통해 배포된 Milvus 스탠드얼론

호환성 요구 사항:

  • Milvus v2.6.0-rc1은 v2.6.16과 호환되지 않습니다. 릴리스 후보에서 직접 업그레이드는 지원되지 않습니다.
  • 현재 v2.6.0-rc1을 실행 중이며 데이터를 보존해야 하는 경우 이 커뮤니티 가이드에서 마이그레이션 지원을 참조하세요.
  • v2.6.16으로 업그레이드하기 전에 v2.5.16 이상으로 업그레이드해야 합니다.

메시지 큐 제한: Milvus v2.6.16으로 업그레이드할 때 현재 선택한 메시지 큐를 유지해야 합니다. 업그레이드 중에 다른 메시지 큐 시스템 간에 전환하는 것은 지원되지 않습니다. 메시지 큐 시스템 변경에 대한 지원은 향후 버전에서 제공될 예정입니다.

보안 문제로 인해 Milvus는 v2.6.16 릴리스와 함께 MinIO를 RELEASE.2024-12-18T13-15-44Z로 업그레이드합니다.

업그레이드 프로세스

1단계: v2.5.16으로 업그레이드하기

독립 실행형 배포가 이미 v2.5.16 이상을 실행 중인 경우 이 단계를 건너뛰세요.

  1. 기존 docker-compose.yaml 파일을 편집하고 Milvus 이미지 태그를 v2.5.16으로 업데이트합니다:

    ...
    standalone:
      container_name: milvus-standalone
      image: milvusdb/milvus:v2.5.16
    ...
    
  2. v2.5.16으로 업그레이드를 적용합니다:

    docker compose down
    docker compose up -d
    
  3. v2.5.16 업그레이드를 확인합니다:

    docker compose ps
    

2단계: v2.6.16으로 업그레이드하기

v2.5.16이 성공적으로 실행되면 v2.6.16으로 업그레이드합니다:

  1. 기존 docker-compose.yaml 파일을 편집하고 Milvus 및 MinIO 이미지 태그를 모두 업데이트합니다:

    ...
    minio:
      container_name: milvus-minio
      image: minio/minio:RELEASE.2024-12-18T13-15-44Z
    
    ...
    standalone:
      container_name: milvus-standalone
      image: milvusdb/milvus:v2.6.16
    
  2. 최종 업그레이드를 적용합니다:

    docker compose down
    docker compose up -d
    

업그레이드 확인

독립 실행형 배포에서 새 버전이 실행되고 있는지 확인합니다:

# Check container status
docker compose ps

# Check Milvus version
docker compose logs standalone | grep "version"

다음 단계