Gestion de la licence
La gestion de la licence est essentielle pour les installations GitGuardian Self-Hosted, impliquant à la fois l'acquisition initiale de la licence et sa synchronisation continue. Cette page explique comment télécharger et gérer les licences pour les différentes méthodes d'installation (basées sur Helm et sur KOTS), y compris dans les environnements airgap et non-airgap.
Traitez le fichier de licence comme une information sensible ; il contient des identifiants pour accéder au registre et au dépôt d'images de GitGuardian.
Certaines fonctionnalités sont conditionnées par des champs de licence dédiés, désactivés par défaut, comme Public Monitoring pour Self-Hosted (disponible à partir de 2026.7). Pour en activer une, contactez GitGuardian afin de mettre à jour votre licence, puis synchronisez-la en suivant les étapes ci-dessous.
Téléchargement
La méthode pour obtenir votre licence varie selon votre type d'installation :
Installation basée sur Helm
Pour les installations Helm, la licence est incluse dans le chart Helm que vous téléchargez. Vous recevrez les identifiants d'accès au registre de la part de l'équipe GitGuardian à support@gitguardian.com. Ces identifiants comprennent :
- Un nom d'utilisateur (généralement votre adresse e-mail)
- Un mot de passe pour accéder au registre du chart Helm
Vous utiliserez ces identifiants pour vous authentifier auprès du registre avec :
helm registry login registry.replicated.com --username your.name@yourcompany.com
Installation KOTS embedded cluster
Pour les installations KOTS sur un embedded cluster, la licence est incluse directement dans le bundle d'installation. Vous n'avez besoin que de l'identifiant de licence fourni par l'équipe GitGuardian - aucun téléchargement manuel n'est requis.
Installation KOTS existing cluster
Pour les installations KOTS sur un existing cluster, vous devrez télécharger manuellement le fichier de licence. Vous aurez besoin de 2 informations :
- l'URL du portail, qui sera généralement envoyée par e-mail.
- le mot de passe, qui idéalement sera envoyé sur un canal différent (par SMS par exemple).
Une fois connecté au portail, vous pourrez télécharger le fichier de licence :
Synchronisation pour une installation basée sur Helm
Avec Helm, les données de licence sont fournies lors de l'installation ou de la mise à niveau.
Installation airgap
Les équipes GitGuardian vous enverront les informations nécessaires pour téléverser manuellement une nouvelle licence.
Non-Airgap, après 2025.3
GitGuardian synchronisera automatiquement les informations de licence avec votre application. Par conséquent, vous n'avez plus besoin de synchroniser manuellement votre licence après l'installation ou les mises à niveau.
Non-Airgap, avant 2025.3
Si vous avez besoin de synchroniser la licence, vous devrez utiliser la commande helm upgrade et spécifier la même version que celle actuellement installée pour éviter des mises à niveau non souhaitées vers la dernière version.
Pour trouver le nom de la release et la version actuellement installée, utilisez helm ls :
helm ls
NAME UPDATED STATUS CHART APP VERSION
<release-name> 2025-03-20 12:40 deployed gitguardian-2025.3.0 2025.3.0
Ici, la version installée est 2025.3.0. Pour synchroniser manuellement la licence, vous exécuteriez la commande suivante, en utilisant la version installée dans votre environnement :
helm upgrade <release-name> -n <namespace> oci://registry.replicated.com/gitguardian/gitguardian --version 2025.3.0 -f local-values.yaml
Remplacez <release-name> par le nom utilisé lors de l'installation initiale. Si nécessaire, spécifiez le namespace Kubernetes avec -n (le namespace par défaut est utilisé si non spécifié).
Synchronisation pour une installation basée sur KOTS
GitGuardian peut mettre à jour certaines informations de votre licence, comme modifier la date d'expiration, ajuster le nombre de sièges, etc.
Installation airgap
Les équipes GitGuardian vous enverront les informations nécessaires pour téléverser une nouvelle licence dans la console d'administration.
Non-Airgap
À partir de la version 2025.3.0, GitGuardian synchronisera automatiquement les informations de licence avec votre application. Par conséquent, vous n'avez plus besoin de synchroniser manuellement votre licence.
Une fois la licence mise à jour automatiquement (pour les environnements non-airgap), vous devrez toujours déployer manuellement la configuration mise à jour sur votre instance.
