Sobre Milvus
Começar a trabalhar
Conceitos
Guia do utilizador
Modelos
Migração de Milvus
Guia de Administração
Ferramentas
Integrações
Tutoriais
FAQs
API Reference

Atualizar o Milvus Standalone com o Helm Chart

Este guia descreve como atualizar seu Milvus standalone com Milvus Helm charts.

Pré-requisitos

Versão do Helm >= 3.14.0
Versão do Kubernetes >= 1.20.0

Desde a versão 4.2.21 do gráfico Milvus-Helm, introduzimos o gráfico pulsar-v3.x como dependência. Para compatibilidade com versões anteriores, atualize seu helm para a versão v3.14 ou posterior e certifique-se de adicionar a opção --reset-then-reuse-values sempre que usar helm upgrade.

Verificar a versão do Milvus

Execute os seguintes comandos para verificar as novas versões do Milvus.

$ helm repo update
$ helm search repo zilliztech/milvus --versions

O repositório Milvus Helm Charts em https://milvus-io.github.io/milvus-helm/ foi arquivado e pode obter mais actualizações em https://zilliztech.github.io/milvus-helm/ da seguinte forma:

helm repo add zilliztech https://zilliztech.github.io/milvus-helm
helm repo update zilliztech
# upgrade existing helm release
helm upgrade my-release zilliztech/milvus --reset-then-reuse-values

O repositório arquivado ainda está disponível para os gráficos até à versão 4.0.31. Para versões posteriores, utilize o novo repositório.

NAME                    CHART VERSION   APP VERSION             DESCRIPTION                                       
zilliztech/milvus       4.1.34          2.4.5                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.33          2.4.4                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.32          2.4.3                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.31          2.4.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.30          2.4.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.29          2.4.0                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.24          2.3.11                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.23          2.3.10                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.22          2.3.10                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.21          2.3.10                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.20          2.3.10                  Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.18          2.3.10                  Milvus is an open-source vector database built ... 
zilliztech/milvus       4.1.18          2.3.9                   Milvus is an open-source vector database built ...                                       
zilliztech/milvus       4.1.17          2.3.8                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.16          2.3.7                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.15          2.3.5                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.14          2.3.6                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.13          2.3.5                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.12          2.3.5                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.11          2.3.4                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.10          2.3.3                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.9           2.3.3                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.8           2.3.2                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.7           2.3.2                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.6           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.5           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.4           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.3           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.2           2.3.1                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.1           2.3.0                   Milvus is an open-source vector database built ...
zilliztech/milvus       4.1.0           2.3.0                   Milvus is an open-source vector database built ...

Pode escolher o caminho de atualização para o seu Milvus da seguinte forma:

Atualizar o Milvus utilizando o Helm para uma atualização de uma versão menor antes da v2.2.3 para a v2.4.18.
Migrar os metadados antes da atualização do Milvus v2.1.x para a v2.4.18.

Realizar uma atualização contínua

Desde a versão 2.2.3 do Milvus, é possível configurar os coordenadores do Milvus para funcionarem em modo de espera ativa e ativar a funcionalidade de atualização contínua para os mesmos, de modo a que o Milvus possa responder aos pedidos recebidos durante as actualizações dos coordenadores. Nas versões anteriores, os coordenadores devem ser removidos e depois criados durante uma atualização, o que pode provocar um certo tempo de inatividade do serviço.

As actualizações contínuas requerem que os coordenadores trabalhem em modo de espera ativa. Pode utilizar o script que fornecemos para configurar os coordenadores para trabalharem em modo de espera ativa e iniciar a atualização contínua.

Com base nos recursos de atualização contínua fornecidos pelo Kubernetes, o script acima impõe uma atualização ordenada das implantações de acordo com suas dependências. Além disso, o Milvus implementa um mecanismo para garantir que os seus componentes permanecem compatíveis com os que dependem deles durante a atualização, reduzindo significativamente o potencial tempo de inatividade do serviço.

O script aplica-se apenas à atualização do Milvus instalado com o Helm. A tabela a seguir lista os sinalizadores de comando disponíveis nos scripts.

Parâmetros	Descrição	Valor por defeito	Necessário
`i`	Nome da instância Milvus	`None`	Verdadeiro
`n`	Espaço de nomes em que o Milvus está instalado	`default`	Falso
`t`	Versão de destino do Milvus	`None`	Verdadeiro
`w`	Nova etiqueta de imagem do Milvus	`milvusdb/milvus:v2.2.3`	Verdadeiro
`o`	Funcionamento	`update`	Falso

Depois de se ter assegurado de que todas as implementações na sua instância Milvus estão no seu estado normal. Você pode executar o seguinte comando para atualizar a instância do Milvus para a versão 2.4.18.

sh rollingUpdate.sh -n default -i my-release -o update -t 2.4.18 -w 'milvusdb/milvus:v2.4.18'

O script não se aplica à instância do Milvus instalada com o RocksMQ.
O script codifica a ordem de atualização das implantações e não pode ser alterado.
O script usa kubectl patch para atualizar as implementações e kubectl rollout status para observar o seu estado.
O script usa kubectl patch para atualizar o rótulo app.kubernetes.io/version das implantações para aquele especificado após o sinalizador -t no comando.

Atualizar o Milvus usando o Helm

Para atualizar o Milvus de uma versão menor antes da v2.2.3 para a mais recente, execute os seguintes comandos:

