Todos os produtos
Search
Central de documentação

Container Service for Kubernetes:[Atualizações de componentes] Atualize o Helm V2 para V3

Última atualização: Sep 09, 2026

O Tiller do Helm V2 tem uma vulnerabilidade de segurança conhecida que permite a invasores instalar aplicações não autorizadas em um cluster. Atualize para o Helm V3 para eliminar esse risco.

Escopo de impacto

Execute

kubectl get deploy -n kube-system tiller-deploy

para verificar se existe um Deployment do Tiller. Se existir, verifique:

  • O kubeconfig do cluster é compartilhado com usuários externos.

  • O acesso externo ao console do ACK está permitido.

  • O cluster opera em modo multitenancy com isolamento de privilégios de usuário.

Se qualquer condição for verdadeira, atualize para o Helm V3.

Alternativa: Atualize apenas o Tiller

Se seu cluster não for afetado ou não for possível atualizar para o Helm V3, atualize o Tiller para a versão mais recente.

  1. Atualize o Tiller:

    helm init --tiller-image registry.cn-hangzhou.aliyuncs.com/acs/tiller:v2.16.3 --upgrade
  2. Após o Tiller passar na verificação de integridade, execute helm version para confirmar a atualização.

    Este procedimento atualiza apenas o componente de servidor do Helm. Baixe separadamente o componente cliente correspondente ao seu sistema operacional.

Nota

Se seu cluster não for afetado ou se a atualização para o Helm V3 não estiver disponível, atualize o Tiller e ignore as etapas restantes. Você poderá atualizar para o Helm V3 posteriormente.

Verificação prévia

Verifique o estado do seu cluster antes de iniciar a atualização para o Helm V3.

  1. Execute kubectl get deploy -n kube-system tiller-deploy para confirmar se o Tiller está instalado.

  2. Se o Tiller existir, execute helm ls -a para listar as aplicações instaladas.

  3. Se houver aplicações, exclua-as. Os formatos de dados do Helm V2 e V3 são incompatíveis.

    Importante

    A comunidade Helm disponibiliza o

    helm-2to3

    para migrar configurações e releases da V2 para a V3. Para evitar perda de dados, use este plug-in com cautela.

Procedimento

  1. Conclua a Verificação prévia.

  2. Exclua o Deployment do Tiller: kubectl delete deploy tiller-deploy -n kube-system.

  3. Baixe o cliente Helm V3 e reinstale suas aplicações.

    Importante

    Antes de reinstalar as aplicações:

    • Reinstale as aplicações do Helm V2 com o Helm V3. Avalie o impacto em suas cargas de trabalho.

    • A reinstalação causa perda de dados. Faça backup dos seus dados antes de prosseguir.