Configure un repositorio de gráficos de Helm v3 en Amazon S3

Para descargar e instalar el cliente de Helm en su sistema local, ejecute el siguiente comando: sudo curl https://raw.githubusercontent.com/helm/helm/main/scripts/get-helm-3 | bash

Para validar el cliente de Helm, ejecute el siguiente comando: helm version --short

Cree un bucket de S3 único. En el bucket, cree una carpeta llamada stable/myapp. El ejemplo de este patrón usa s3://my-helm-charts/stable/myapp como repositorio de gráficos de destino.

Para instalar el plugin helm-s3 en su máquina cliente, ejecute el siguiente comando: helm plugin install https://github.com/hypnoglow/helm-s3.git

Para inicializar la carpeta de destino como repositorio de Helm, ejecute el siguiente comando: helm s3 init s3://my-helm-charts/stable/myapp 

El comando crea un archivo index.yaml en el destino para rastrear toda la información del gráfico almacenada en esa ubicación.

Para comprobar que se ha creado el archivo index.yaml, ejecute el siguiente comando: aws s3 ls s3://my-helm-charts/stable/myapp/

Para añadir el alias del repositorio de destino a la máquina cliente de Helm, ejecute el siguiente comando: helm repo add stable-myapp s3://my-helm-charts/stable/myapp/

Si no hay gráficos de Helm locales en tu CodeCommit repositorio, clónalos desde tu GitHub repositorio ejecutando el siguiente comando: git clone <url_of_your_helm_source_code>.git

Para empaquetar el gráfico que ha creado o clonado, ejecute el siguiente comando: helm package ./my-app  

Como ejemplo, este patrón usa el gráfico my-app. El comando empaqueta todo el contenido de la carpeta de gráficos my-app en un archivo de almacenamiento. Este archivo toma su nombre del número de versión mencionado en el archivo Chart.yaml.

Para cargar el paquete local en el repositorio de Helm en Amazon S3, ejecute el siguiente comando: helm s3 push ./my-app-0.1.0.tgz stable-myapp

En el comando, my-app es el nombre de la carpeta de gráficos, 0.1.0 es la versión del gráfico mencionada en Chart.yaml y stable-myapp es el alias del repositorio de destino.

Para confirmar que el gráfico aparece tanto localmente como en el repositorio de Helm de Amazon S3, ejecute el siguiente comando: helm search repo stable-myapp

En values.yaml, establezca el valor replicaCount en 1 y, a continuación, empaquete el gráfico, esta vez cambiando la versión de Chart.yaml a 0.1.1. Lo ideal es que el control de versiones se logre mediante la automatización mediante el uso de herramientas como GitVersion los números de compilación de Jenkins en una canalización de CI/CD. La automatización del número de versión está fuera del alcance de este patrón. Para agrupar la tabla, ejecute el siguiente comando: helm package ./my-app/

Para enviar el nuevo paquete, versión 0.1.1, al repositorio Helm my-helm-charts de Amazon S3, ejecute el siguiente comando: helm s3 push ./my-app-0.1.1.tgz stable-myapp

Para confirmar que el gráfico actualizado aparece tanto localmente como en el repositorio Helm de Amazon S3, ejecute los siguientes comandos.

helm repo update

helm search repo stable-myapp

Para ver todas las versiones disponibles de un gráfico, ejecute el siguiente comando con la marca --versions: helm search repo my-app --versions 

Sin la marca, Helm mostrará de forma predeterminada la última versión cargada de un gráfico.

La instalación automatizada está fuera del alcance de este patrón, pero puede realizar una instalación manual. Los resultados de la búsqueda de la tarea anterior mostrarán las múltiples versiones del gráfico my-app. Para instalar la nueva versión (0.1.1) desde el repositorio de Helm de Amazon S3, ejecute el siguiente comando: helm upgrade --install my-app-release stable-myapp/my-app --version 0.1.1 --namespace dev

La reversión automática está fuera del alcance de este patrón, pero puede restaurar manualmente una versión anterior. Antes de cambiar o revertir a una versión funcional, y para obtener un nivel adicional de validación antes de instalar una revisión, compruebe qué valores se han pasado a cada una de las revisiones mediante el siguiente comando: helm get values --revision=2 my-app-release

La reversión automática está fuera del alcance de este patrón. Para restaurar manualmente una revisión anterior, ejecute el siguiente comando: helm rollback my-app-release 1 

Este ejemplo restaura la revisión número 1.