Helm Helm

Encuentra e instala charts publicados desde Artifact Hub

Busca un chart que otra persona ya escribió, inspecciónalo antes de instalarlo y sobrescribe solo lo que necesites.

8 min Principiante

La mayoría del software de infraestructura que ejecutarías en Kubernetes, stacks de monitorización, ingress controllers, bases de datos, ya tiene un chart publicado. Esta guía cubre cómo encontrar uno, comprobar qué instala realmente antes de comprometerte con él y sobrescribir sus valores predeterminados para tu entorno.

Busca sin añadir primero un repositorio

helm search hub prometheus

helm search hub consulta Artifact Hub, el índice de la CNCF de charts (y otros paquetes cloud-native) de muchos repositorios distintos, sin necesidad de añadir antes ese repositorio localmente. Es la forma más rápida de ver qué hay disponible y quién lo publica. Navegar directamente por artifacthub.io te da el mismo catálogo con una mejor interfaz para comparar opciones, leer el README de un chart y comprobar cuándo se actualizó por última vez. (Esta búsqueda solía pasar por un “Helm Hub” separado; ese servicio se retiró en 2020 y se integró en Artifact Hub, así que helm search hub consulta Artifact Hub desde hace años.)

Añade un repositorio y busca entre los añadidos

Una vez que hayas elegido una fuente, añádela y busca en local:

helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm repo update
helm search repo prometheus-community

helm repo add registra un repositorio de charts por nombre; helm repo update actualiza el índice local de Helm con lo que ofrece cada repositorio añadido. helm search repo (nota: repo, no hub) solo busca en los repositorios que ya has añadido, que es lo que usarás en el día a día una vez que sepas de dónde provienen tus charts. helm repo list muestra todo lo registrado actualmente.

Inspecciona un chart antes de instalarlo

Nunca instales un chart a ciegas, especialmente uno con permisos amplios o que gestione almacenamiento:

helm show chart prometheus-community/prometheus
helm show readme prometheus-community/prometheus
helm show values prometheus-community/prometheus

show chart te da los metadatos (versión, mantenedores, dependencias). show readme son las propias notas de instalación y configuración del publicador, normalmente la forma más rápida de saber qué espera un chart. show values imprime todo su values.yaml predeterminado, que es la verdadera referencia de lo que puedes sobrescribir, más completa que cualquier README.

Instala con tus propias sobrescrituras

helm install monitoring prometheus-community/prometheus \
  -n monitoring --create-namespace \
  --set server.retention=15d \
  --set alertmanager.persistentVolume.size=10Gi

--create-namespace te ahorra un paso aparte de kubectl create namespace. Todo lo de la guía de valores específicos de cada entorno se aplica también aquí: para cualquier cosa más allá de una prueba rápida, escribe tus sobrescrituras en un archivo de valores y pásalo con -f en lugar de acumular flags --set, para que lo que instalaste sea reproducible a partir de un archivo en el control de versiones.

# monitoring-values.yaml
server:
  retention: 15d
alertmanager:
  persistentVolume:
    size: 10Gi
helm upgrade --install monitoring prometheus-community/prometheus \
  -n monitoring --create-namespace -f monitoring-values.yaml

Fija una versión de forma deliberada

Sin --version, helm install usa la última versión de chart disponible, que puede cambiar entre el momento en que escribes un archivo de valores y el momento en que realmente ejecutas el comando:

helm search repo prometheus-community/prometheus --versions
helm install monitoring prometheus-community/prometheus --version 25.8.0 -n monitoring

Fijar una versión es práctica estándar para cualquier cosa más allá de un experimento local, por la misma razón por la que fijarías la etiqueta de una imagen de contenedor en lugar de depender de latest: es la diferencia entre un despliegue que puedes reproducir y uno del que solo puedes esperar que fuera igual al anterior.

Guías populares