K3s

Ce fichier définit l’identité, la version et les métadonnées du chart utilisées par Helm.

Il sert de « définition de paquet » pour le chart Helm, de manière similaire à package.json (npm) ou Chart.lock (dépendances Helm).

Rôle : Chart.yaml indique à Helm ce qu’est ce chart, quelle est sa version, quelle application il déploie, et fournit des métadonnées consultables pour les référentiels de charts.

Helm utilise ce fichier pour suivre les versions des charts, gérer les dépendances et afficher des informations lorsque les utilisateurs recherchent ou installent des charts.

Dans un déploiement K3s (Kubernetes léger), le values.yaml fichier sert de fichier de configuration central pour les charts Helm. Il définit les paramètres et réglages par défaut qui personnalisent la manière dont une application ou un service est déployé dans le cluster - comme le nombre de réplicas, les versions des images, les limites de ressources, les types de services, les règles d’ingress, les variables d’environnement et les configurations de stockage persistant.

Lorsque vous exécutez helm install ou helm upgrade, Helm fusionne les valeurs de ce fichier avec les modèles du chart pour générer les manifestes Kubernetes finaux. Vous pouvez remplacer des valeurs spécifiques au moment du déploiement en utilisant --set des options ou en fournissant un fichier de valeurs personnalisé avec -f, ce qui en fait un mécanisme flexible pour gérer des configurations spécifiques à un environnement (par ex. développement vs production) sans modifier les modèles du chart sous-jacent.

Fichiers de documentation :

README.md - La documentation principale, fournissant un aperçu du projet, des instructions de démarrage rapide, les prérequis et des informations générales d’utilisation pour l’atelier de déploiement K3s.

DEPLOYMENT.md - Guide de déploiement détaillé couvrant le flux complet de déploiement K3s, y compris les prérequis, les instructions étape par étape et les procédures de vérification après déploiement.

K3s-INSTALLATION.md - Instructions de configuration et d’installation de K3s couvrant la préparation du système, l’installation de K3s, la configuration réseau et la mise en place de la classe de stockage requise avant de déployer Pentaho.

Orchestration et déploiement :

deploy.sh - Script de déploiement automatisé qui orchestre le flux complet de déploiement K3s, y compris la création du namespace, la génération des secrets, l’application des manifests et les vérifications de disponibilité des services.

destroy.sh - Script de nettoyage qui supprime en toute sécurité toutes les ressources K3s, y compris les déploiements, services, persistent volume claims et namespaces, utile pour les scénarios de redéploiement ou de démontage.

Makefile - Contient des cibles de commandes pratiques pour les opérations K3s courantes comme le déploiement, la suppression, la vérification de l’état et l’affichage des journaux. Les utilisateurs peuvent exécuter make help pour voir toutes les commandes disponibles.

La docker-build/ le répertoire contient tous les composants nécessaires pour construire l’image conteneur du Pentaho Server qui sera déployée sur K3s :

Fichiers de documentation :

README.md - Documentation complète du build couvrant le processus de construction de l’image Docker, l’architecture de build multi-étapes, les options de configuration, le dépannage et les bonnes pratiques pour construire des images Pentaho Server pour un déploiement K3s.

QUICK-START.md - Guide de démarrage rapide fournissant des instructions étape par étape pour les utilisateurs qui souhaitent construire et tester rapidement l’image Pentaho sans lire la documentation complète. Inclut les commandes de build courantes et les flux de travail typiques.

ENV-CONFIGURATION.md - Guide de référence complet pour le .env.example fichier, détaillant toutes les variables d’environnement disponibles, leurs rôles, leurs valeurs par défaut et la manière dont elles influencent le processus de build Docker et l’image résultante.

Fichiers de build et de configuration :

build.sh - Script d’encapsulation de build automatisé qui valide les prérequis, vérifie les fichiers requis (ZIP Pentaho dans stagedArtifacts/) docker build, affiche les informations de l’image après la compilation et peut éventuellement la pousser vers un registre avec l’ -p drapeau.

.env.example - Fichier modèle de configuration contenant toutes les variables d’environnement disponibles pour le processus de build Docker. Les utilisateurs doivent le copier vers .env et personnaliser les valeurs selon leurs besoins de déploiement spécifiques, y compris la version Pentaho, les tags d’image et les options de build.

Dockerfile - Définition de build multi-étapes utilisant debian:trixie-slim comme image de base avec OpenJDK 21 JRE. Crée des images optimisées en séparant l’environnement de build de l’environnement d’exécution, réduisant la taille finale de l’image tout en conservant tous les composants Pentaho nécessaires. L’approche multi-étapes minimise les vulnérabilités de sécurité et améliore l’efficacité du build.

test-compose.yml - Environnement local de test Docker Compose qui vous permet de tester l’image Docker construite localement avant de la déployer sur K3s. C’est utile pour valider les changements de configuration, tester des plugins personnalisés ou déboguer des problèmes de démarrage sans la surcharge d’un déploiement K3s complet.

Scripts de démarrage du conteneur :

entrypoint/ - Répertoire contenant les scripts d’initialisation et de démarrage du conteneur :

Superpositions de configuration :

softwareOverride/ - Répertoire de superpositions de configuration intégré dans l’image Docker pendant le processus de build. Les fichiers sont organisés dans des répertoires numérotés et traités par ordre alphabétique pour garantir une séquence d’application correcte :

Artifacts de staging :

