K3s

Este archivo define la identidad, versión y metadatos del chart utilizados por Helm.

Sirve como la "definición del paquete" del chart de Helm, similar a package.json (npm) o Chart.lock (dependencias de Helm).

Función: Chart.yaml le dice a Helm qué es este chart, qué versión tiene, qué aplicación despliega y proporciona metadatos buscables para los repositorios de charts.

Helm utiliza este archivo para seguir las versiones del chart, gestionar dependencias y mostrar información cuando los usuarios buscan o instalan charts.

En un despliegue de K3s (Kubernetes ligero), el values.yaml archivo sirve como archivo central de configuración para charts de Helm. Define parámetros y ajustes predeterminados que personalizan cómo se despliega una aplicación o servicio en el clúster: cosas como recuentos de réplicas, versiones de imagen, límites de recursos, tipos de servicio, reglas de ingreso, variables de entorno y configuraciones de almacenamiento persistente.

Cuando ejecuta helm install o helm upgrade, Helm combina los valores de este archivo con las plantillas del chart para generar los manifiestos finales de Kubernetes. Puede sobrescribir valores específicos en el momento del despliegue usando --set banderas o proporcionando un archivo de valores personalizado con -f, lo que lo convierte en un mecanismo flexible para gestionar configuraciones específicas del entorno (por ejemplo, desarrollo frente a producción) sin modificar las plantillas subyacentes del chart.

Archivos de documentación:

README.md - La documentación principal de entrada que proporciona una visión general del proyecto, instrucciones de inicio rápido, requisitos previos e información general de uso para el taller de despliegue de K3s.

DEPLOYMENT.md - Guía detallada de despliegue que cubre el flujo de trabajo completo de despliegue en K3s, incluidos los requisitos previos, instrucciones paso a paso y procedimientos de verificación posteriores al despliegue.

K3s-INSTALLATION.md - Instrucciones de configuración e instalación de K3s que cubren la preparación del sistema, la instalación de K3s, la configuración de red y la configuración de la clase de almacenamiento necesaria antes de desplegar Pentaho.

Orquestación y despliegue:

deploy.sh - Script de despliegue automatizado que orquesta el flujo de trabajo completo de despliegue en K3s, incluida la creación del namespace, la generación de secretos, la aplicación de manifiestos y las comprobaciones de disponibilidad del servicio.

destroy.sh - Script de limpieza que elimina de forma segura todos los recursos de K3s, incluidos despliegues, servicios, persistent volume claims y namespaces, útil para escenarios de redepliegue o desmantelamiento.

Makefile - Contiene objetivos de comandos de conveniencia para operaciones comunes de K3s como desplegar, destruir, comprobar el estado y ver logs. Los usuarios pueden ejecutar make help para ver todos los comandos disponibles.

La docker-build/ directorio contiene todos los componentes necesarios para construir la imagen del contenedor Pentaho Server que se desplegará en K3s:

Archivos de documentación:

README.md - Documentación completa de construcción que cubre el proceso de construcción de imágenes Docker, la arquitectura de construcción multietapa, las opciones de configuración, la resolución de problemas y las mejores prácticas para construir imágenes de Pentaho Server para despliegue en K3s.

QUICK-START.md - Guía rápida de construcción que proporciona instrucciones paso a paso para los usuarios que quieren construir y probar rápidamente la imagen de Pentaho sin leer la documentación completa. Incluye comandos de construcción comunes y flujos de trabajo típicos.

ENV-CONFIGURATION.md - Guía de referencia de configuración completa para el .env.example archivo, que detalla todas las variables de entorno disponibles, sus propósitos, valores predeterminados y cómo afectan al proceso de construcción de Docker y a la imagen resultante.

Archivos de construcción y configuración:

build.sh - Script envoltorio de construcción automatizada que valida los requisitos previos, verifica los archivos necesarios (ZIP de Pentaho en stagedArtifacts/), detecta complementos automáticamente (PAZ, PIR, PDD), confirma la construcción con el usuario, ejecuta docker build, muestra la información de la imagen después de la construcción y opcionalmente la envía a un registro con la bandera -p .

.env.example - Archivo plantilla de configuración que contiene todas las variables de entorno disponibles para el proceso de construcción de Docker. Los usuarios lo copian a .env y personalizan los valores según sus necesidades específicas de despliegue, incluidas la versión de Pentaho, las etiquetas de imagen y las opciones de construcción.

Dockerfile - Definición de construcción multietapa que usa debian:trixie-slim como imagen base con OpenJDK 21 JRE. Crea imágenes optimizadas separando el entorno de construcción del entorno de ejecución, reduciendo el tamaño final de la imagen mientras mantiene todos los componentes necesarios de Pentaho. El enfoque multietapa minimiza las vulnerabilidades de seguridad y mejora la eficiencia de la construcción.

test-compose.yml - Entorno local de pruebas con Docker Compose que te permite probar localmente la imagen Docker construida antes de desplegarla en K3s. Esto es útil para validar cambios de configuración, probar complementos personalizados o depurar problemas de inicio sin la sobrecarga de un despliegue completo de K3s.

Scripts de inicio del contenedor:

entrypoint/ - Directorio que contiene scripts de inicialización e inicio del contenedor:

Superposiciones de configuración:

softwareOverride/ - Directorio de superposiciones de configuración que se incorpora en la imagen Docker durante el proceso de construcción. Los archivos se organizan en directorios numerados y se procesan en orden alfabético para garantizar una secuencia de aplicación adecuada:

