Créer des sauvegardes

Si votre instance Looker est hébergée par Looker, Looker effectue automatiquement des sauvegardes régulières pour votre instance. Pour en savoir plus, consultez la section Sauvegardes automatiques pour les instances hébergées par Looker.

Si votre instance est hébergée par le client, vous devrez créer vos propres sauvegardes. Pour en savoir plus, consultez la section Stratégie de sauvegarde pour les instances hébergées par le client.

Sauvegardes automatiques pour les instances hébergées par Looker

Les instances hébergées par Looker sont sauvegardées automatiquement une fois toutes les 24 heures. Chaque sauvegarde contient un enregistrement de toutes les données de la base de données interne de l'instance et du serveur de fichiers de l'instance, qui représentent la plupart des données opérationnelles de l'instance Looker. Toutefois, les données de l'activité du système Elite ne sont pas sauvegardées.

Les sauvegardes sont conservées pendant 30 jours. Pour accéder à une sauvegarde et la restaurer, contactez l'assistance.

Stratégie de sauvegarde pour les instances hébergées par le client

Pour les instances hébergées par le client, vous pouvez créer une sauvegarde d'une installation Looker de base en copiant simplement le répertoire personnel de l'utilisateur Looker (y compris tous les sous-répertoires normaux et masqués). Vous pouvez utiliser scp, rsync ou n'importe quelle application de sauvegarde standard. De même, la restauration d'une installation Looker de base nécessite uniquement la restauration des fichiers et le démarrage de Looker.

Dans certaines configurations, y compris les environnements en cluster, Looker utilise une base de données MySQL externe pour les paramètres d'application, les comptes utilisateur et d'autres données. Dans ce cas, nous vous recommandons de créer une sauvegarde de la base de données MySQL en plus du répertoire personnel Looker.

Nous vous recommandons vivement de créer ces sauvegardes tous les jours. Nous vous recommandons également d'effectuer une restauration test une fois par trimestre.

Structure des répertoires

Les sous-répertoires standards du répertoire personnel de l'utilisateur Looker (généralement /home/looker) sont décrits ici.

  •  home
    •  looker
    • .ssh
    • looker
      • .cache
      • .db
      • .ssl
      • .tmp
      • deploy_keys
      • Journal
      •  modèles
      •  models-user-1
Annuaire Sauvegarde requise Modifier la fréquence Description
.ssh Oui Rarement Clés SSH utilisées pour l'authentification auprès de Git pour les projets LookML créés avec Looker 4.6 ou version antérieure
looker/.cache Non Fréquents Fichiers de cache temporaires
looker/.db Oui, sauf si la base de données backend a été migrée vers MySQL Fréquents Base de données interne Looker
looker/.snapshots Non Lors de la mise à jour Une copie de sauvegarde du fichier jar Looker et du répertoire .db est stockée ici lors des mises à jour.
looker/.ssl Peut-être Rarement Certificats SSL autosignés (voir remarque)
looker/.tmp Non Fréquents Fichiers temporaires
looker/deploy_keys Oui Rarement Clés SSH utilisées pour l'authentification auprès de Git pour les projets LookML créés avec Looker 4.8 ou version ultérieure
looker/log Peut-être Fréquents Fichiers journaux (uniquement si requis par vos règles de conservation)
looker/models Non Variable Modèles de production, copiés à partir du dépôt source (généralement GitHub)
looker/models-user-* Oui Variable Les modèles de développement de chaque utilisateur sont stockés dans des répertoires distincts portant le numéro d'identification de l'utilisateur.

Remarque concernant SSL : Par défaut, le répertoire SSL ne contient qu'un certificat SSL autosigné, qu'il n'est pas nécessaire de conserver. Toutefois, si vous stockez des fichiers supplémentaires dans ce répertoire (par exemple, des certificats SSL signés par une autorité de certification), vous devez ajouter ce répertoire à votre sauvegarde.

Voici les fichiers en dehors du répertoire d'accueil Looker qui doivent être ajoutés à votre sauvegarde :

Annuaire Sauvegarde requise Modifier la fréquence Description
/etc/init.d/looker Oui Rarement Script de démarrage du système pour Looker
Certificats SSL Oui Rarement Si vous utilisez des certificats SSL, assurez-vous d'inclure tous les fichiers requis.

