Documentation de référence sur les commandes Git

Vous pouvez accéder aux commandes Git en cliquant sur le bouton situé en haut à droite de l'IDE Looker ou en sélectionnant le bouton Actions Git dans le menu de navigation de gauche.

Le panneau Actions Git n'est pas disponible tant que vous n'avez pas configuré votre projet pour Git.

Le tableau suivant présente les commandes Git possibles. Notez que les commandes disponibles dans l'IDE Looker dépendent de l'étape où vous en êtes dans le processus d'apport de modifications et de déploiement en production. L'IDE affiche uniquement les commandes Git qui s'appliquent à votre état actuel.

Fonction Description Comment y accéder
Commit Après avoir apporté et enregistré des modifications dans votre projet LookML, cliquez sur le bouton Commit Changes & Push (Valider les modifications et transférer) pour valider ces modifications dans votre branche locale et les envoyer en production. Pour en savoir plus, consultez la page de documentation Utiliser le contrôle des versions et le déploiement. Panneau Actions Git
Valider les modifications et transférer Bouton
Valider et résoudre le conflit Le bouton Valider et résoudre le conflit s'affiche lorsque vous apportez des modifications après un conflit de fusion. Cliquez sur Valider et résoudre le conflit pour valider vos modifications et effacer le conflit de fusion. Bouton
Historique de commit Affiche la liste des commits de votre branche, qui comprend tous les commits que vous avez importés dans votre branche de développement à partir de la branche de production (y compris les commits d'autres utilisateurs).

Si vous utilisez GitHub et que l'intégration GitHub est activée dans les paramètres du projet Git, chacun des commits inclura un lien vers le commit sur GitHub afin que vous puissiez voir les modifications exactes. Cette fonctionnalité est également compatible avec d'autres fournisseurs Git si l'équivalent de l'intégration GitHub de votre fournisseur Git est activé dans les paramètres de votre projet Git. Pour ouvrir les liens, vous devez posséder un compte auprès de votre fournisseur Git.
Panneau Actions Git
Configurer Git Si vous venez de créer un projet, vous devez configurer Git pour celui-ci. Pour en savoir plus, consultez la page de documentation Configurer et tester une connexion Git. Bouton
Déployer à distance Pour les projets pour lesquels le développeur dispose d'un accès en lecture seule, le bouton Déployer à distance est déployé à partir de la branche de production distante. Bouton
Déployer en production Une fois les modifications validées, utilisez l'option Déployer en production pour mettre à jour la branche de production avec les modifications validées de votre branche de développement. Cette option n'est pas disponible si votre projet est configuré pour les requêtes d'extraction requises. De plus, si le mode de déploiement avancé est activé pour votre projet, le bouton Déployer en production n'apparaît pas. À la place, vous verrez Fusionner vers la branche principale. Bouton, panneau Actions Git
Ne pas résoudre le problème Le bouton Ne pas résoudre s'affiche en cas de conflit de fusion entre un ou plusieurs développeurs ou branches de développement du projet. Le bouton Ne pas résoudre transfère la version actuelle de votre branche, avec tous les repères de conflit de fusion, vers la télécommande.

Cette option ne doit être utilisée que par les utilisateurs Git avancés, car les repères de conflit de fusion risquent de rendre vos modèles inutilisables.
Bouton
Fusionner avec la branche principale Si le mode de déploiement avancé est activé pour votre projet, le bouton Fusionner avec la branche principale s'affiche une fois le commit effectué. Cela vous invite à fusionner vos modifications avec la branche principale. Une fois que vous avez fusionné vos modifications avec la branche principale, un développeur Looker disposant de l'autorisation deploy peut déployer vos modifications dans l'environnement de production à l'aide d'un webhook, de l'API ou de l'interface utilisateur du gestionnaire de déploiement dans l'IDE Looker. Bouton
Ouvrir (fournisseur Git) L'option Open (Git provider) (Ouvrir (fournisseur Git)) ouvre une fenêtre de navigateur affichant les fichiers de projet sur l'interface de votre fournisseur Git. Bouton
Ouvrir la demande d'extraction Pour les projets où les demandes d'extraction sont recommandées ou obligatoires, l'option Ouvrir la demande d'extraction ouvre une nouvelle fenêtre de navigateur vers la nouvelle page de demande d'extraction de votre fournisseur Git. Vous pouvez alors créer une demande d'extraction pour votre branche de développeur.

REMARQUE:Tant que la demande d'extraction d'extraction n'est pas approuvée et/ou fermée, tous les futurs commits de la branche sont inclus dans la même demande d'extraction d'extraction.
Panneau Actions Git
Extraire et fusionner les autres modifications Le bouton Extraire et fusionner les autres modifications a la même fonction que l'option Extraire de (branche de production), mais le bouton Extraire et fusionner les autres modifications s'affiche dans des circonstances différentes : lorsque vous avez validé des modifications sur votre branche sans les déployer, et que des modifications distantes, non déployées et validées sont présentes sur la branche. Dans ce cas, vous devez extraire les modifications de la télécommande et les fusionner dans votre branche. Bouton
Extraire de la branche principale Si le mode de déploiement avancé est activé pour votre projet, l'option Extraire de la branche principale s'affiche lorsque la branche principale comporte des commits qui ne figurent pas dans votre branche de développeur. Bouton
Extraire de (branche de production) L'option Extraire de (branche de production) n'est pas disponible lorsque la branche de développeur actuelle comporte des modifications non validées. Vous devez valider les modifications sur la branche pour que l'option Extraire de (branche de production) s'affiche. Bouton, panneau Actions Git
Extraire les modifications distantes Si d'autres personnes ont validé et transféré des modifications sur une branche, la version distante de la branche est antérieure à votre version locale de la branche. Le bouton Pull Remote Changes (Extraire les modifications distantes) s'applique à la branche que vous utilisez actuellement. Il permet de récupérer depuis l'extrémité distante les versions les plus récentes de tous les fichiers modifiés sur la branche et de les synchroniser avec vos fichiers locaux. Bouton
Transférer la branche vers l'emplacement distant Si vous avez créé une branche qui n'existe pas du côté distant, le bouton Push Branch to Remote (Transférer la branche vers distante) s'affiche. L'option Push Branch to Remote crée la branche à l'extrémité distante, en transmettant toutes les modifications validées de vos fichiers locaux vers l'extrémité distante. Notez que cela ne déploie pas vos modifications dans la branche de production. Bouton
Déployer les modifications vers le dépôt distant Si vous avez validé les modifications apportées à votre branche actuelle et qui ne sont pas encore transférées vers la version distante de la branche, vous verrez l'option Déployer les modifications vers l'emplacement distant. L'opération Déployer les modifications vers le serveur distant s'applique à la branche que vous utilisez actuellement, en transférant toutes les modifications validées à partir de vos fichiers locaux et en les synchronisant vers l'extrémité distante. Bouton, panneau Actions Git
Revenir à l'application distante L'option Rétablir à distance permet de supprimer toutes les modifications apportées à votre branche locale et de synchroniser vos fichiers locaux avec les fichiers actuels de la branche distante. Notez que cette opération a deux effets :
  1. Supprimer toutes les modifications validées et non validées qui n'ont pas été déployées en production
  2. Met à jour la version locale de la branche avec les modifications que d'autres utilisateurs ont apportées à la branche.
Bouton
Revenir au mode partagé L'option Rétablir le partage permet de supprimer toutes les modifications apportées à votre branche locale et de synchroniser vos fichiers locaux avec les fichiers actuels de la branche distante. Notez que cette opération a deux effets :
  1. Supprimer toutes les modifications validées et non validées qui n'ont pas été déployées en production
  2. Met à jour la version locale de la branche avec les modifications que d'autres utilisateurs ont apportées à la branche.
Bouton
Annuler les modifications non validées Si vous avez enregistré des modifications qui n'ont pas encore été validées, vous pouvez utiliser l'option Annuler les modifications non validées pour supprimer toutes les modifications qui n'ont pas été validées. Pour en savoir plus, consultez la page de documentation Utiliser le contrôle des versions et le déploiement. Bouton
Exécuter les tests Si votre projet est configuré pour exiger la réussite des tests de données avant de pouvoir être déployé en production, l'IDE affichera le bouton Run Tests (Exécuter les tests) une fois que vous aurez validé les modifications apportées au projet. Vous devez réussir les tests de données avant de pouvoir déployer vos modifications en production. Vous pouvez également exécuter les tests manuellement en cliquant sur l'icône Run Data Tests (Exécuter des tests de données) dans le panneau Project Health (État du projet). Pour en savoir plus sur l'exécution de tests de données, consultez la page Utiliser le contrôle des versions et le déploiement de la documentation. Consultez la page de documentation du paramètre test pour en savoir plus sur la configuration de tests de données dans votre projet. Bouton
Tester la connexion Git Une fois que vous avez configuré Git pour votre projet, vous pouvez utiliser l'option Test Git Connection (Tester la connexion Git) pour exécuter l'outil Git de test de connexion, qui vérifie que votre connexion Git est correctement configurée. Pour en savoir plus, consultez la page de documentation Tester votre connexion Git. Bouton, panneau Actions Git
À jour Si votre branche locale est synchronisée avec la branche distante, le bouton À jour s'affiche. Bouton
Mettre à jour les dépendances Pour les projets qui utilisent l'importation de projets à distance, l'option Update Dependencies (Mettre à jour les dépendances) s'affiche lorsque vous ajoutez un projet distant pour la première fois, ou lorsque votre projet contient déjà un projet distant importé qui Looker détecte de nouveaux commits que vous pouvez importer dans votre projet. Utilisez cette option pour récupérer les fichiers du projet distant. Si vous venez d'ajouter un projet distant, l'utilisation de cette option crée également un fichier de verrouillage du fichier manifeste, que Looker utilise pour suivre la version du projet à distance. Pour en savoir plus, consultez la section Détecter automatiquement les nouvelles versions d'un projet distant de la page de documentation Importer des fichiers d'autres projets. Bouton, panneau Actions Git
Valider le code LookML Si vous avez enregistré des modifications apportées à vos fichiers, le bouton Valider LookML peut s'afficher. (Le fait que vous deviez ou non valider votre code LookML dépend du paramètre de qualité du code défini dans votre projet.) Cliquez sur ce bouton pour lancer la validation LookML de votre modèle. Pour en savoir plus, consultez la page Validation de votre code LookML. Bouton
Afficher le projet sur (fournisseur Git) L'option View Project on (Git provider) (Afficher le projet sur (fournisseur Git)) ouvre une fenêtre de navigateur affichant les fichiers de projet sur l'interface de votre fournisseur Git. Panneau Actions Git
Afficher les modifications non validées Si vous avez enregistré des modifications qui n'ont pas encore été validées, vous pouvez utiliser l'option Afficher les modifications non validées pour afficher toutes les modifications enregistrées depuis votre dernier commit. Pour en savoir plus, consultez la page de documentation Utiliser le contrôle des versions et le déploiement. Panneau Actions Git