Configurer et tester une connexion Git

Lorsque vous créez un projet, il n'existe qu'en mode Développement, ce qui vous permet de développer votre modèle dans un environnement sécurisé sans incidence sur les autres utilisateurs. Une fois que vous êtes prêt à publier votre projet, l'étape suivante consiste à configurer une connexion Git.

En configurant une connexion Git pour votre projet, vous pouvez déployer votre code LookML en mode Production, ce qui permet à d'autres utilisateurs d'explorer votre modèle de données, de créer des tableaux de bord et d'ajouter LookML à votre modèle. Pour une configuration plus rapide, utilisez un dépôt simple. Pour une intégration Git plus robuste, créez votre propre dépôt Git et suivez les instructions de cette page pour le connecter à votre instance Looker.

Intégration de Looker à Git

Looker utilise Git pour enregistrer les modifications et gérer les versions des fichiers. Chaque projet LookML correspond à un dépôt Git. Chaque fois qu'un utilisateur est en mode Développement, il se trouve sur sa propre branche Git.

Pour la gestion des fichiers sources LookML, Looker peut être configuré avec n'importe quel fournisseur Git utilisant une clé SSH ou HTTPS pour l'authentification. Les étapes générales sont les mêmes quelle que soit la plateforme que vous utilisez. Cette page utilise GitHub comme exemple pour connecter un projet Looker à Git une fois que vous avez créé un dépôt Git.

Pour accéder aux options d'intégration Git, le mode Développement doit être activé.

Vous pouvez configurer l'intégration Git à l'aide de l'un des protocoles suivants:

  • HTTPS: protocole de transfert hypertexte sécurisé (HyperText Transfer Protocol Secure). Avec HTTPS, Looker accède à votre dépôt Git avec le nom d'utilisateur et le mot de passe (ou le jeton d'accès) que vous fournissez, comme décrit dans la section Se connecter à Git à l'aide de HTTPS.
  • SSH: Secure Shell. Avec SSH, Looker accède à votre dépôt Git à l'aide d'une clé de déploiement que vous générez via le site Web de votre fournisseur Git, comme décrit dans la section Se connecter à Git à l'aide de SSH.

Se connecter à Git via HTTPS

