Afecta a
Equipos que usan la documentación de despliegue con Helm. Esta actualización aplica al portal de documentación pública. No cambia el comportamiento de la API en tiempo de ejecución, salvo que la documentación de producto enlazada indique lo contrario.
Qué cambió
La documentación de Helm se reestructuró por completo esta semana. Lo que antes eran unas pocas páginas monolíticas ahora es una referencia organizada por producto que cubre instalación, actualización, migración, solución de problemas y configuración de producción.
Estructura nueva: Helm por producto
La sección de Helm se reorganizó bajo la pestaña Plataforma y se agrupó por producto, para que puedas ir directo a la referencia de lo que estás desplegando.
- Resumen de Helm — Centro que enlaza a toda la documentación de Helm específica de cada producto
- Compatibilidad de versiones — Matriz actualizada con la documentación del registro OCI y una aclaración del versionado de los charts
Midaz (16 páginas nuevas)
La documentación de Helm de Midaz pasó de dos páginas grandes a secciones enfocadas y navegables:- Instalación y configuración — Instalación, Referencia de configuración, Dependencias, Ingress, Referencia de componentes
- Actualización — Guía de actualización, Lista de verificación de actualización
- Migración — v3 → v4, v4 → v5, v3 → v5
- Operaciones — Solución de problemas, Rollback y solución de problemas, Observabilidad, Desinstalación
- Producción — Referencia de valores de producción — values.yaml anotado y completo para despliegues de producción
Plugins (7 páginas nuevas)
Cada plugin ahora tiene su propia página de referencia de Helm:Otros productos (4 páginas nuevas)
Nuevo: página de modelos de despliegue
Una página nueva, SaaS y BYOC, explica los dos modelos de despliegue (SaaS totalmente gestionado frente a Bring Your Own Cloud), cuándo usar cada uno, qué significa Helm en el contexto BYOC y enlaces a toda la documentación de Helm específica de cada producto.
Páginas eliminadas
Las siguientes páginas monolíticas se eliminaron y su contenido se redistribuyó en la estructura nueva:helm-overview.mdx(sección antigua de Midaz) — reemplazada por Resumen de Helm de Plataforma y Resumen de Helm de Midazhelm-upgrade-guide.mdx— reemplazada por la Guía de actualización dedicada y las páginas de migraciónupgrading-helm.mdx— contenido fusionado en la guía de actualización y en la lista de verificación
Mejoras de contenido
- Contexto de negocio — Las páginas de Helm ahora incluyen contexto de decisión y el encuadre de “por qué esto importa”, no solo instrucciones de configuración
- Orientación de producción — Referencia nueva de valores de producción con valores de producción anotados y recomendaciones de recursos
- Solución de problemas — Solución de problemas completa y basada en síntomas, que cubre pods, ingress, bases de datos, RabbitMQ y operaciones de Helm
- Rutas de migración — Guías de migración detalladas paso a paso para cada transición de versión admitida (v3→v4, v4→v5, v3→v5) con cambios incompatibles y procedimientos de rollback
- Navegación — Se aplicó formato de oración a todos los encabezados de Helm y se limpiaron los enlaces duplicados de las páginas de despliegue
- Puertos de red — Referencia actualizada de puertos de red predeterminados
Impacto
Esta es una actualización de documentación. Las integraciones existentes no necesitan una migración solo por esta nota de versión.
Qué debes hacer
1
Usa la documentación de Helm organizada por producto cuando planifiques la instalación, la actualización, la migración, la solución de problemas o la configuración de producción.