Atualização do Cluster Milvus com Helm Chart

Este guia descreve como atualizar seu cluster Milvus da v2.5.x para a v2.6.16 usando o Helm Chart.

Antes de começar

O que há de novo na versão 2.6.16

A atualização do Milvus 2.5.x para a versão 2.6.16 envolve mudanças significativas na arquitetura:

• Consolidação de coordenadores: Os coordenadores separados (dataCoord, queryCoord, indexCoord) foram consolidados num único mixCoord
• Novos componentes: Introdução do Streaming Node para um melhor processamento de dados
• Remoção de componentes: indexNode removido e consolidado

Este processo de atualização assegura a migração adequada para a nova arquitetura. Para obter mais informações sobre as alterações à arquitetura, consulte a Descrição geral da arquitetura do Milvus.

Requisitos

Requisitos do sistema:

• Versão do Helm >= 3.14.0
• Versão do Kubernetes >= 1.20.0
• Cluster Milvus implantado via Helm Chart

Requisitos de compatibilidade:

• O Milvus v2.6.0-rc1 não é compatível com a v2.6.16. Não são suportadas actualizações diretas a partir de versões candidatas.
• Se estiver a executar atualmente a v2.6.0-rc1 e necessitar de preservar os seus dados, consulte este guia da comunidade para obter assistência na migração.
• É necessário atualizar para a v2.5.16 ou posterior com mixCoordinator ativado antes de atualizar para a v2.6.16.

Limitações da fila de mensagens: Ao atualizar para a versão 2.6.16 do Milvus, tem de manter a sua escolha atual de filas de mensagens. Não é possível alternar entre diferentes sistemas de filas de mensagens durante a atualização. O suporte para a mudança de sistemas de filas de mensagens estará disponível em versões futuras.

Processo de atualização

Passo 1: Atualizar o Helm Chart

Em primeiro lugar, actualize o gráfico do Milvus Helm para a versão 5.0.0:

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

Para verificar a compatibilidade da versão do Helm Charts com as versões do Milvus:

helm search repo zilliztech/milvus --versions

Este guia pressupõe que está a instalar a versão mais recente. Se precisar de instalar uma versão específica, especifique o parâmetro --version em conformidade.

Etapa 2: Atualizar para a versão 2.5.16 com o mixCoordinator

Verifique se o cluster usa atualmente coordenadores separados:

kubectl get pods

Se vir pods de coordenador separados (datacoord, querycoord, indexcoord), actualize para a v2.5.16 e active 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

Aguarde até que a atualização seja concluída:

# Verify all pods are ready
kubectl get pods

Passo 3: Atualização para a v2.6.16

Quando a versão 2.5.16 estiver a funcionar com êxito com mixCoordinator, actualize para a versão 2.6.16:

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

Verificar a atualização

Confirme se o seu cluster está a executar a nova versão:

# Check pod status
kubectl get pods

# Verify Helm release
helm list

Para obter suporte adicional, consulte a documentação do Milvus ou o fórum da comunidade.