Milvus Operator로 Milvus 클러스터 업그레이드하기
이 가이드는 Milvus Operator를 사용하여 Milvus 클러스터를 v2.5.x에서 v2.6.15로 업그레이드하는 방법을 설명합니다.
시작하기 전에
v2.6.15의 새로운 기능
Milvus 2.5.x에서 2.6.15로 업그레이드하려면 아키텍처가 크게 변경됩니다:
- 코디네이터 통합: 기존의 개별 코디네이터 (
dataCoord,queryCoord,indexCoord)가 단일 코디네이터로 통합되었습니다.mixCoord - 새로운 구성 요소: 향상된 데이터 처리를 위한 스트리밍 노드 도입
- 구성 요소 제거:
indexNode제거 및 통합
이 업그레이드 프로세스는 새로운 아키텍처로의 적절한 마이그레이션을 보장합니다. 아키텍처 변경에 대한 자세한 내용은 Milvus 아키텍처 개요를 참조하세요.
요구 사항
시스템 요구 사항:
- Milvus Operator를 통해 배포된 Milvus가 포함된 Kubernetes 클러스터
kubectl클러스터에 액세스하도록 구성된- 헬름 3.x 설치
호환성 요구 사항:
- Milvus v2.6.0-rc1은 v2.6.15와 호환되지 않는다. 릴리스 후보에서 직접 업그레이드는 지원되지 않는다.
- 현재 v2.6.0-rc1을 실행 중이며 데이터를 보존해야 하는 경우 이 커뮤니티 가이드에서 마이그레이션 지원을 참조하세요.
- v2.6.15로 업그레이드하기 전에
mixCoord을 활성화하여 v2.5.16 이상으로 업그레이드해야 합니다.
메시지 큐 제한: Milvus v2.6.15로 업그레이드할 때 현재 선택한 메시지 큐를 유지해야 합니다. 업그레이드 중에 다른 메시지 큐 시스템 간에 전환하는 것은 지원되지 않습니다. 메시지 큐 시스템 변경에 대한 지원은 향후 버전에서 제공될 예정입니다.
업그레이드 프로세스
1단계: Milvus 운영자 업그레이드하기
먼저 Milvus 운영자를 v1.3.0으로 업그레이드합니다:
helm repo add zilliztech-milvus-operator https://zilliztech.github.io/milvus-operator/
helm repo update zilliztech-milvus-operator
helm -n milvus-operator upgrade milvus-operator zilliztech-milvus-operator/milvus-operator
운영자 업그레이드를 확인합니다:
kubectl -n milvus-operator get pods
2단계: Milvus 클러스터 업그레이드하기
2.1 현재 코디네이터 구성 확인
클러스터가 이미 mixCoord 을 사용하고 있는지 확인합니다:
kubectl get pods
대신 별도의 코디네이터 파드(datacoord, querycoord, indexcoord)가 표시되는 경우 다음 단계에서 mixCoord 을 활성화해야 합니다.
2.2 mixCoord로 v2.5.16으로 업그레이드하기
클러스터가 이미 mixCoord 를 활성화하여 v2.5.16 이상을 실행 중인 경우 이 단계를 건너뛰세요.
구성 파일 milvusupgrade.yaml 을 생성하여 mixCoord 을 활성화하고 v2.5.16으로 업그레이드합니다:
apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
name: my-release # Replace with your actual release name
spec:
components:
mixCoord:
replicas: 1
image: milvusdb/milvus:v2.5.16
구성을 적용합니다:
kubectl patch -f milvusupgrade.yaml --patch-file milvusupgrade.yaml --type merge
완료될 때까지 기다립니다:
# Verify all pods are ready
kubectl get pods
2.3 v2.6.15로 업그레이드하기
mixCoord 에서 v2.5.16이 성공적으로 실행되면 v2.6.15로 업그레이드하세요:
구성 파일을 업데이트합니다(이 예에서는milvusupgrade.yaml ):
apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
name: my-release # Replace with your actual release name
spec:
components:
image: milvusdb/milvus:v2.6.15
최종 업그레이드를 적용합니다:
kubectl patch -f milvusupgrade.yaml --patch-file milvusupgrade.yaml --type merge
업그레이드 확인
클러스터에서 새 버전이 실행되고 있는지 확인합니다:
# Check pod status
kubectl get pods
추가 지원이 필요한 경우 Milvus 설명서 또는 커뮤니티 포럼을 참조하세요.