헬름 차트로 밀버스 스탠드얼론 업그레이드하기

이 가이드는 헬름 차트를 사용하여 Milvus 독립 실행형 배포를 v2.5.x에서 v2.6.16으로 업그레이드하는 방법을 설명한다.

시작하기 전에

v2.6.16의 새로운 기능

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

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

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

요구 사항

시스템 요구 사항:

  • 헬름 버전 >= 3.14.0
  • Kubernetes 버전 >= 1.20.0
  • 헬름 차트를 통해 배포된 Milvus 독립형

호환성 요구 사항:

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

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

밀버스 헬름 차트 버전 4.2.21부터 pulsar-v3.x 차트를 종속성으로 도입했습니다. 이전 버전과의 호환성을 위해 헬름을 v3.14 이상 버전으로 업그레이드하고 helm upgrade 을 사용할 때마다 --reset-then-reuse-values 옵션을 추가해야 한다.

업그레이드 프로세스

1단계: 헬름 차트 업그레이드

먼저, 밀버스 헬름 차트를 버전 5.0.0으로 업그레이드한다:

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech
https://milvus-io.github.io/milvus-helm/ 에 있는 밀버스 헬름 차트 리포지토리가 아카이브되었다. 차트 버전 4.0.31 이상에서는 새 리포지토리( https://zilliztech.github.io/milvus-helm/ )를 사용한다.

밀버스 버전과의 헬름 차트 버전 호환성을 확인하려면:

helm search repo zilliztech/milvus --versions

이 가이드는 최신 버전을 설치한다고 가정합니다. 특정 버전을 설치해야 하는 경우 그에 따라 --version 매개 변수를 지정하세요.

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

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

Milvus 스탠드얼론을 v2.5.16으로 업그레이드합니다:

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v2.5.16" \
  --reset-then-reuse-values \
  --version=4.2.58

업그레이드가 완료될 때까지 기다립니다:

# Verify all pods are ready
kubectl get pods

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

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

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v2.6.16" \
  --reset-then-reuse-values \
  --version=5.0.0

업그레이드 확인

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

# Check pod status
kubectl get pods

추가 지원이 필요한 경우 Milvus 설명서 또는 커뮤니티 포럼을 참조하세요.