ClickHouse
GitGuardian utilise ClickHouse, une base de données open source orientée colonnes, pour alimenter les fonctionnalités nécessitant une analyse rapide sur de grands volumes de données (par exemple, les analyses d'occurrences de secrets machine et endpoint). PostgreSQL reste le datastore principal pour le reste de l'application ; ClickHouse n'est impliqué 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 tout déploiement Self-Hosted. Consultez l'avis client pour connaître les changements et savoir 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 repose sur un stockage objet externe (compatible S3, Azure Blob Storage ou Google Cloud Storage) pour un stockage durable des données. Il ne s'agit pas d'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. Il s'agit de l'option la plus simple et la plus légère, suffisante pour la grande majorité des déploiements, bien qu'elle ne soit pas hautement disponible : il n'existe aucune autre réplique vers laquelle basculer.
Version prise en charge
GitGuardian fige la version de ClickHouse livrée avec chaque version sur la même version que celle exécutée par notre offre SaaS, et la valide avec notre suite de tests avant publication. N'essayez pas d'exécuter une version de ClickHouse différente de celle livrée avec votre version.
Stockage
ClickHouse répartit son stockage en trois parties : les volumes locaux de métadonnées et de cache du système de fichiers, et le stockage objet contenant 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 au fournisseur, Dimensionnement et durcissement pour le dimensionnement matériel, Sauvegarde et restauration pour la procédure de sauvegarde, et Supervision et alertes pour détecter une sauvegarde défaillante que l'état 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 :
| Ce qu'il faut configurer | Détails | Où |
|---|---|---|
| Dimensionnement et durcissement du calcul | Ressources des nœuds et instances, planification, stabilité des nœuds | 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 dans le cluster | Volumes de métadonnées et de cache, classe de stockage | 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.