• Sobre a Milvus
  • Começar
  • Conceitos
  • Guia do Utilizador
  • Importação de dados
  • Ferramentas de IA
  • Guia de Administração
  • Ferramentas
  • Integrações
  • Tutoriais
  • Perguntas frequentes
  • API Reference

Atualizar o cluster Milvus com o Milvus Operator

Este guia descreve como atualizar um cluster Milvus 2.6.x para a versão 3.0.5 com o Milvus Operator.

Este procedimento foi validado da versão Milvus 2.6.20 para a v3.0.5 com o Milvus Operator 1.3.0, MixCoord, StreamingNode, Woodpecker, etcd no cluster e MinIO no cluster. Se utilizar outra versão de patch do Milvus 2.6.x, versão do Operator, topologia de componentes, fila de mensagens ou configuração de dependências, valide primeiro a atualização num ambiente que não seja de produção.

Pré-requisitos

  • Um cluster Kubernetes com um cluster Milvus 2.6.x gerido pelo Milvus Operator
  • kubectl acesso ao cluster
  • O manifesto completo do recurso personalizado (CR) do Milvus utilizado na implementação existente
  • O método de instalação e os manifestos utilizados para o Milvus Operator existente
  • Uma cópia de segurança atualizada dos metadados e dados persistentes do Milvus

Limitações da fila de mensagens: Ao atualizar para o Milvus v3.0.5, deve manter a sua escolha atual de fila de mensagens. A alternância entre diferentes sistemas de filas de mensagens durante a atualização não é suportada. O suporte à alteração de sistemas de filas de mensagens estará disponível em versões futuras.

Aplique o CR completo do Milvus para esta atualização. Não utilize um patch de fusão apenas de imagem. O Operator pode preencher por defeito campos de componentes omitidos com zero réplicas, o que pode reativar um componente que a implementação 2.6.x existente tenha desativado.

Este procedimento não valida um downgrade ou uma reversão que consista em alterar a imagem do Milvus de volta para a versão 2.6.x. Depois de a v3.0.5 gravar dados, uma reversão apenas da imagem pode não conseguir ler o estado atualizado. Se a atualização falhar, interrompa as gravações e utilize um plano de recuperação que restaure os metadados pré-atualização e as cópias de segurança dos dados persistentes. Valide primeiro o plano de recuperação num ambiente que não seja de produção.

Processo de atualização

Passo 1: Fazer uma cópia de segurança do CR atual do Milvus

Guarde o CR atual antes de alterar a implementação:

kubectl get milvus <instance-name> \
  --namespace <namespace> \
  --output yaml > milvus-before-upgrade.yaml

Utilize o manifesto de origem da sua implementação existente como manifesto de atualização. Não aplique diretamente o ficheiro de cópia de segurança exportado sem primeiro remover os metadados geridos pelo servidor e os campos de estado.

Passo 2: Confirmar a versão do Milvus Operator

Verifique a imagem utilizada pelo Milvus Operator instalado:

kubectl get deployments --all-namespaces \
  -o jsonpath='{range .items[*]}{.metadata.namespace}{"\t"}{.metadata.name}{"\t"}{range .spec.template.spec.containers[*]}{.image}{" "}{end}{"\n"}{end}' \
  | grep milvus-operator

A atualização validada manteve o Milvus Operator na versão 1.3.0. Mantenha a versão do Operator que atualmente gere a sua implementação do Milvus 2.6.x, a menos que a sua política de suporte exija uma atualização separada do Operator. Não faça o downgrade de um Operator mais recente para a versão testada. Se precisar de alterar a versão do Operator, utilize o mesmo método de instalação do Helm ou do kubectl e o mesmo nome de versão e namespace que a instalação existente; em seguida, valide a alteração do Operator antes de atualizar o Milvus CR.

Passo 3: Atualizar a imagem do Milvus

No manifesto completo do CR do Milvus, altere spec.components.image para a versão de destino. Mantenha o modo atual, a topologia dos componentes, a fila de mensagens, o etcd, o armazenamento e outras definições de dependências. O excerto seguinte mostra os campos a confirmar; não substitua o seu CR completo por este excerto.

Antes de aplicar o CR de destino, confirme que indexNode.replicas é 0. A configuração validada do Milvus 2.6.20 já utilizava esta definição. Mantenha a definição explícita de zero réplicas no CR de destino.

apiVersion: milvus.io/v1beta1
kind: Milvus
metadata:
  name: <instance-name>
  namespace: <namespace>
spec:
  components:
    image: milvusdb/milvus:v3.0.5
    indexNode:
      replicas: 0

Aplique o manifesto CR completo:

kubectl apply --filename milvus.yaml

Verifique a atualização

Verifique o estado do CR, o estado do Pod e as imagens dos contentores:

kubectl get milvus <instance-name> \
  --namespace <namespace> \
  --output jsonpath='{.status.status}{"\t"}{.status.currentImage}{"\n"}'

kubectl get pods --namespace <namespace>

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

Verifique se o CR do Milvus indica « Healthy », se todos os componentes do Milvus utilizam « milvusdb/milvus:v3.0.5 », se nenhum Pod do IndexNode está em execução e se as coleções existentes continuam a poder ser consultadas e pesquisadas. Conclua estas verificações antes de ativar qualquer funcionalidade específica da versão 3.0.5.

Traduzido porDeepL

Experimente o Milvus gerenciado gratuitamente

O Zilliz Cloud é descomplicado, powered by Milvus e 10x mais rápido.

Começar
Feedback

Esta página foi útil?