Pour les projets LookML configurés avec l'authentification HTTPS, Looker se connecte à votre fournisseur Git à l'aide d'un ou de plusieurs comptes utilisateur configurés auprès de votre fournisseur Git. Looker utilise un nom d'utilisateur et un mot de passe (ou un jeton d'accès) pour se connecter à votre fournisseur Git et effectuer des opérations Git pour le compte de vos développeurs LookML.

Si votre compte Git utilise l'authentification à deux facteurs, vous pouvez accéder à votre fournisseur Git et créer des jetons d'accès à utiliser à la place des mots de passe. Consultez le post destiné à la communauté Configurer une connexion Git HTTPS avec l'authentification à deux facteurs activée pour obtenir des instructions sur la création de jetons d'accès personnels pour les fournisseurs Git courants.

Avec l'authentification HTTPS, vous pouvez configurer votre projet LookML de sorte qu'il utilise un seul compte Git pour l'ensemble du projet, ou bien le projet de sorte qu'il utilise les comptes Git individuels de vos développeurs pour effectuer leurs opérations Git.

Notez les points suivants pour l'authentification HTTPS GitHub:

  • GitHub n'accepte pas les mots de passe de compte pour l'authentification des opérations Git sur github.com. Pour en savoir plus, consultez l'article de blog de GitHub. Pour connecter un projet Looker à GitHub à l'aide de HTTPS, utilisez les paramètres développeur dans GitHub afin de créer un jeton d'accès personnel.
  • Looker ne prend pas en charge les jetons d'accès personnels ultraprécis de GitHub. Pour connecter votre projet Looker à GitHub à l'aide du protocole HTTPS, utilisez l'option Jetons (classique) de GitHub lorsque vous créez un jeton d'accès personnel.

Authentification HTTPS pour un seul compte

Si vous configurez votre projet LookML avec un seul compte Git, Looker l'utilise pour se connecter à votre fournisseur Git afin de valider les modifications pour le compte des développeurs. Looker effectue ces commits en utilisant le nom d'utilisateur Looker du développeur, ce qui vous permet de savoir quel développeur est à l'origine de chaque commit. Vous pouvez consulter l'historique des commits de votre projet sur l'interface de votre fournisseur Git ou en sélectionnant l'option Historique dans le menu Git de l'IDE Looker. Pour en savoir plus sur les menus Git dans Looker, consultez la section Exécuter des commandes Git dans Looker.

Pour l'authentification HTTPS de compte unique, le compte utilisateur Git que vous spécifiez doit disposer d'un accès en lecture et en écriture à votre dépôt Git. Vos développeurs LookML eux-mêmes n'ont pas besoin de disposer de leurs propres comptes utilisateur Git.

Authentification HTTPS multicompte avec attributs utilisateur

Si vous configurez votre projet LookML avec plusieurs comptes, votre projet LookML utilisera le compte Git individuel de chaque développeur Looker pour effectuer les opérations Git. Vous devez également configurer un compte utilisateur Git générique, avec au moins un accès en lecture, que Looker utilisera pour extraire la version de production des fichiers.

Les tâches et exigences suivantes sont nécessaires pour l'authentification Git avec des attributs utilisateur:

  • Chacun de vos développeurs LookML doit avoir son propre compte utilisateur auprès de votre fournisseur Git. Chaque compte utilisateur Git doit disposer d'un accès en lecture et en écriture au dépôt du projet.
  • Votre administrateur Looker doit configurer des comptes utilisateur Looker avec des attributs utilisateur correspondant au nom d'utilisateur Git et au mot de passe Git (ou au jeton d'accès si les comptes utilisateur Git utilisent l'authentification à deux facteurs).
  • Les attributs utilisateur des mots de passe des comptes Git (ou jetons d'accès) doivent être masqués. Lorsque vous créez l'attribut de mot de passe ou de jeton d'accès, sélectionnez Oui sous l'option Masquer les valeurs et saisissez l'URL du fournisseur Git dans le champ Liste d'autorisation de domaines.
  • Les attributs utilisateur pour le nom et le mot de passe Git (ou le jeton d'accès) doivent être renseignés pour chaque développeur Looker. Les attributs utilisateur peuvent être configurés par un administrateur Looker ou par l'utilisateur Looker.

L'exemple suivant montre la page d'administration des attributs utilisateur, dans laquelle un administrateur Looker a configuré des attributs utilisateur pour le nom d'utilisateur Git et le jeton d'accès utilisateur.

Tableau de la page "Administration des attributs utilisateur" qui affiche les attributs utilisateur de type chaîne "github_token" et github_username.

L'exemple suivant montre la page Compte d'un utilisateur Looker où l'utilisateur a saisi ses identifiants Git dans les champs d'attributs utilisateur.

Configurer l'authentification Git HTTPS

Pour configurer un projet LookML avec une authentification Git HTTPS, procédez comme suit:

  1. Obtenez l'URL HTTPS de votre dépôt Git. Dans le cas de GitHub, pour les nouveaux dépôts (dépôts qui ne contiennent pas encore de fichiers), GitHub affiche l'URL lors de la configuration initiale. Veillez à sélectionner le bouton HTTPS dans l'onglet Code pour obtenir l'URL HTTPS, puis sélectionnez l'icône Copier l'URL dans le presse-papiers pour la copier dans le presse-papiers.

    Pour les dépôts GitHub existants (dépôts contenant déjà des fichiers), vous pouvez voir l'URL HTTPS en accédant à l'onglet Code du dépôt et en sélectionnant le bouton Code. Veillez à sélectionner le lien HTTPS. Vous pouvez sélectionner l'icône Copier l'URL dans le presse-papiers pour copier l'URL HTTPS dans votre presse-papiers.

  2. Accédez à votre projet LookML, puis sélectionnez l'icône Settings (Paramètres) dans la barre de navigation.

  3. Sur la page Configuration du projet, dans l'onglet Configuration, accédez au bouton Configurer Git (pour les nouveaux projets) ou Réinitialiser la connexion Git (pour les projets existants qui ont déjà été connectés à Git).

  4. Sélectionnez le bouton Configure Git (Configurer Git) ou Reset Git Connection (Réinitialiser la connexion Git) pour ouvrir la page Configure Git (Configurer Git).

    Si vous réinitialisez votre connexion Git, l'historique Git de la branche principale sera conservé. L'historique de la branche personnelle de chaque développeur Looker sera également conservé lors de l'extraction, de la fusion et du déploiement. Pour conserver l'historique de toutes les branches, consultez la page des bonnes pratiques Migrer vers un nouveau dépôt Git.

  5. Sur la page Configurer Git de Looker, collez l'URL HTTPS de votre dépôt Git dans le champ URL du dépôt, puis sélectionnez Continuer.

    Looker détectera votre fournisseur Git et mettra à jour la fenêtre avec les informations sur votre dépôt Git.

    Si Looker ne parvient pas à détecter votre fournisseur Git, il vous demandera de le sélectionner dans un menu déroulant.

  6. Sélectionnez votre option de connexion Git:

  7. Dans les champs Nom d'utilisateur et Mot de passe/Jeton d'accès personnel, saisissez les identifiants que votre projet LookML utilisera pour accéder à Git. Cette étape est obligatoire, quel que soit votre paramètre de connexion Git:

    • Si vous avez sélectionné Utiliser une seule combinaison nom d'utilisateur/mot de passe/jeton d'accès personnel unique et constant, il s'agit du nom d'utilisateur et du mot de passe (ou jeton d'accès) Git que votre instance Looker utilisera pour toutes les opérations Git. Ce compte utilisateur Git doit disposer d'un accès en lecture et en écriture à votre dépôt Git.
    • Si vous avez sélectionné Utiliser les attributs utilisateur pour le nom d'utilisateur et le mot de passe/jeton d'accès personnel, il s'agit du nom d'utilisateur et du mot de passe Git (ou jeton d'accès) que votre instance Looker utilisera pour extraire la version de production du dépôt. Ce compte utilisateur Git doit au moins disposer d'un accès en lecture à votre dépôt Git.

    Si votre compte Git utilise l'authentification à deux facteurs ou si vous utilisez GitHub (qui nécessite un jeton d'accès personnel au lieu d'un mot de passe), vous pouvez accéder à votre fournisseur Git et créer des jetons d'accès à utiliser à la place des mots de passe. Consultez le post destiné à la communauté Configurer une connexion Git HTTPS avec l'authentification à deux facteurs activée pour obtenir des instructions sur la création de jetons d'accès personnels pour les fournisseurs Git courants.

  8. Si vous avez sélectionné Utiliser les attributs utilisateur pour le nom d'utilisateur et le mot de passe/jeton d'accès personnel, Looker affiche les menus déroulants Attribut d'utilisateur du nom d'utilisateur et Attribut utilisateur de jeton d'accès personnel dans la section Identifiants du mode Développement. Dans les menus déroulants, sélectionnez les attributs utilisateur correspondant aux identifiants Git d'un développeur individuel.

    (Les utilisateurs de Looker peuvent modifier les valeurs des champs d'attributs utilisateur sur leur page Compte, ou les administrateurs Looker peuvent modifier les valeurs d'attribut utilisateur pour un utilisateur sur la page d'administration Utilisateurs.)

  9. Sélectionnez le bouton Continue Setup (Poursuivre la configuration).

Git est maintenant configuré pour votre projet LookML. Vous pouvez alors valider votre code LookML, puis créer votre commit initial et le déployer en production pour rendre votre projet disponible en mode Production. Vous pouvez également :

Se connecter à Git à l'aide de SSH

Avec l'authentification SSH, vous créez une clé de déploiement pour votre fournisseur Git. Looker génère la paire de clés SSH et affiche la clé publique dans l'interface utilisateur, comme indiqué à l'étape 4. Looker utilise cette clé de déploiement pour se connecter à votre fournisseur Git et valider les modifications pour le compte des développeurs Looker. Looker effectue des commits à l'aide du nom d'utilisateur Looker d'un développeur afin que vous puissiez savoir quel développeur est à l'origine de chaque commit. Vous pouvez consulter l'historique des commits de votre projet sur l'interface de votre fournisseur Git ou en sélectionnant l'option Historique dans le menu Git de l'IDE Looker. Pour en savoir plus sur les menus Git dans Looker, consultez la section Exécuter des commandes Git dans Looker .

Pour configurer un projet LookML avec une authentification Git SSH, procédez comme suit:

  1. Ouvrez votre projet ou créez un projet LookML.
  2. Dans votre projet, sélectionnez l'icône Settings (Paramètres) dans le menu des icônes de gauche pour ouvrir la page Project Configuration (Configuration du projet).

  3. Sur la page Configuration du projet, effectuez l'une des actions suivantes pour ouvrir la page Configurer Git:

    • Pour un projet sans connexion Git, sélectionnez le bouton Configurer Git.
    • Pour un projet déjà configuré avec une connexion Git, sélectionnez le bouton Reset Git Connection (Réinitialiser la connexion Git).

    Si vous réinitialisez votre connexion Git, l'historique Git de la branche principale sera conservé. L'historique de la branche personnelle de chaque développeur Looker sera également conservé lors de l'extraction, de la fusion et du déploiement. Pour conserver l'historique de toutes les branches, consultez la page des bonnes pratiques Migrer vers un nouveau dépôt Git.

    Schéma illustrant la progression de la page "Paramètres du projet" à la page "Configurer Git" Les nouveaux projets sont dotés d'un bouton "Configurer Git" et les projets existants d'un bouton "Réinitialiser Git Connect". Toutefois, les deux boutons mènent à la page "Configurer Git".

  4. Obtenez l'URL SSH de votre dépôt Git. Voici les formats pour les fournisseurs Git courants:

    • GitHub: git@github.com:<organization-name>/<repository-name>.git
    • GitHub Enterprise: git@example.com:<organization-name>/<repository-name>.git
    • Cloud Source Repositories: ssh://username@example.com@source.developers.google.com:2022/p/<project-id>/r/<repository-name>
    • GitLab: git@gitlab.com:<organization-name>/<repository-name>.git
    • Bitbucket: git@bitbucket.org:<organization-name>/<repository-name>.git
    • Phabricateur: ssh://username@example.com/diffusion/MYCALLSIGN/<repository-name>.git

    Dans le cas de GitHub, pour les nouveaux dépôts (dépôts ne contenant pas encore de fichiers), GitHub affiche l'URL SSH dans l'onglet Code lors de la configuration initiale. Veillez à sélectionner le bouton SSH pour obtenir l'URL SSH, puis à sélectionner l'icône du presse-papiers pour la copier dans votre presse-papiers.

    Pour les dépôts GitHub existants (dépôts contenant déjà des fichiers), vous pouvez voir l'URL SSH en accédant à l'onglet Code du dépôt et en sélectionnant le bouton Code. Veillez à sélectionner le lien Utiliser SSH. Vous pouvez sélectionner l'icône du presse-papiers pour copier dans votre presse-papiers.

  5. Sur la page Configurer Git de Looker, collez l'URL SSH de votre dépôt Git dans le champ URL du dépôt, puis sélectionnez Continuer.

    Les URL comportant des ports Git personnalisés ou non standards peuvent être utilisées avec Looker en ajoutant le numéro de port non standard à l'URL Git. Par exemple : ssh://git@corporate.git.server.com:22/myorganization/myproject.git

    Vous devez inclure le ssh:// pour que cela fonctionne correctement.

  6. Looker détectera votre fournisseur Git et affichera une clé de déploiement pour votre dépôt. (Si Looker ne parvient pas à détecter votre fournisseur Git, il vous invitera à choisir dans un menu déroulant.) Copiez la clé de déploiement dans le presse-papiers, puis sélectionnez le lien Déployer les paramètres de la clé pour votre dépôt pour ouvrir la page GitHub Déployer des clés dans votre dépôt GitHub.

  7. Dans l'onglet Paramètres de GitHub, sur la page Déployer des clés, sélectionnez le bouton Ajouter une clé de déploiement:

    GitHub affiche la page Déployer des clés / Ajouter.

  8. Donnez un titre à la clé de déploiement. Le nom n'est pas important, mais vous pouvez inclure « Looker » et le titre de votre projet pour en garder une trace à l'avenir.

  9. Collez la clé de déploiement que vous avez copiée depuis Looker .

  10. Sélectionnez l'option Autoriser l'accès en écriture.

  11. Sélectionnez le bouton Ajouter une clé. (À ce stade, votre fournisseur Git peut vous inviter à saisir votre mot de passe. Si tel est le cas, saisissez votre mot de passe, puis sélectionnez Confirmer le mot de passe.)

  12. GitHub affiche toutes les clés de déploiement ajoutées pour votre dépôt.

  13. Revenez à la fenêtre Looker et, sur la page Configure Git (Configurer Git), sélectionnez Test and Finalize Setup (Tester et finaliser la configuration).

Vous pouvez alors réessayer de configurer la clé de déploiement ou sélectionner Skip Tests and Finalize Setup (Ignorer les tests et finaliser la configuration) pour conserver vos paramètres actuels.

Git est maintenant configuré pour votre projet LookML. Vous pouvez alors valider votre code LookML, puis créer votre commit initial et le déployer en production pour rendre votre projet disponible en mode Production. Vous pouvez également :

Configurer un dépôt Git simple

Si vous n'avez pas encore créé de dépôt Git distant, ou si vous souhaitez simplement bénéficier d'une configuration rapide afin que d'autres utilisateurs puissent bénéficier de votre LookML, vous pouvez configurer un dépôt Git nu. La configuration d'un dépôt Git nu permet de créer un dépôt Git local sur votre instance Looker, au lieu de vous connecter à un dépôt distant.

Lorsque vous sélectionnez l'option permettant de créer un dépôt nu, Looker crée le dépôt sur votre serveur Looker et lance l'historique Git du dépôt.

Pour configurer un projet LookML avec un dépôt Git simple:

  1. Ouvrez votre projet ou créez un projet LookML.
  2. Dans votre projet, sélectionnez l'icône Settings (Paramètres) dans le menu des icônes de gauche pour ouvrir la page Project Configuration (Configuration du projet).

  3. Sur la page Configuration du projet, effectuez l'une des actions suivantes pour ouvrir la page Configurer Git:

    • Pour un projet sans connexion Git, sélectionnez le bouton Configurer Git.
    • Pour un projet déjà configuré avec une connexion Git, sélectionnez le bouton Reset Git Connection (Réinitialiser la connexion Git).

    Si vous réinitialisez votre connexion Git, l'historique Git de la branche principale sera conservé. L'historique de la branche personnelle de chaque développeur Looker sera également conservé lors de l'extraction, de la fusion et du déploiement. Pour conserver l'historique de toutes les branches, consultez la page des bonnes pratiques Migrer vers un nouveau dépôt Git.

  4. Sélectionnez Set up a bare dépôt (Configurer un dépôt simple) au bas de la page Configure Git (Configurer Git).

  5. Dans la boîte de dialogue Configure Bare Git Repository (Configurer un dépôt Git Bare), sélectionnez Create Repository (Créer un dépôt).

    Une fois le dépôt Git créé, Looker affiche une boîte de dialogue Bare Repository Created (Dépôt Bare créé).

Git est maintenant configuré pour votre projet LookML. Vous pouvez alors valider votre code LookML, puis créer votre commit initial et le déployer en production pour rendre votre projet disponible en mode Production. Vous pouvez également :

Pour les projets configurés avec un dépôt nu, vous pouvez ensuite utiliser l'option Réinitialiser la connexion Git si vous souhaitez connecter le projet à un fournisseur Git (consultez les procédures d'utilisation des protocoles HTTPS ou SSH). Toutefois, ne vous connectez pas à un dépôt Git déjà associé à un historique Git. Si vous avez configuré votre projet LookML avec un dépôt nu, Looker crée un dépôt sur votre serveur Looker et lance l'historique Git du dépôt. Si, par la suite, vous connectez votre projet LookML à un dépôt Git ayant un historique Git, Looker ne pourra pas rapprocher les deux historiques Git et vous ne pourrez effectuer aucune action Git.

Connecter un nouveau projet LookML à un dépôt Git non vide

La configuration de Git pour le contrôle des versions est une étape clé de la création d'un projet LookML. En règle générale, chaque projet doit avoir son propre dépôt. Cependant, vous devrez peut-être configurer un projet avec un dépôt Git contenant du code LookML existant, comme dans les situations suivantes:

  • Lorsque vous déplacez un projet LookML existant entre des instances
  • Lorsque vous promenez du code à partir d'un projet LookML endommagé ou obsolète pour l'utiliser dans un nouveau projet

Cette section décrit les bonnes pratiques de configuration d'un nouveau projet LookML avec un dépôt Git existant non vide en vue de développements LookML ultérieurs.

  1. Créez un projet LookML en sélectionnant Projet vide comme point de départ. Un projet vide constitue le point de départ, car il sera renseigné avec les objets LookML d'un dépôt existant, et non à partir d'un schéma de base de données ou d'une requête SQL.
  2. Configurez Git pour votre projet en utilisant HTTPS ou SSH, en utilisant l'URL du projet non vide dans la section URL du dépôt de la page Configurer Git.
  3. Une fois que vous avez configuré Git pour votre projet, extrayez les données de l'environnement de production à partir du panneau Actions Git.
  4. Une fois vos données extraites de la version de production, sélectionnez Deploy to Production (Déployer en production).

Les modifications que vous apportez au LookML dans votre projet n'affectent pas le référentiel d'origine ; elles sont enregistrées dans votre version locale du référentiel.

Si vous souhaitez utiliser un dépôt public spécifique comme base d'un projet LookML vide, mais que vous ne disposez pas d'un accès en écriture à ce dépôt, suivez les instructions décrites dans la section Cloner un dépôt Git public de la page de documentation Créer un projet LookML.

Si vous configurez un workflow Git à l'aide d'un dépôt sur plusieurs instances, consultez le post de la communauté sur le workflow Git avec un seul dépôt sur plusieurs instances (développement, préproduction et production) pour en savoir plus.

Tester votre connexion Git

Looker propose un test de connexion Git pour vérifier votre connexion Git. Le test de connexion Git permet de vérifier que l'URL Git est correcte et que Looker peut accéder à l'hôte Git . Le test de connexion Git permet également de vérifier que vous avez fourni une clé de déploiement Git valide et que cette clé dispose d'un accès en écriture à votre dépôt Git.

Si Looker ne parvient pas à se connecter à votre dépôt Git, le bouton Git affichera le texte Tester la connexion Git pour vous inviter à résoudre les problèmes de connexion.

Vous pouvez également accéder à l'outil de test de connexion Git en sélectionnant Tester la connexion Git dans le panneau Actions Git:

L'outil de test de connexion Git affiche ensuite les étapes suivies pour tester la connexion Git:

  1. Examiner le dépôt git distant
  2. Le nom d'hôte du service Git sera résolu
  3. La mise en réseau vers le service Git est opérationnelle
  4. Vérifier les identifiants d'autorisation
  5. Vérifier que les identifiants autorisent l'accès en écriture

Si une étape réussit, Looker affiche une coche verte à gauche de l'étape. Si une étape échoue, Looker affiche une coche rouge à gauche de l'étape et affiche également un message d'erreur.

L'exemple suivant montre un test réussi:

Boîte de dialogue &quot;Test de connexion Git&quot; affichant une liste d&#39;étapes avec des coches vertes pour indiquer que toutes les étapes ont réussi.

Dans l'exemple suivant, aucune clé de déploiement n'est configurée pour la connexion Looker dans le dépôt Git. Les coches vertes à gauche des trois premières étapes indiquent que ces étapes ont réussi:

  • Examine git remote
  • Host name for git service will resolve
  • Networking to the git service is operational

Les coches rouges à gauche des deux dernières étapes indiquent que ces étapes ont échoué:

  • Verify authorization credentials
  • Ensure credentials allow write access

Boîte de dialogue &quot;Test de connexion Git&quot; affichant la liste des étapes qui ont réussi et échoué. Une erreur sous l&#39;étape Vérifier les identifiants d&#39;autorisation indique &quot;Impossible d&#39;authentifier l&#39;accès à distance (clé de déploiement Looker).&quot;