Configurer et tester une connexion Git

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

Configurer une connexion Git pour votre projet vous permet de déployer votre code LookML en mode Production, ce qui permet aux autres utilisateurs d'explorer votre modèle de données, de créer des tableaux de bord et d'ajouter du code LookML à votre modèle. Pour une configuration plus rapide, utilisez un dépôt nu. 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 de 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 qui utilise une clé SSH ou HTTPS pour l'authentification. La procédure générale est la même, quelle que soit la plate-forme 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, vous devez activer le mode Développement.

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

  • HTTPS : 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 via 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 pour qu'il utilise un seul compte Git pour l'ensemble du projet, ou pour qu'il utilise les comptes Git individuels de vos développeurs pour effectuer leurs opérations Git.

Notez les points suivants concernant l'authentification HTTPS GitHub :

  • GitHub n'accepte pas les mots de passe de compte pour authentifier les opérations Git sur github.com. Pour en savoir plus, consultez le post de blog de GitHub. Pour connecter un projet Looker à GitHub à l'aide d'HTTPS, utilisez les paramètres de développement de GitHub pour créer un jeton d'accès personnel.
  • Looker n'est pas compatible avec les jetons d'accès personnels précis de GitHub. Pour connecter votre projet Looker à GitHub à l'aide de 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 utilise ce compte Git pour se connecter à votre fournisseur Git et valider les modifications au nom 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 dans l'interface de votre fournisseur Git ou en sélectionnant l'option History (Historique) dans le menu Git de l'IDE Looker. Pour en savoir plus sur les menus Git dans Looker, consultez Exécuter des commandes Git dans Looker.

Pour l'authentification HTTPS à un seul compte, 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, il utilisera le compte Git individuel de chaque développeur Looker pour effectuer des 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 disposer de 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 (ou jetons d'accès) des comptes Git 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 Attributs utilisateur, où un administrateur Looker a configuré des attributs utilisateur pour le nom d'utilisateur Git et le jeton d'accès de l'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 authentification HTTPS Git, 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 Paramètres dans la barre de navigation.

  3. Sur la page Configuration du projet, dans l'onglet Configuration, cliquez sur le bouton Configurer Git (pour les nouveaux projets) ou sur le bouton 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).

    Réinitialiser votre connexion Git permet de conserver l'historique Git pour la branche principale. 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 préserver l'historique de toutes les branches, consultez la page des bonnes pratiques sur la migration 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 invite à choisir dans une liste déroulante.

  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 un seul nom d'utilisateur et mot de passe/jeton d'accès personnel constants, il s'agit du nom d'utilisateur et du mot de passe (ou du 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 (ou jeton d'accès) Git 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 de la communauté Configurer une connexion git HTTPS avec l'authentification A2F activée pour obtenir des instructions sur la création de jetons d'accès personnel 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. Utilisez les menus déroulants pour sélectionner les attributs utilisateur des 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 (Continuer la configuration).

Git est maintenant configuré pour votre projet LookML. Vous pouvez ensuite 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 au nom des développeurs Looker. Looker effectue des commits à l'aide du nom d'utilisateur Looker d'un développeur afin que vous puissiez identifier le développeur à l'origine de chaque commit. Vous pouvez consulter l'historique des commits de votre projet dans l'interface de votre fournisseur Git ou en sélectionnant l'option History (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 SSH Git, procédez comme suit :

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

  3. Sur la page Project Configuration (Configuration du projet), effectuez l'une des actions suivantes pour ouvrir la page Configure Git (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 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 préserver l'historique de toutes les branches, consultez la page des bonnes pratiques sur la migration 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
    • Phabricator : 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électionnez l'icône du presse-papiers pour la copier dans votre presse-papiers.

    Pour les dépôts GitHub existants (dépôts qui contiennent déjà des fichiers), vous pouvez afficher 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 ssh:// pour que cela fonctionne correctement.

  6. Looker détecte votre fournisseur Git et affiche 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 Deploy keys/Add new (Clés de déploiement/Ajouter).

  8. Ajoutez 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 c'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 Ignorer les tests et finaliser la configuration pour conserver vos paramètres actuels.

Git est maintenant configuré pour votre projet LookML. Vous pouvez ensuite 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 nu

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. Configurer un dépôt Git nu crée un dépôt Git local sur votre instance Looker, plutôt que de se 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 Project Configuration (Configuration du projet), effectuez l'une des actions suivantes pour ouvrir la page Configure Git (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 Réinitialiser la connexion Git.

    Si vous réinitialisez votre connexion Git, l'historique Git de la branche principale sera conservé. Il préservera également l'historique de la branche personnelle de chaque développeur Looker une fois qu'il aura extrait, fusionné et déployé. Pour préserver l'historique de toutes les branches, consultez la page des bonnes pratiques sur la migration 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 la boîte de dialogue Bare Repository Created (Dépôt nu créé).

Git est maintenant configuré pour votre projet LookML. Vous pouvez ensuite 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 (voir les procédures d'utilisation de HTTPS ou de SSH). Toutefois, ne vous connectez pas à un dépôt Git qui dispose déjà d'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. Toutefois, vous devrez peut-être configurer un projet avec un dépôt Git contenant du code LookML existant, par exemple dans les situations suivantes :

  • Lorsque vous déplacez un projet LookML existant entre des instances
  • Lorsque vous réutilisez le code d'un projet LookML défectueux ou obsolète pour un nouveau projet

Cette section décrit les bonnes pratiques à suivre pour configurer un nouveau projet LookML avec un dépôt Git existant et non vide afin de poursuivre le développement LookML.

  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 à l'aide de HTTPS ou de 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 l'environnement de production, sélectionnez Deploy to Production (Déployer en production).

Les modifications que vous apportez au code LookML de votre projet n'affectent pas le référentiel d'origine. Au lieu de cela, les modifications seront enregistrées dans votre version locale du dépôt.

Si vous souhaitez utiliser un dépôt public spécifique comme base d'un projet LookML vierge, mais que vous n'avez pas d'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 fournit un test de connexion Git pour vérifier votre connexion Git. Le test de connexion Git permet de vérifier que l'URL Git indiquée est correcte et que Looker peut accéder à l'hôte Git . Le test de connexion Git vérifie également 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 affiche le texte Test Git Connection (Tester la connexion Git) pour vous inviter à résoudre le problème 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 du 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 aboutit, Looker affiche une coche verte à gauche de celle-ci. Si une étape échoue, Looker affiche une coche rouge à gauche de l'étape et 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 à côté pour indiquer que toutes les étapes ont été effectuées.

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 qu'elles 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 réussies et échouées. Une erreur s&#39;affiche sous l&#39;étape &quot;Valider les identifiants d&#39;autorisation&quot; : &quot;Impossible d&#39;AUTHENTIFIER à distance (clé de déploiement Looker)&quot;.