helm repo update
helm upgrade my-release milvus/milvus --reset-then-reuse-values --version=4.1.24 # use the helm chart version here

Use a versão do Helm chart no comando anterior. Para obter detalhes sobre como obter a versão do Helm chart, consulte Verificar a versão do Milvus.

Migrar os metadados

Desde o Milvus 2.2.0, os metadados são incompatíveis com os das versões anteriores. Os exemplos a seguir pressupõem uma atualização do Milvus 2.1.4 para o Milvus 2.2.0.

1. Verificar a versão do Milvus

Execute $ helm list para verificar a versão da sua aplicação Milvus. Pode ver que APP VERSION é 2.1.4.

NAME                NAMESPACE   REVISION    UPDATED                                 STATUS      CHART           APP VERSION     
my-release          default     1           2022-11-21 15:41:25.51539 +0800 CST     deployed    milvus-3.2.18   2.1.4

2. Verificar os pods em execução

Execute $ kubectl get pods para verificar os pods em execução. Pode ver o seguinte resultado.

NAME                                            READY   STATUS    RESTARTS   AGE
my-release-etcd-0                               1/1     Running   0          84s
my-release-milvus-standalone-75c599fffc-6rwlj   1/1     Running   0          84s
my-release-minio-744dd9586f-qngzv               1/1     Running   0          84s

3. Verificar a etiqueta de imagem

Verifique a etiqueta de imagem para o pod my-release-milvus-proxy-6c548f787f-scspp. Pode ver que a versão do seu cluster Milvus é a v2.1.4.

$ kubectl get pods my-release-milvus-proxy-6c548f787f-scspp -o=jsonpath='{$.spec.containers[0].image}'
# milvusdb/milvus:v2.1.4

4. Migrar os metadados

Uma grande mudança no Milvus 2.2 é a estrutura de metadados dos índices de segmento. Por conseguinte, é necessário utilizar o Helm para migrar os metadados durante a atualização do Milvus da v2.1.x para a v2.2.0. Eis um script para migrar os metadados em segurança.

Este script se aplica apenas ao Milvus instalado em um cluster K8s. Se ocorrer um erro durante o processo, reverta primeiro para a versão anterior com a operação de reversão.

A tabela seguinte lista as operações que pode efetuar para a meta-migração.

Parâmetros	Descrição	Valor por defeito	Necessário
`i`	O nome da instância Milvus.	`None`	Verdadeiro
`n`	O espaço de nomes em que o Milvus está instalado.	`default`	Falso
`s`	A versão de origem do Milvus.	`None`	Verdadeiro
`t`	A versão de destino do Milvus.	`None`	Verdadeiro
`r`	O caminho da raiz do meta Milvus.	`by-dev`	Falso
`w`	A nova etiqueta de imagem do Milvus.	`milvusdb/milvus:v2.2.0`	Falso
`m`	A etiqueta de imagem da meta-migração.	`milvusdb/meta-migration:v2.2.0`	Falso
`o`	A operação de meta-migração.	`migrate`	Falso
`d`	Se deve ser eliminado o pod de migração após a conclusão da migração.	`false`	Falso
`c`	A classe de armazenamento para o pvc de metamigração.	`default storage class`	Falso
`e`	O ponto de acesso etcd utilizado pelo milvus.	`etcd svc installed with milvus`	Falso

1. Migrar os metadados

Descarregar o script de migração.
Parar os componentes do Milvus. Qualquer sessão em direto no Milvus etcd pode causar uma falha na migração.
Crie uma cópia de segurança para os metadados do Milvus.
Migrar os metadados do Milvus.
Inicie os componentes do Milvus com uma nova imagem.

2. Atualizar o Milvus da v2.1.x para a 2.4.18

Os comandos a seguir assumem que você atualizou o Milvus da v2.1.4 para a 2.4.18. Altere-os para as versões que atendam às suas necessidades.

Especifique o nome da instância do Milvus, a versão de origem do Milvus e a versão de destino do Milvus.
```
./migrate.sh -i my-release -s 2.1.4 -t 2.4.18
```
Especifique o espaço de nomes com -n se o seu Milvus não estiver instalado no espaço de nomes K8s predefinido.
```
./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.4.18
```
Especifique o caminho da raiz com -r se o seu Milvus estiver instalado com o rootpath personalizado.
```
./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.4.18 -r by-dev
```

Especifique a tag de imagem com -w se o seu Milvus estiver instalado com um image personalizado.

./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.4.18 -r by-dev -w milvusdb/milvus:v2.4.18

Defina -d true se pretender remover automaticamente o pod de migração após a conclusão da migração.
```
./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.4.18 -w milvusdb/milvus:v2.4.18 -d true
```

Reverter e migrar novamente se a migração falhar.

./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.4.18 -r by-dev -o rollback -w milvusdb/milvus:v2.1.1
./migrate.sh -i my-release -n milvus -s 2.1.4 -t 2.4.18 -r by-dev -o migrate -w milvusdb/milvus:v2.4.18

Traduzido por DeepL

Tabela de conteúdos

Atualizar o Milvus Standalone com o Helm Chart
Pré-requisitos
Verificar a versão do Milvus
Realizar uma atualização contínua
Atualizar o Milvus usando o Helm
Migrar os metadados

Try Managed Milvus for Free

Zilliz Cloud is hassle-free, powered by Milvus and 10x faster.

Get Started

Feedback

Esta página foi útil?