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
kubectlacesso 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.