Aller au contenu principal

Gestion de la licence

La gestion de la licence est essentielle pour les installations GitGuardian Self-Hosted ; elle couvre à la fois l'acquisition initiale de la licence et la synchronisation continue. Cette page décrit comment télécharger et gérer les licences pour les différentes méthodes d'installation (basées sur Helm et basées sur KOTS), y compris les environnements airgap et non-airgap.

attention

Traitez le fichier de licence comme une information sensible ; il contient les identifiants pour le registre et le dépôt d'images de GitGuardian.

Téléchargement

La méthode pour obtenir votre licence varie selon votre type d'installation :

Installation Helm

Pour les installations Helm, la licence est incluse dans le Helm chart que vous téléchargez. Vous recevrez les identifiants d'accès au registre depuis 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 Helm chart

Vous utiliserez ces identifiants pour vous authentifier auprès du registre via :

helm registry login registry.replicated.com --username your.name@yourcompany.com

Installation KOTS Embedded Cluster

Pour les installations KOTS sur cluster embedded, la licence est incluse directement dans le bundle d'installation. Vous n'avez besoin que de l'ID de licence fourni par l'équipe GitGuardian — aucun téléchargement manuel n'est requis.

Installation KOTS Existing Cluster

Pour les installations KOTS sur clusters existants, vous devrez télécharger manuellement le fichier de licence. Vous aurez besoin de 2 informations :

  • l'URL du portail, généralement envoyée par e-mail.
  • le mot de passe, idéalement envoyé sur un autre canal (par SMS par exemple).

Une fois connecté au portail, vous pourrez télécharger le fichier de licence :

Download portal

Synchronisation pour l'installation Helm

Avec Helm, les données de licence sont fournies pendant l'installation ou la mise à niveau.

Installation Airgap

Les équipes GitGuardian vous enverront les informations pour téléverser une nouvelle licence manuellement.

Non-Airgap, après 2025.3

GitGuardian synchronisera automatiquement les informations de licence avec votre application. Vous n'avez donc plus besoin de synchroniser manuellement votre licence après l'installation ou les mises à niveau.

Non-Airgap, avant 2025.3

Si vous devez synchroniser la licence, vous devrez utiliser la commande helm upgrade et préciser la même version que celle actuellement installée pour éviter une mise à niveau involontaire 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 la licence manuellement, exécutez 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, précisez le namespace Kubernetes avec -n (le namespace par défaut est utilisé sinon).

Synchronisation pour l'installation KOTS

GitGuardian peut mettre à jour certaines informations sur votre licence, telles que la date d'expiration, la modification du nombre de sièges, etc.

Installation Airgap

Les équipes GitGuardian vous enverront les informations pour téléverser une nouvelle licence dans la console d'administration.

Non-Airgap

À partir de la release 2025.3.0, GitGuardian synchronisera automatiquement les informations de licence avec votre application. Vous n'avez donc plus besoin de synchroniser manuellement votre licence.

Une fois la licence mise à jour automatiquement (pour les environnements non-airgap), vous devrez tout de même déployer manuellement la configuration mise à jour sur votre instance.

Deploying the updated configuration