MilvusOperator, Helm, DockerCompose

Helm 차트를 사용하여 Milvus 독립형 버전 업그레이드

이 가이드에서는 Helm을 사용하여 Milvus 2.6.x 독립형 배포 환경을 v3.0.2로 업그레이드하는 방법을 설명합니다.

이 절차는 Milvus Helm 차트 5.0.22를 사용하여 Milvus 2.6.20에서 Milvus v3.0.2로 업그레이드하는 경우 검증되었습니다. 다른 Milvus 2.6.x 패치 릴리스나 Helm 차트 버전을 사용하는 경우, 먼저 비생산 환경에서 업그레이드를 검증하십시오.

필수 조건

  • Helm 3.14.0 이상
  • Helm으로 관리되는 기존 Milvus 2.6.x 배포
  • 기존 배포에 사용된 Helm 값
  • Milvus 메타데이터 및 영구 데이터의 최신 백업

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

이 절차의 일환으로 Helm 차트를 변경하거나 다운그레이드하지 마십시오. Helm 릴리스에 이미 설치된 차트 버전을 유지하십시오. 테스트된 기준 환경에서는 Helm 차트 5.0.22를 그대로 유지하고 Milvus 이미지 태그만 v3.0.2 로 변경했습니다.

이 절차는 Milvus 이미지를 2.6.x로 되돌리는 다운그레이드 또는 롤백을 검증하지 않습니다. v3.0.2가 데이터를 기록한 후에는, 이미지만 롤백할 경우 업데이트된 상태를 읽지 못할 수 있습니다. 업그레이드가 실패하면 쓰기 작업을 중지하고, 업그레이드 전 메타데이터와 영구 데이터 백업을 복원하는 복구 계획을 사용하십시오. 복구 계획은 먼저 비생산 환경에서 검증하십시오.

업그레이드 절차

1단계: Helm 저장소 업데이트

Milvus Helm 저장소를 추가하거나 업데이트하십시오.

helm repo add zilliztech https://zilliztech.github.io/milvus-helm --force-update
helm repo update zilliztech
https://milvus-io.github.io/milvus-helm/ 에 있는 Milvus Helm 차트 저장소는 아카이브 처리되었습니다. 차트 버전 4.0.31 이상은 새로운 저장소 https://zilliztech.github.io/milvus-helm/ 를 사용하십시오.

2단계: Milvus 업그레이드

Helm 릴리스에 설치된 차트 버전을 확인하십시오:

helm list --namespace <namespace>

CHART 열에서 값의 milvus- 접두사를 제거하고, 남은 버전을 <current-chart-version> 형식으로 사용합니다. 그런 다음 업그레이드 명령을 실행합니다:

helm upgrade <release-name> zilliztech/milvus \
  --namespace <namespace> \
  --version <current-chart-version> \
  --set image.all.tag="v3.0.2" \
  --reset-then-reuse-values \
  --wait \
  --timeout 20m

--reset-then-reuse-values 옵션은 이전 릴리스의 값을 유지하면서, 선택한 차트 기본값에 대해 명시적인 이미지 재정의(override)를 적용합니다.

업그레이드 확인

Helm 리비전, Pod 상태 및 컨테이너 이미지를 확인하세요:

helm history <release-name> --namespace <namespace>

kubectl get pods --namespace <namespace>

kubectl get pods --namespace <namespace> \
  -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{range .spec.containers[*]}{.image}{" "}{end}{"\n"}{end}'

모든 필수 워크로드가 준비되었는지, Milvus가 ` v3.0.2`를 사용하는지, 기존 컬렉션을 계속 쿼리하고 검색할 수 있는지 확인하십시오. v3.0.2 전용 기능을 활성화하기 전에 이러한 확인 작업을 완료하십시오.

Milvus 3.0으로 업그레이드한다고 해서 Storage V3가 활성화되는 것은 아닙니다. 업그레이드를 확인한 후, Storage V3에 의존하는 기능을 활성화하기 전에 Storage V3에 대해 검토하십시오. Milvus가 Storage V3 데이터를 한 번 기록하면, Storage V3를 읽을 수 없는 이전 Milvus 버전으로의 다운그레이드는 지원되지 않습니다.

번역DeepL

관리형 Milvus를 무료로 사용해 보세요

Zilliz Cloud는 번거로움이 없으며, Milvus 기반으로 10배 더 빠릅니다.

시작하기
피드백

이 페이지가 도움이 되었나요?