Configurar um repositório de chart do Helm v3 no Amazon S3

Instalar o cliente do Helm v3

Para baixar e instalar o cliente do Helm no sistema local, execute o seguinte comando: sudo curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

Valide a instalação do Helm.

Para validar o cliente do Helm, execute o seguinte comando: helm version --short

Crie um bucket do S3 para charts do Helm.

Crie um bucket exclusivo do S3. No bucket, crie uma pasta denominada stable/myapp. O exemplo desse padrão usa s3://my-helm-charts/stable/myapp como repositório do gráfico de destino.

Instale o plug-in do Helm-s3 para o Amazon S3.

Para instalar o plug-in helm-s3 na máquina cliente, use o comando a seguir: helm plugin install https://github.com/hypnoglow/helm-s3.git

Inicialize o repositório do Helm no Amazon S3.

Para inicializar a pasta de destino como um repositório do Helm, use o comando a seguir: helm s3 init s3://my-helm-charts/stable/myapp 

O comando cria um arquivo index.yaml no destino para rastrear todas as informações do gráfico armazenadas nesse local.

Verifique o repositório Helm recém-criado.

Para verificar se o index.yaml arquivo foi criado, execute o seguinte comando: aws s3 ls s3://my-helm-charts/stable/myapp/

Adicione o repositório Amazon S3 ao Helm na máquina cliente.

Para adicionar o alias do repositório de destino à máquina cliente Helm, use o seguinte comando: helm repo add stable-myapp s3://my-helm-charts/stable/myapp/

Clone seus charts do Helm.

Se nenhum gráfico local do Helm estiver presente em seu CodeCommit repositório, clone-o do seu GitHub repositório executando o seguinte comando: git clone <url_of_your_helm_source_code>.git

Embalar o chart do Helm local.

Para embalar o gráfico que você criou ou clonou, use o seguinte comando: helm package ./my-app  

Como exemplo, esse padrão usa o my-app gráfico. O comando empacota todo o conteúdo da pasta do gráfico my-app em um arquivo, que é nomeado usando o número da versão mencionado no arquivo Chart.yaml.

Armazene o pacote local no repositório do Helm no Amazon S3.

Para fazer o upload do pacote local para o repositório do Helm no Amazon S3, execute o seguinte comando: helm s3 push ./my-app-0.1.0.tgz stable-myapp

No comando, my-app é o nome da pasta do gráfico, 0.1.0 é a versão do gráfico mencionada em Chart.yaml e stable-myapp é o alias do repositório de destino.

Pesquise pelo chart do Helm.

Para confirmar se o gráfico aparece localmente e no repositório Amazon S3 Helm, execute o seguinte comando: helm search repo stable-myapp

Modificar e embalar o gráfico.

Emvalues.yaml, defina o replicaCount valor como e1, em seguida, empacote o gráfico, desta vez alterando a versão Chart.yaml para0.1.1. O controle de versão é obtido idealmente por meio da automação usando ferramentas como os números GitVersion de compilação do Jenkins em um pipeline de CI/CD. A automação do número da versão está fora do escopo desse padrão. Para embalar o gráfico, execute o seguinte comando: helm package ./my-app/

Envie a nova versão para o repositório do Helm no Amazon S3.

Para enviar o novo pacote, versão 0.1.1, para o repositório my-helm-chartsHelm no Amazon S3, execute o seguinte comando: helm s3 push ./my-app-0.1.1.tgz stable-myapp

Verifique o chart do Helm atualizado.

Para confirmar se o gráfico atualizado aparece localmente e no repositório Amazon S3 Helm, execute os seguintes comandos.

helm repo update

helm search repo stable-myapp

Pesquise todas as versões do gráfico my-app.

Para ver todas as versões disponíveis de um gráfico, execute o seguinte comando com o --versions sinalizador: helm search repo my-app --versions 

Sem o sinalizador, o Helm, por padrão, exibe a versão mais recente carregada de um gráfico.

Instale um gráfico do repositório do Helm no Amazon S3.

A instalação automatizada está fora do escopo desse padrão, mas você pode instalar manualmente. Os resultados da pesquisa da tarefa anterior mostram as várias versões do gráfico my-app. Para instalar a nova versão (0.1.1) do repositório do Helm no Amazon S3, use o comando a seguir: helm upgrade --install my-app-release stable-myapp/my-app --version 0.1.1 --namespace dev

Revise os detalhes de uma revisão específica.

A reversão automatizada está fora do escopo desse padrão, mas você pode reverter para uma versão anterior manualmente. Antes de alternar ou reverter para uma versão funcional e para obter uma camada adicional de validação antes de instalar uma revisão, veja quais valores foram passados para cada uma das revisões usando o comando a seguir: helm get values --revision=2 my-app-release

Reverter para uma versão anterior.

A reversão automatizada está fora do escopo desse padrão. Para reverter manualmente para uma revisão anterior, use o seguinte comando: helm rollback my-app-release 1 

Este exemplo está revertendo para a revisão número 1.