Bien que cela ne pose généralement pas de problème, certains clients ont signalé des problèmes lorsqu'ils incluent le fichier looker/.db/looker.lck dans leurs sauvegardes. Si nécessaire, vous pouvez exclure ce fichier en toute sécurité.

Créer une sauvegarde

Vous pouvez créer une sauvegarde de votre instance Looker avec n'importe quelle application de sauvegarde standard, ainsi qu'avec des outils de ligne de commande tels que rsync.

Il est préférable que le processus de sauvegarde s'exécute lorsque l'application est utilisée le moins possible. En plus de l'interaction utilisateur normale, tenez compte des moments où les Looks programmés peuvent être exécutés, où les tables dérivées peuvent être reconstruites, etc.

Environnements en cluster

Les instances Looker en cluster stockent leur configuration d'application, leurs comptes utilisateur et d'autres données dans une base de données MySQL externe. Nous vous recommandons de créer une sauvegarde de cette base de données en même temps que l'application Looker. Pour en savoir plus sur la sauvegarde des bases de données MySQL, consultez la documentation MySQL.

Générer une sauvegarde indépendante du keystore

Une installation hébergée par le client qui a migré vers le chiffrement AES-256 GCM et qui n'utilise pas AWS KMS peut suivre cette procédure pour créer une sauvegarde de son instance Looker indépendante de sa clé client principale (CMK) locale. Cette procédure explique comment migrer une instance hébergée par le client vers une instance hébergée par Looker sans avoir à fournir de CMK, ou comment déplacer une instance hébergée par le client vers un nouvel hôte qui n'a pas accès au même keystore local.

Pour créer une sauvegarde indépendante du keystore :

  1. Arrêter Looker :

    cd looker
./looker stop

    Si votre instance Looker est en cluster, veillez à arrêter chaque nœud avant de continuer.

  2. Assurez-vous que votre instance Looker peut accéder à votre CMK. Si votre CMK est stockée dans un fichier, vous pouvez utiliser la variable d'environnement LKR_MASTER_KEY_FILE pour indiquer le chemin d'accès à votre fichier CMK :

    export LKR_MASTER_KEY_FILE=<path_to_CMK_file>

    Vous pouvez également fournir votre CMK directement dans une variable d'environnement d'environnement à l'aide de la variable d'environnement LKR_MASTER_KEY_ENV :

    export LKR_MASTER_KEY_ENV=<CMK_value>

  3. Générez un fichier de clé qui sera utilisé pour rechiffrer la clé de chiffrement de clé (KEK) :

    ./looker generate_keyfile_for_backup <key_file_name>

    Où <key_file_name> est le nom que vous souhaitez utiliser pour le fichier que Looker créera et utilisera ensuite pour écrire la nouvelle clé.

    Le contenu du nouveau fichier de clé se présente comme suit :

    {"dbmk":"vr1LUwO3q6weY8iS3JykVljSjiD4m6eGk227Cs7Qu9Q=\n","backup_uid":"XCXvRa38mNeqT6+HRBCo2Q=="}

    La valeur de dbmk est une clé de chiffrement de 256 bits encodée en Base64, et backup_uid est un nom unique utilisé lors de l'enregistrement de la clé dans la base de données.

  4. Utilisez le nouveau fichier de clé pour créer une entrée de clé dans la base de données interne de Looker :

    ./looker keystore_independent_recrypt <key_file_name>

    où <key_file_name> est le fichier de clé créé précédemment.

    La KEK est alors déchiffrée dans la base de données interne à l'aide de la CMK, puis rechiffrée avec la nouvelle clé et cette valeur chiffrée est conservée dans la base de données.

  5. Créez une sauvegarde de votre instance Looker à l'aide de votre méthode de sauvegarde habituelle.

Pour restaurer cette sauvegarde indépendante du keystore, vous aurez besoin du nouveau fichier de clé créé précédemment.

Restaurer des sauvegardes

Pour restaurer une sauvegarde de votre instance Looker, consultez la page de documentation Restaurer des sauvegardes.

Étapes suivantes

Une fois les sauvegardes configurées, vous pourrez vous assurer que votre instance Looker peut accéder aux services nécessaires.