stagedArtifacts/ - Répertoire de staging où les utilisateurs placent le package d’installation du Pentaho Server (pentaho-server-ee-11.0.0.0-237.zip) avant de construire l’image Docker. Contient un README.md avec des instructions sur l’endroit où obtenir le package Pentaho et comment le placer correctement en staging.

La db_init_postgres/ le répertoire contient les scripts d’initialisation PostgreSQL qui créent toutes les bases de données de référentiel Pentaho requises. Ces scripts sont montés dans le conteneur PostgreSQL et s’exécutent automatiquement lors du premier démarrage :

1_create_jcr_postgresql.sql - Crée le Référentiel de contenu Jackrabbit (JCR) base de données. Le JCR stocke tout le contenu Pentaho, y compris les rapports, tableaux de bord, sources de données, schémas d’analyse, transformations, jobs et fichiers utilisateur. Il s’agit du principal système de gestion de contenu du référentiel Pentaho.

2_create_quartz_postgresql.sql - Configure le Ordonnanceur Quartz base de données. Quartz gère tous les jobs planifiés, les déclencheurs et les calendriers dans Pentaho Server, y compris les planifications de génération de rapports, les exécutions de jobs ETL et d’autres processus automatisés. Contient des tables critiques comme QRTZ6_JOB_DETAILS, QRTZ6_TRIGGERS, et l’historique d’exécution.

3_create_repository_postgresql.sql - Crée le Référentiel Hibernate base de données. Celle-ci stocke les données d’authentification des utilisateurs, les informations d’autorisation, les rôles, les permissions et d’autres informations liées à la sécurité gérées par le sous-système de sécurité de Pentaho.

4_pentaho_logging_postgresql.sql - Établit le pentaho_dilogs schéma de la base de données Hibernate pour l’audit et la journalisation Data Integration (DI). Capture des informations détaillées sur l’exécution ETL, notamment les journaux de jobs, les journaux de transformations, les métriques de performance des étapes et les enregistrements d’erreurs. Essentiel pour déboguer les flux de travail d’intégration de données et surveiller l’état des pipelines.

5_pentaho_mart_postgresql.sql - Crée le pentaho_operations_mart schéma dans la base de données Hibernate. Ce data mart dimensionnel stocke des analyses opérationnelles sur l’utilisation de Pentaho Server, y compris des tables de dimensions (DIM_DATE, DIM_TIME, DIM_EXECUTOR) et des tables de faits (FACT_EXECUTION, FACT_STEP_EXECUTION) pour analyser l’utilisation de la plateforme, les tendances de performance et les schémas d’activité des utilisateurs.

La manifests/ le répertoire contient toutes les définitions de ressources Kubernetes organisées par domaine fonctionnel. Ces fichiers YAML définissent l’état déclaratif de votre déploiement K3s :

namespace.yaml - Crée le pentaho namespace dédié pour isoler toutes les ressources liées à Pentaho des autres charges de travail K3s, offrant une séparation logique et une organisation des ressources.

configmaps/ - Ressources ConfigMap pour les données de configuration non sensibles :

pentaho/ - Ressources Kubernetes du Pentaho Server :

postgres/ - Ressources Kubernetes de la base de données PostgreSQL :

secrets/ - Stockage d’identifiants sensibles :

storage/ - Définitions de stockage persistant :

ingress/ - Configuration d’accès externe :

La scripts/ le répertoire contient des utilitaires d’exploitation et de maintenance pour gérer le déploiement Pentaho sur K3s :

Gestion de base de données :

backup-postgres.sh - Utilitaire automatisé de sauvegarde PostgreSQL qui crée des dumps compressés de toutes les bases de données Pentaho (jackrabbit, quartz, hibernate) à l’aide de kubectl exec pour exécuter pg_dump dans le pod PostgreSQL. Les sauvegardes sont horodatées et compressées avec gzip pour un stockage efficace.

restore-postgres.sh - Utilitaire de restauration de base de données pour récupérer les bases de données Pentaho à partir de fichiers de sauvegarde. Utile pour la reprise après sinistre, le clonage d’environnement ou la migration de données entre clusters K3s. Gère la décompression et la restauration via kubectl exec et psql.

Surveillance et validation :

health-check.sh - Script de vérification de santé qui confirme que PostgreSQL et Pentaho Server s’exécutent et répondent correctement. Vérifie l’état des pods, les probes de readiness et effectue des tests de connectivité de base.

monitor-resources.sh - Utilitaire de surveillance des ressources qui suit l’utilisation du CPU, de la mémoire et du stockage sur tous les pods Pentaho à l’aide de kubectl top et des métriques de ressources, aidant à identifier les contraintes de ressources ou les possibilités d’optimisation.

monitor-postgres.sh - Script de surveillance spécifique à PostgreSQL qui vérifie le nombre de connexions à la base de données, les requêtes actives, la taille des tables et les métriques de santé de la base de données via des requêtes SQL exécutées dans le pod PostgreSQL.

validate-deployment.sh - Script complet de validation du déploiement qui confirme que toutes les ressources K3s sont correctement créées, que les pods s’exécutent, que les services sont accessibles, que les volumes persistants sont liés et que l’ensemble du déploiement fonctionne.

verify-k3s.sh - Script de vérification de l’infrastructure K3s qui vérifie l’installation de K3s, l’état des nœuds, les classes de stockage, le contrôleur d’ingress Traefik et les composants principaux de K3s avant de tenter un déploiement Pentaho.