Artefactos preparados:

stagedArtifacts/ - Directorio de preparación donde los usuarios colocan el paquete de instalación de Pentaho Server (pentaho-server-ee-11.0.0.0-237.zip) antes de construir la imagen Docker. Contiene un README.md con instrucciones sobre dónde obtener el paquete de Pentaho y cómo prepararlo correctamente.

La db_init_postgres/ directorio contiene scripts de inicialización de PostgreSQL que crean todas las bases de datos de repositorio de Pentaho necesarias. Estos scripts se montan en el contenedor de PostgreSQL y se ejecutan automáticamente en el primer inicio:

1_create_jcr_postgresql.sql - Crea el Repositorio de contenido Jackrabbit (JCR) base de datos. El JCR almacena todo el contenido de Pentaho, incluidos informes, paneles, fuentes de datos, esquemas de análisis, transformaciones, trabajos y archivos de usuario. Este es el sistema principal de gestión de contenido para el repositorio de Pentaho.

2_create_quartz_postgresql.sql - Configura el Programador Quartz base de datos. Quartz gestiona todos los trabajos programados, desencadenadores y calendarios dentro de Pentaho Server, incluidas las programaciones de generación de informes, las ejecuciones de trabajos ETL y otros procesos automatizados. Contiene tablas críticas como QRTZ6_JOB_DETAILS, QRTZ6_TRIGGERSy el historial de ejecución.

3_create_repository_postgresql.sql - Crea el Repositorio Hibernate base de datos. Esto almacena los datos de autenticación de usuarios, la información de autorización, los roles, los permisos y otra información relacionada con la seguridad gestionada por el subsistema de seguridad de Pentaho.

4_pentaho_logging_postgresql.sql - Establece el pentaho_dilogs esquema dentro de la base de datos Hibernate para auditoría y registro de Data Integration (DI). Captura información detallada de ejecución ETL, incluidos registros de trabajos, registros de transformaciones, métricas de rendimiento de pasos y registros de errores. Es esencial para depurar flujos de trabajo de integración de datos y supervisar el estado de los pipelines.

5_pentaho_mart_postgresql.sql - Crea el pentaho_operations_mart esquema dentro de la base de datos Hibernate. Este data mart dimensional almacena análisis operativos sobre el uso de Pentaho Server, incluidas tablas de dimensiones (DIM_DATE, DIM_TIME, DIM_EXECUTOR) y tablas de hechos (FACT_EXECUTION, FACT_STEP_EXECUTION) para analizar la utilización de la plataforma, las tendencias de rendimiento y los patrones de actividad de los usuarios.

La manifiestos/ directorio contiene todas las definiciones de recursos de Kubernetes organizadas por área funcional. Estos archivos YAML definen el estado declarativo de tu despliegue en K3s:

namespace.yaml - Crea el pentaho namespace dedicado para aislar todos los recursos relacionados con Pentaho de otras cargas de trabajo de K3s, proporcionando separación lógica y organización de recursos.

configmaps/ - Recursos ConfigMap para datos de configuración no sensibles:

pentaho/ - Recursos de Kubernetes del Pentaho Server:

postgres/ - Recursos de Kubernetes de la base de datos PostgreSQL:

secrets/ - Almacenamiento de credenciales sensibles:

storage/ - Definiciones de almacenamiento persistente:

ingress/ - Configuración de acceso externo:

La scripts/ directorio contiene utilidades operativas y de mantenimiento para gestionar el despliegue de Pentaho en K3s:

Gestión de bases de datos:

backup-postgres.sh - Utilidad automatizada de copia de seguridad de PostgreSQL que crea volcados comprimidos de todas las bases de datos de Pentaho (jackrabbit, quartz, hibernate) usando kubectl exec para ejecutar pg_dump dentro del pod de PostgreSQL. Las copias de seguridad se sellan con marca de tiempo y se comprimen con gzip para un almacenamiento eficiente.

restore-postgres.sh - Utilidad de restauración de base de datos para recuperar las bases de datos de Pentaho desde archivos de copia de seguridad. Útil para recuperación ante desastres, clonación de entornos o migración de datos entre clústeres de K3s. Gestiona la descompresión y la restauración mediante kubectl exec y psql.

Supervisión y validación:

health-check.sh - Script de comprobación de estado que verifica que tanto PostgreSQL como Pentaho Server se estén ejecutando y respondiendo correctamente. Comprueba el estado de los pods, las sondas de readiness y realiza pruebas básicas de conectividad.

monitor-resources.sh - Utilidad de supervisión de recursos que realiza un seguimiento del uso de CPU, memoria y almacenamiento en todos los pods de Pentaho usando kubectl top y métricas de recursos, ayudando a identificar restricciones de recursos u oportunidades de optimización.

monitor-postgres.sh - Script de supervisión específico de PostgreSQL que comprueba los recuentos de conexiones a la base de datos, las consultas activas, los tamaños de las tablas y las métricas de salud de la base de datos mediante consultas SQL ejecutadas en el pod de PostgreSQL.

validate-deployment.sh - Script integral de validación del despliegue que confirma que todos los recursos de K3s se han creado correctamente, que los pods se están ejecutando, que los servicios son accesibles, que los volúmenes persistentes están vinculados y que todo el despliegue está operativo.

verify-k3s.sh - Script de verificación de la infraestructura de K3s que comprueba la instalación de K3s, el estado de los nodos, las clases de almacenamiento, el controlador Traefik ingress y los componentes principales de K3s antes de intentar el despliegue de Pentaho.