Aller au contenu principal

Backup & Restore

attention

GitGuardian chiffre toutes les informations sensibles dans la base de données à l'aide d'une clé de chiffrement des données (également connue sous le nom de Django Secret Key). En cas de sinistre, cette clé sera essentielle pour restaurer vos données.

Quelle que soit la méthode d'installation (KOTS ou Helm), assurez-vous que la clé de chiffrement est stockée en toute sécurité et accessible.

Utilisez la commande suivante pour afficher la clé :

kubectl get secrets gim-secrets --namespace=<namespace> -o jsonpath='{.data.DJANGO_SECRET_KEY}' | base64 -d

Sauvegarde​

Pour sauvegarder entièrement l'application GitGuardian, vous devez :

  • Sauvegarder la base de données PostgreSQL (⚠️ et la clé de chiffrement des données).
  • Sauvegarder la configuration KOTS (pour les installations basées sur KOTS en existing cluster).
  • Sauvegarder le fichier de valeurs Helm (pour les installations basées sur Helm en existing cluster).

Nous recommandons fortement d'utiliser des bases de données et des data stores gérés en externe, ainsi qu'une stratégie robuste de snapshots et de sauvegardes. Une installation en embedded cluster avec une base de données PostgreSQL intégrée n'est pas recommandée pour les déploiements en production et est destinée uniquement à des fins de PoC/test. Pour plus d'informations, consultez la page Choisir votre méthode d'installation.

Installation basée sur Helm​

Assurez-vous de sauvegarder le fichier de valeurs que vous avez créé lors de l'installation.

Installation basée sur KOTS​

Pour sauvegarder les fichiers de configuration KOTS, utilisez :

kubectl kots get config \
--namespace gitguardian \
--decrypt \
--appslug gitguardian > config.yaml
attention

La configuration de sauvegarde contient des secrets. Assurez-vous qu'elle est stockée en toute sécurité et que son accès est strictement contrôlé.

Si nécessaire, spécifiez le namespace Kubernetes avec --namespace (le namespace par défaut est utilisé s'il n'est pas spécifié).

KOTS offre un mécanisme pour simplifier les sauvegardes de votre application GitGuardian. Pour des informations détaillées sur la sauvegarde et la restauration, y compris la compatibilité des versions de Velero, veuillez consulter le site web de Replicated.

ClickHouse​

Si votre installation utilise ClickHouse pour les fonctionnalités d'analytics, celui-ci dispose de son propre mécanisme de sauvegarde et de sa procédure de restauration : consultez Sauvegarde et restauration de ClickHouse. Notez qu'un plan complet de reprise après sinistre pour les fonctionnalités s'appuyant sur ClickHouse peut nécessiter de restaurer à la fois ClickHouse et PostgreSQL à un instant cohérent.

Restauration​

La restauration de l'instance GitGuardian dépend de la situation. Souhaitez-vous simplement revenir à une sauvegarde antérieure de la base de données ? Cherchez-vous à revenir à une version antérieure de l'application ? Avez-vous perdu votre base de données et/ou votre cluster Kubernetes et devez-vous restaurer l'application et la base de données à partir de zéro ?

Restauration de la base de données uniquement​

Pour restaurer la base de données PostgreSQL, suivez ces étapes :

  1. Arrêtez l'application.
  2. Videz le cache Redis.
  3. Restaurez la base de données PostgreSQL.
  4. Redémarrez l'application.

Retour à une version antérieure de l'application​

danger

Ne revenez pas à une version antérieure ou n'effectuez pas de rétrogradation sans consulter au préalable notre équipe de support. Certains scénarios peuvent nécessiter de restaurer la base de données à partir d'une sauvegarde antérieure à la mise à niveau en raison de la complexité d'annulation de certaines migrations de base de données.

Reprise après sinistre​

Si vous devez réinstaller l'application à partir de zéro pour une reprise après sinistre, suivez la procédure d'installation appropriée en fonction de votre configuration :

Installation basée sur Helm​

  1. Utilisez votre fichier de valeurs précédemment sauvegardé.
  2. Assurez-vous de spécifier la clé de chiffrement en :

Installation basée sur KOTS​

  1. Suivez la procédure d'installation pour votre configuration KOTS.
  2. Configurez l'installation avec les paramètres essentiels.
  3. Une fois l'installation terminée, restaurez les fichiers de configuration KOTS à l'aide de la commande suivante :
    kubectl kots install gitguardian \
    --namespace gitguardian \
    --use-minimal-rbac \
    --shared-password <set_new_password> \
    --license-file license.yaml \
    --config-values config.yaml
    • Remplacez <set_new_password> par le mot de passe de votre choix (utilisé pour accéder à la KOTS Admin Console).
    • Ajustez le namespace si nécessaire.
    • Assurez-vous d'utiliser le fichier config.yaml de votre sauvegarde.
    • Cette commande doit être exécutée sur un namespace inexistant ou vide (c'est-à-dire sans installation KOTS préalable).
  4. Dans la KOTS Admin Console, vérifiez que la configuration est correcte et déployez l'application. KOTS Admin Config