chart-releaser-action
GitHub Action para convertir un proyecto en repositorio auto-alojado de Helm charts, utilizando la CLI helm/chart-releaser. Automatiza el empaquetado, publicación y creación de index.yaml en una rama gh-pages o OCI registry.
Ficha actualizada 28 sept 2026, 13:16 · upstream 28 sept 2026, 12:46 · release v1.7.0
Qué es chart-releaser-action
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Esta acción permite transformar cualquier repositorio de GitHub que contenga directorios con Helm charts en un repositorio auto-alojado. Durante cada push a la rama principal, verifica las versiones de los charts disponibles. Si detecta cambios o nuevas versiones, crea una release correspondiente en GitHub y adjunta los archivos del chart como artefactos. Simultáneamente, genera o actualiza el archivo index.yaml con metadatos necesarios para que clientes Helm consulten el repositorio correctamente.
El proceso se ejecuta típicamente en la rama gh-pages, configurada como fuente de despliegue en GitHub Pages. Esto permite mantener el código fuente y los artefactos de las versiones publicadas separados. Además, soporta la publicación directa a registros OCI (Open Container Initiative) mediante el comando cr push, facilitando la integración con ecosistemas modernos de contenedores sin depender exclusivamente del hosting de archivos estáticos de GitHub.
Los inputs permiten personalizar el comportamiento, como saltar el paso de empaquetado para usar herramientas externas o autenticación explícita en registros OCI. Requiere un token de acceso al repositorio (CR_TOKEN) y permisos adecuados en la organización para escribir contenidos. Es ideal para equipos que buscan evitar dependencias de proveedores externos como Artifact Hub o ChartMuseum, manteniendo el control total sobre su inventario de aplicaciones.
- Publicación automática de Helm charts tras cada commit a main
- Gestión de repositorios privados sin depender de servicios externos
- Distribución de artefactos en registros OCI (ghcr.io, Docker Hub)
- Mantenimiento de index.yaml actualizado para clientes Helm
- Automatización de releases de GitHub vinculadas a versiones de charts
- Soporte nativo para publicación en registros OCI además de GitHub Pages
- Generación automática del archivo index.yaml con metadatos válidos
- Integración directa con el flujo de trabajo de releases de GitHub
- Configuración flexible mediante archivos YAML o variables de entorno
- Autenticación simplificada mediante credenciales almacenadas localmente o explícitas
- Requiere configuración manual de la rama gh-pages en Settings/Pages
- Necesita permisos de escritura (contents: write) en el token GitHub
- No incluye contenedores Docker ni orquestación nativa dentro del action
- Dependencia de la CLI helm/chart-releaser instalada por defecto en runners
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Configurar la rama gh-pages como fuente de despliegue en Settings/Pages. Asegurar que el token CR_TOKEN tenga permisos de escritura. Si se usa OCI, ejecutar docker/login-action antes para autenticación o pasar credenciales explícitas. Verificar permisos de organización si son read-only.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.