도커 컴포즈로 밀버스 클러스터 업그레이드하기

이 항목은 도커 컴포즈를 사용하여 Milvus를 업그레이드하는 방법을 설명합니다.

일반적인 경우, 이미지를 변경하여 Milvus를 업그레이드할 수 있습니다. 그러나 v2.1.x에서 v2.5.0으로 업그레이드하기 전에 메타데이터를 마이그레이션해야 합니다.

이미지를 변경하여 Milvus 업그레이드하기

일반적인 경우 다음과 같이 Milvus를 업그레이드할 수 있습니다:

1. docker-compose.yaml 에서 Milvus 이미지 태그를 변경합니다.

   프록시, 모든 코디네이터, 모든 워커 노드에 대한 이미지 태그를 변경해야 한다는 점에 유의하세요.

   ...
   rootcoord:
     container_name: milvus-rootcoord
     image: milvusdb/milvus:v2.5.0
   ...
   proxy:
     container_name: milvus-proxy
     image: milvusdb/milvus:v2.5.0
   ...
   querycoord:
     container_name: milvus-querycoord
     image: milvusdb/milvus:v2.5.0  
   ...
   querynode:
     container_name: milvus-querynode
     image: milvusdb/milvus:v2.5.0
   ...
   indexcoord:
     container_name: milvus-indexcoord
     image: milvusdb/milvus:v2.5.0
   ...
   indexnode:
     container_name: milvus-indexnode
     image: milvusdb/milvus:v2.5.0 
   ...
   datacoord:
     container_name: milvus-datacoord
     image: milvusdb/milvus:v2.5.0   
   ...
   datanode:
     container_name: milvus-datanode
     image: milvusdb/milvus:v2.5.0
   

2. 다음 명령을 실행하여 업그레이드를 수행합니다.

   docker compose down
   docker compose up -d
   

메타데이터 마이그레이션

1. 모든 Milvus 컴포넌트를 중지합니다.

   docker stop <milvus-component-docker-container-name>
   

2. 메타 마이그레이션을 위해 구성 파일 migrate.yaml 을 준비합니다.

   # migration.yaml
   cmd:
     # Option: run/backup/rollback
     type: run
     runWithBackup: true
   config:
     sourceVersion: 2.1.4   # Specify your milvus version
     targetVersion: 2.5.0
     backupFilePath: /tmp/migration.bak
   metastore:
     type: etcd
   etcd:
     endpoints:
       - milvus-etcd:2379  # Use the etcd container name
     rootPath: by-dev # The root path where data is stored in etcd
     metaSubPath: meta
     kvSubPath: kv
   

3. 마이그레이션 컨테이너를 실행합니다.

   # Suppose your docker-compose run with the default milvus network,
   # and you put migration.yaml in the same directory with docker-compose.yaml.
   docker run --rm -it --network milvus -v $(pwd)/migration.yaml:/milvus/configs/migration.yaml milvus/meta-migration:v2.2.0 /milvus/bin/meta-migration -config=/milvus/configs/migration.yaml
   

4. 새 Milvus 이미지로 Milvus 컴포넌트를 다시 시작합니다.

   Update the milvus image tag in the docker-compose.yaml
   docker compose down
   docker compose up -d
   

다음 단계

• 다음 방법을 알아보세요:
  • Milvus 클러스터 확장하기
• 클라우드에 클러스터를 배포할 준비가 되었다면:
  • Terraform을 사용하여 Amazon EKS에 Milvus를 배포하는 방법 알아보기
  • Kubernetes를 사용하여 GCP에 Milvus 클러스터를 배포하는 방법 알아보기
  • Kubernetes를 사용하여 Microsoft Azure에 Milvus를 배포하는 방법 알아보기