ClickHouse
GitGuardian utilise ClickHouse, une base de données open source orientée colonnes, pour alimenter les fonctionnalités qui nécessitent une analytique rapide sur de gros volumes de données (par exemple, l'analytique des occurrences de secrets pour les machines et les endpoints). PostgreSQL reste le datastore principal pour le reste de l'application ; ClickHouse n'intervient que pour les fonctionnalités spécifiques qui en ont besoin.
À partir de la version 2027.1.0, ClickHouse et son backend de stockage objet deviennent obligatoires pour chaque déploiement Self-Hosted. Consultez la note client pour savoir ce qui change et comment vous préparer.
Modèle de déploiement
ClickHouse s'exécute en tant que composant stateful dédié au sein du cluster, et s'appuie sur un stockage objet externe (compatible S3, Azure Blob Storage ou Google Cloud Storage) pour le stockage durable des données. Ce n'est pas une base de données entièrement gérée en externe comme PostgreSQL ou Redis. Consultez Stockage ClickHouse pour plus de détails.
Topologie par défaut
ClickHouse est déployé en tant que nœud unique. C'est l'option la plus simple et la plus légère, et elle suffit pour la grande majorité des déploiements, même si elle n'est pas hautement disponible : il n'y a pas d'autre réplica vers lequel basculer.
Version prise en charge
GitGuardian épingle la version de ClickHouse livrée avec chaque release à la même version que celle qui fait tourner notre offre SaaS, et la valide avec notre suite de tests avant la release. N'essayez pas d'exécuter une version de ClickHouse différente de celle livrée avec votre release.
Stockage
ClickHouse répartit son stockage en trois parties : les volumes locaux de métadonnées et de cache de système de fichiers, et le stockage objet qui contient les données réelles des tables, où réside l'essentiel de l'empreinte de stockage et où clickhouse-backup écrit lors des sauvegardes.
Consultez Stockage ClickHouse pour les volumes locaux et la configuration du stockage objet spécifique à chaque fournisseur, Dimensionnement et durcissement pour le dimensionnement matériel, Sauvegarde et restauration pour la procédure de sauvegarde, et Surveillance et alerting pour détecter une sauvegarde en échec que la santé du pod ne vous montrera pas.
Configuration requise
Un déploiement ClickHouse prêt pour la production nécessite la configuration de tous les éléments suivants :
| Que configurer | Détails | Où |
|---|---|---|
| Dimensionnement et durcissement du calcul | Ressources du nœud et de l'instance, planification, stabilité du nœud | Dimensionnement et durcissement |
| Identifiants ClickHouse | Mot de passe de l'instance | Prérequis |
| Configuration du stockage objet | Backend S3 / Azure Blob / GCS, authentification du disque | Stockage → Configuration |
| Configuration des volumes au sein du cluster | Volumes de métadonnées et de cache, storage class | Stockage → Volumes locaux |
| Configuration de la sauvegarde | Bucket de destination, secret d'identifiants, planification et rétention | Sauvegarde et restauration |
Pour installer ClickHouse, consultez Installer ClickHouse.
