헬름 차트로 밀버스 클러스터 업그레이드하기

이 가이드는 헬름 차트를 사용하여 Milvus 클러스터를 v2.5.x에서 v2.6.15로 업그레이드하는 방법을 설명한다.

시작하기 전에

v2.6.15의 새로운 기능

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

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

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

요구 사항

시스템 요구 사항:

• 헬름 버전 >= 3.14.0
• Kubernetes 버전 >= 1.20.0
• 헬름 차트를 통해 배포된 Milvus 클러스터

호환성 요구 사항:

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

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

업그레이드 프로세스

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

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

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech

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

helm search repo zilliztech/milvus --versions

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

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

현재 클러스터에서 별도의 코디네이터를 사용하고 있는지 확인합니다:

kubectl get pods

별도의 코디네이터 파드(datacoord, querycoord, indexcoord)가 표시되면 v2.5.16으로 업그레이드하고 mixCoordinator 을 활성화합니다:

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v2.5.16" \
  --set mixCoordinator.enabled=true \
  --set rootCoordinator.enabled=false \
  --set indexCoordinator.enabled=false \
  --set queryCoordinator.enabled=false \
  --set dataCoordinator.enabled=false \
  --reset-then-reuse-values \
  --version=4.2.58

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.15로 업그레이드하기

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

helm upgrade my-release zilliztech/milvus \
  --set image.all.tag="v2.6.15" \
  --set streaming.enabled=true \
  --set indexNode.enabled=false \
  --reset-then-reuse-values \
  --version=5.0.0

업그레이드 확인

클러스터에서 새 버전이 실행되고 있는지 확인합니다:

# Check pod status
kubectl get pods

# Verify Helm release
helm list

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