Les projets Looker reposent sur des configurations Git stables (comme les connexions à des dépôts distants, les clés de déploiement valides, les structures de dépôt intactes et les autorisations de système de fichiers correctes). En cas de problème Git, les développeurs et les administrateurs peuvent utiliser l'outil Diagnostiquer et réparer pour tester l'état du dépôt, identifier les causes premières et exécuter des réparations automatiques.
L'outil Diagnostiquer et réparer évalue le dépôt de votre projet LookML à l'aide de huit tests de diagnostic dans votre environnement de développement personnel ou dans l'environnement de production partagé. Lorsque des problèmes sont détectés, Looker peut effectuer automatiquement des réparations chirurgicales (par exemple, supprimer les fichiers de verrouillage obsolètes, corriger les autorisations d'accès aux fichiers ou réparer les index d'objets corrompus) ou reconstruire les dépôts endommagés tout en protégeant les modifications non validées sur une branche de récupération dédiée.
Conditions préalables et autorisations
Pour utiliser l'outil Git Diagnostiquer et réparer, vous devez disposer des autorisations suivantes :
- Environnement de développement : nécessite l'autorisation
developpour au moins un modèle du projet. - Environnement de production : nécessite l'autorisation
deploypour au moins un modèle du projet.
Exécuter un diagnostic Git
Pour diagnostiquer un projet LookML, procédez comme suit :
- Activez le mode Développement.
- Dans le panneau de navigation, sélectionnez Développer pour ouvrir le panneau Développer.
- Dans le panneau Développer, sélectionnez Projets pour afficher la page Projets LookML.
- Ouvrez le projet que vous souhaitez diagnostiquer.
- Sélectionnez l'icône Paramètres dans le menu d'icônes de l'IDE Looker.
- Dans la section Diagnostic et réparation Git, cliquez sur Diagnostiquer et réparer.
Dans la boîte de dialogue Diagnostiquer et réparer, sélectionnez l'environnement que vous souhaitez tester :
- Développement : teste votre copie personnelle du dépôt Git pour les développeurs.
- Production : teste la copie de production du dépôt Git.
Cliquez sur Diagnostiquer.
Looker lance la suite de tests de diagnostic et affiche la progression en direct de chaque vérification de test dans la boîte de dialogue.
Comprendre les résultats du diagnostic
Lorsque la suite de tests de diagnostic s'exécute, chaque vérification renvoie l'un des états suivants :
| Badge d'état | Signification | Action requise |
|---|---|---|
| Non détecté | La vérification du diagnostic a réussi et aucun problème n'a été détecté. | Aucune action n'est requise. |
| Détecté | Un problème ou une incohérence a été détecté dans le dépôt ou la connexion. | Exécutez la réparation automatique si elle est disponible, ou suivez les étapes de résolution manuelle. |
| Réparé | Un problème a été résolu par le processus de réparation automatique. | Aucune autre action n'est requise. |
| Échec | La tentative de réparation automatique n'a pas permis de résoudre le problème ou la vérification nécessite une intervention manuelle. | Examinez les détails du problème et suivez les procédures de correction manuelle. |
Exécuter des réparations automatiques
Si des diagnostics renvoient l'état Détecté et prennent en charge la réparation automatique, vous pouvez lancer les réparations directement depuis la boîte de dialogue :
- Dans la boîte de dialogue Diagnostiquer et réparer, cliquez sur le bouton Démarrer la réparation.
- Looker applique des corrections automatiques à tous les problèmes pouvant être résolus.
- Une fois le processus de réparation terminé, les badges d'état passent à Réparé pour les vérifications résolues ou à Échec si une intervention manuelle est requise.
Référence pour les vérifications et les réparations de diagnostic
La suite de tests de diagnostic évalue huit catégories de problèmes Git. Le tableau suivant décrit chaque vérification, son diagnostic et l'action de correction effectuée :
| Diagnostic | Description | Type de réparation | Mesures correctives |
|---|---|---|---|
| Configuration de Git | Vérifie que le projet dispose des prérequis nécessaires pour initialiser son dépôt (URL d'origine Git distante configurée et enregistrement de configuration de base de données actif). | Manuelle | Si des valeurs requises sont manquantes, effectuez la configuration Git initiale dans les paramètres du projet (Paramètres > Configuration > Configurer Git). Pour en savoir plus, consultez la section Résoudre les problèmes de configuration de Git. |
| Test de connexion Git | Exécute la suite de tests de connexion Git standard de Looker sur le dépôt d'origine distant, en vérifiant les identifiants, l'accessibilité du réseau et les autorisations d'accès à distance. | Manuelle | Les échecs de connexion sont dus à des facteurs externes (par exemple, des clés de déploiement SSH expirées, des jetons d'accès OAuth ou personnels révoqués, des restrictions de pare-feu ou des pannes de fournisseur). Résolvez le problème d'identifiants ou de réseau directement avec votre fournisseur Git. Pour en savoir plus, consultez la section Résoudre les problèmes liés au test de connexion Git. |
| Accès au système de fichiers | Détecte les erreurs d'E/S ou de stockage du système de fichiers qui empêchent Looker de lire les listes de répertoires ou les noms de fichiers dans le dépôt du projet. | Automatique | Reconstruit une copie propre du dépôt du projet à partir de zéro. Archive l'ancien répertoire dans une sauvegarde sécurisée et enregistre le travail non validé dans une branche de récupération à distance. |
| État fonctionnel du dépôt | Vérifie si la structure .git interne est présente et intacte, et vérifie que Git reconnaît le répertoire comme un arbre de travail fonctionnel. |
Automatique | Reconstruit le dépôt du projet à partir de zéro, en restaurant une structure de répertoire Git saine tout en archivant le contenu précédent pour éviter toute perte de données. |
| Fichier de verrouillage Git | Recherche les fichiers .lock obsolètes (tels que les verrous d'index ou de configuration) laissés par les opérations Git interrompues ou terminées qui bloquent les commandes Git suivantes. |
Automatique | Supprime immédiatement et de manière sécurisée les fichiers de verrouillage obsolètes, ce qui débloque les opérations Git sans modifier l'historique du dépôt ni les fichiers de travail. |
| Autorisations liées à l'objet | Analyse les fichiers et répertoires du projet pour détecter les autorisations du système de fichiers qui s'écartent des normes de sécurité et opérationnelles recommandées (par exemple, en s'assurant que les répertoires et les scripts ont un accès en lecture et en exécution, tandis que les fichiers standards restent non exécutables). | Automatique | Normalise automatiquement les autorisations de fichiers et de répertoires dans l'ensemble du projet, en rétablissant des autorisations d'accès standards sécurisées sans modifier le contenu des fichiers. |
| Paramètres de configuration Git | Vérifie si la configuration Git interne du dépôt correspond aux valeurs par défaut requises par Looker (en particulier, vérifie que le suivi du mode fichier core.filemode est désactivé afin que les différences d'autorisation entre les systèmes de fichiers ne génèrent pas de faux changements). |
Automatique | Met à jour la configuration du dépôt pour qu'elle corresponde aux paramètres par défaut de Looker et enregistre la configuration mise à jour. |
| Vérification de la cohérence du dépôt | Exécute une vérification du système de fichiers Git (git fsck) pour inspecter la base de données d'objets internes du dépôt à la recherche d'une corruption structurelle (y compris des fichiers d'index endommagés, des signatures de commit incorrectes, des pointeurs d'objet non valides, des objets corrompus ou des références cassées). |
Automatique | Réparation initiale : reconstruit les index, supprime les journaux de référence obsolètes, supprime les références corrompues et exécute git fetch --refetch pour récupérer les objets manquants.Reconstruction de secours : si la réparation initiale ne permet pas de résoudre toutes les erreurs, reconstruit le dépôt de manière sécurisée et préserve le travail non validé sur une branche de récupération à distance. |
Résoudre les problèmes Git manuels
Si les vérifications Configuration Git ou Test de connexion Git détectent un problème, la réparation automatique n'est pas disponible, car le problème provient d'un emplacement extérieur au dépôt local. Pour résoudre les problèmes manuels, suivez ces consignes :
Résoudre les problèmes de configuration de Git :
- Ouvrez votre projet dans l'IDE Looker.
- Sélectionnez l'icône Paramètres dans le menu des icônes.
- Dans l'onglet Configuration, sélectionnez Réinitialiser la connexion Git ou Configurer Git pour terminer la configuration du dépôt. Pour obtenir des instructions détaillées, consultez Configurer et tester une connexion Git.
Résoudre les problèmes liés au test de connexion Git :
- Clés de déploiement SSH : vérifiez que la clé de déploiement dans Looker correspond à la clé publique enregistrée auprès de votre fournisseur d'hébergement Git et assurez-vous que l'accès en écriture est activé pour la clé. Si nécessaire, générez une clé de déploiement dans les paramètres du projet et mettez à jour votre fournisseur Git.
- Identifiants HTTPS et jetons d'accès personnel : vérifiez si votre jeton d'accès personnel ou le mot de passe de votre compte de service ont expiré ou ont été révoqués. Générez un jeton sur votre fournisseur Git et mettez à jour vos identifiants dans Looker.
- Listes d'autorisation d'adresses IP et pare-feu : assurez-vous que votre fournisseur d'hébergement Git autorise le trafic entrant provenant des adresses IP de votre instance Looker.