Implementar recursos y paquetes de Kubernetes con Amazon EKS y un repositorio de gráficos de Helm en Amazon S3

Instalar el cliente Helm.

Para descargar e instalar el cliente Helm en su sistema local, utilice el siguiente comando. 

sudo curl https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3 | bash

Validar la instalación de Helm.

Para validar que Helm puede comunicarse con el servidor API de Kubernetes del clúster de Amazon EKS, ejecute helm version.

Crear un gráfico de Helm para NGINX.

Para crear un gráfico de Helm llamado my-nginx en la máquina cliente, ejecute helm create my-nginx.

Revisar la estructura del gráfico.

Para revisar la estructura del gráfico, ejecute el comando tree tree my-nginx/.

Desactive la creación de cuentas de servicio en el gráfico.

En values.yaml, en la sección serviceAccount, establezca la clave create en false. Esta opción está desactivada porque no es necesario crear una cuenta de servicio para este patrón.

Validar (lint) el gráfico modificado para detectar errores sintácticos.

Para validar el gráfico para detectar cualquier error sintáctico antes de instalarlo en el clúster de destino, ejecute helm lint my-nginx/.

Instale el gráfico para implementar los recursos de Kubernetes.

Para ejecutar la instalación del gráfico de Helm, utilice el siguiente comando. 

helm install --name my-nginx-release --debug my-nginx/ --namespace helm-space 

La marca opcional debug muestra todos los mensajes de depuración durante la instalación. La marca namespace especifica el espacio de nombres en el que se creará la parte de recursos de este gráfico.

Revisar los recursos del clúster de Amazon EKS.

Para revisar los recursos que se crearon como parte del gráfico de Helm en el espacio de nombres helm-space, utilice el siguiente comando. 

kubectl get all -n helm-space

Modifique y actualice la versión.

Para modificar el gráfico, en values.yaml, cambie el valor replicaCount a 2. A continuación, ejecute el siguiente comando para actualizar la versión ya instalada.

helm upgrade my-nginx-release my-nginx/ --namespace helm-space

Revisar el historial de la versión de Helm.

Para ver todas las revisiones de una versión específica instalada con Helm, ejecute el siguiente comando. 

helm history my-nginx-release

Comprobar los detalles de una revisión específica.

Antes de cambiar a o restaurar una versión operativa, y para obtener una capa 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 --revision=2 my-nginx-release

Restaurar una versión anterior.

Para restaurar una revisión anterior, utilice el siguiente comando. 

helm rollback my-nginx-release 1 

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

Cree un bucket de S3 para gráficos de Helm.

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

Instalar el complemento de Helm para Amazon S3.

Para instalar el complemento helm-s3 en su máquina cliente, utilice el siguiente comando. 

helm plugin install https://github.com/hypnoglow/helm-s3.git --version 0.10.0

Nota: El soporte de Helm V3 está disponible con la versión 0.9.0 y superior del complemento.

Inicializar el repositorio de Helm de Amazon S3.

Para inicializar la carpeta de destino como repositorio de Helm, utilice el siguiente comando. 

helm S3 init s3://my-helm-charts/charts 

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

Añada el repositorio de Amazon S3 a Helm.

Para añadir el repositorio a la máquina cliente, utilice el siguiente comando.

helm repo add my-helm-charts s3://my-helm-charts/charts 

Este comando añade un alias al repositorio de destino de la máquina cliente de Helm.

Revisar la lista de repositorios.

Para ver la lista de repositorios de la máquina cliente de Helm, ejecute helm repo list.

Empaquetar el gráfico.

Para empaquetar el gráfico my-nginx que creó, ejecute helm package ./my-nginx/. El comando empaqueta todo el contenido de la carpeta de gráficos my-nginx en un archivo de almacenamiento que se nombra según el número de versión mencionado en el archivo Chart.yaml.

Almacenar el paquete en el repositorio de Helm de Amazon S3.

Para cargar el paquete en el repositorio de Helm de Amazon S3, ejecute el siguiente comando usando el nombre correcto del archivo .tgz.

helm s3 push ./my-nginx-0.1.0.tgz my-helm-charts

Buscar el gráfico de Helm.

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 my-nginx

Modifique y empaquete el gráfico.

En values.yaml, defina el valor de replicaCount en 1. A continuación, ejecute helm package ./my-nginx/ para empaquetar el gráfico, esta vez cambiando la versión en Chart.yaml a 0.1.1. 

Es preferible automatizar la actualización del control de versiones mediante herramientas como números de compilación de GitVersion o 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.

Enviar la nueva versión al repositorio de Helm de Amazon S3.

Para enviar el nuevo paquete, versión 0.1.1, al repositorio de Helm my-helm-charts de Amazon S3, ejecute el siguiente comando.

helm s3 push ./my-nginx-0.1.1.tgz my-helm-charts

Buscar todas las versiones del gráfico my-nginx.

Para ver todas las versiones disponibles de un gráfico, ejecute el siguiente comando con la marca --versions.

helm search repo my-nginx --versions

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

Instalar un gráfico desde el repositorio de Helm de Amazon S3.

Los resultados de búsqueda de la tarea anterior mostrarán las múltiples versiones del gráfico my-nginx. Para instalar la nueva versión (0.1.1) desde el repositorio de Helm de Amazon S3, utilice el siguiente comando.

helm upgrade my-nginx-release my-helm-charts/my-nginx --version 0.1.1 --namespace helm-space