Pular para o conteúdo principal
Versão: 3.19.0

Instalando o Helm

Esse guia ensina como instalar a CLI do Helm. O Helm pode ser instalado a partir do código-fonte, ou mesmo de um binário pré-buildado.

A partir do Projeto Helm​

O projeto Helm disponibiliza duas maneiras de baixar e instalar o Helm. Essas são as formas oficiais de se obter as versões do Helm. Além disso, a comunidade do Helm disponibiliza alternativas de download através de diversos gerenciadores de pacotes. A seção de instalação pelos gerenciadores de pacotes se encontra abaixo dos métodos oficiais.

A partir das Releases dos Binários​

Cada release do Helm gera distribuições do binário para uma gama de sistemas operacionais. Essas versões de binários podem ser baixadas manualmente e instaladas.

  1. Baixe uma versão desejada
  2. Descompacte-a (tar -zxvf helm-v3.0.0-linux-amd64.tar.gz)
  3. Encontre o binário helm no diretório descompactado e mova-o para um diretório de destino (mv linux-amd64/helm /usr/local/bin/helm)

A partir daí, você já deve conseguir rodar o cliente e adicionar um repositório dos Charts do Helm: helm help.

Nota: Os testes automatizados do Helm são realizados para a plataforma Linux AMD64 somente durante os builds e releases do GitHub Actions. Testes para outros sistemas operacionais não estão cobertos e são de responsabilidade da comunidade em solicitá-los.

A partir do Script​

O Helm agora conta com um script que automaticamente baixará a última versão disponível do Helm e instalará localmente.

Baixe o script e execute-o localmente. O script está bem escrito e documentado, podendo ser verificado e revisado antes de proceder com a instalação local.

$ curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3
$ chmod 700 get_helm.sh
$ ./get_helm.sh

Sim, você pode executar curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash se você gosta de viver perigosamente.

Através de Gerenciadores de Pacote​

A comunidade do Helm disponibiliza a instalação através de diversos gerenciadores de pacotes para diferentes sistemas operacionais. Eles não são mantidos pelo projeto Helm e não são considerados provedores terceiros acreditados.

Homebrew (macOS)​

Membros da comunidade Helm adicionaram uma formula do Helm ao Homebrew. A fórmula geralmente está atualizada.

brew install helm

(Nota: Atenção, existe uma fórmula do emacs-helm, que é um projeto distinto!)

Chocolatey (Windows)​

Membros da comunidade Helm contribuíram com um build do pacote Helm para o Chocolatey. Esse pacote geralmente está atualizado.

choco install kubernetes-helm

Scoop (Windows)​

Membros da comunidade Helm contribuíram com um build do pacote Helm para o Scoop. Esse pacote geralmente está atualizado.

scoop install helm

Winget (Windows)​

Membros da comunidade Helm contribuíram com um build do pacote Helm para o Winget. Esse pacote geralmente está atualizado.

winget install Helm.Helm

Apt (Debian/Ubuntu)​

Membros da comunidade Helm contribuíram com um pacote Apt para Debian/Ubuntu. Esse pacote geralmente está atualizado. Agradecimentos ao Buildkite por hospedar o repositório.

sudo apt-get install curl gpg apt-transport-https --yes
curl -fsSL https://packages.buildkite.com/helm-linux/helm-debian/gpgkey | gpg --dearmor | sudo tee /usr/share/keyrings/helm.gpg > /dev/null
echo "deb [signed-by=/usr/share/keyrings/helm.gpg] https://packages.buildkite.com/helm-linux/helm-debian/any/ any main" | sudo tee /etc/apt/sources.list.d/helm-stable-debian.list
sudo apt-get update
sudo apt-get install helm

dnf/yum (fedora)​

A partir do Fedora 35, o Helm está disponível no repositório oficial. Você pode instalar o Helm executando:

sudo dnf install helm

Snap​

A comunidade dos Snapcrafters mantém a versão do pacote Helm para o Snap:

sudo snap install helm --classic

pkg (FreeBSD)​

Membros da comunidade do FreeBSD contribuíram com um pacote Helm buildado para o FreeBSD Ports Collection. Esse pacote geralmente está atualizado.

pkg install helm

Builds de Desenvolvimento​

Além das releases estáveis, é possível baixar e instalar versões de desenvolvimento do Helm.

Canary Builds​

Builds "Canary" são versões do Helm construídas a partir das últimas atualizações da branch main. Eles não são releases oficiais e podem não ser estáveis! Contudo, oferecem a oportunidade de testar as funcionalidades mais recentes do Helm.

Os binários Canary do Helm são armazenados em get.helm.sh. Estes são alguns links de builds comuns:

A partir do Código-Fonte (Linux, macOS)​

Buildar o Helm a partir do código-fonte é mais trabalhoso, mas é a melhor forma de testar as últimas versões (pré-release) do Helm.

Você deve ter um ambiente de execução Go instalado em seu host.

$ git clone https://github.com/helm/helm.git
$ cd helm
$ make

Se necessário, essa abordagem irá baixar as dependências, armazená-las em cache e validará a configuração. Irá compilar o helm e o mover para bin/helm também.

Conclusão​

Na maioria dos casos, a instalação é simples como baixar um binário pré-buildado do helm. Este documento cobre casos de pessoas que querem executar cargas de trabalho mais sofisticadas com o Helm.

Uma vez instalado com sucesso o cliente Helm, você pode seguir com o uso do Helm para o gerenciamento de charts e adicionar um repositório estável.