Notez que vous consultez actuellement la documentation de Looker. Pour accéder à la documentation sur Looker Studio, consultez la page https://support.google.com/looker-studio.

Cette page a été traduite par l'API Cloud Translation.

Configurer et tester une connexion Git

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

La configuration d'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 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égrer 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. La procédure générale est la même, quelle que soit la plate-forme utilisée. 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 de 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 (protocole de transfert hypertexte sécurisé). Avec HTTPS, Looker accède à votre dépôt Git avec un nom d'utilisateur et un mot de passe (ou un jeton d'accès) que vous fournissez, comme décrit dans la section Se connecter à Git avec 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 une authentification HTTPS, Looker se connecte à votre fournisseur Git avec un ou plusieurs comptes utilisateur que vous avez configurés avec 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 une 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 2FA pour découvrir comment créer des jetons d'accès personnels pour les principaux fournisseurs Git.

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 vous pouvez configurer le projet pour 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 sur 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 l'article de blog GitHub. Pour associer un projet Looker à GitHub à l'aide du protocole HTTPS, utilisez les paramètres du développeur dans 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 associer 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 unique à compte

Si vous configurez votre projet LookML avec un seul compte Git, Looker utilise ce compte pour se connecter à votre fournisseur Git afin de 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 d'identifier le développeur qui a effectué 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. Consultez la section Exécuter des commandes Git dans Looker pour en savoir plus sur les menus 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 pour plusieurs comptes 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 et au mot de passe Git (ou un jeton d'accès si les comptes utilisateur Git disposent d'une authentification à deux facteurs).
Les attributs utilisateur pour les mots de passe de compte 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, puis 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, sur laquelle un administrateur Looker a configuré les 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 affichant les attributs utilisateur de type chaîne "github_token" et "github_username".

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

Configurer l'authentification Git HTTPS

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

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 encore aucun fichier), GitHub affiche l'URL lors de la configuration initiale. Veillez à sélectionner le bouton HTTPS dans l'onglet Code afin d'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 (c'est-à-dire ceux qui contiennent déjà des fichiers), vous pouvez afficher 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 le presse-papiers.
Accédez à votre projet LookML, puis sélectionnez l'icône Settings (Paramètres) dans la barre de navigation.
Sur la page Project Configuration (Configuration du projet), dans l'onglet Configuration, accédez au bouton Configure Git (Configurer Git) (pour les nouveaux projets) ou au bouton Reset Git Connection (Réinitialiser la connexion Git) (pour les projets existants qui ont déjà été connectés à Git).
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).

La réinitialisation de votre connexion Git préserve l'historique Git pour la branche principale. L'historique de la branche personnelle de chaque développeur Looker sera également conservé après l'extraction, la fusion et le déploiement. Pour conserver l'historique de toutes les branches, consultez la page des bonnes pratiques Migrer vers un nouveau dépôt Git.
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 concernant votre dépôt Git.

Si Looker ne détecte pas votre fournisseur Git, vous serez invité à choisir une option dans une liste déroulante.
Sélectionnez votre option de connexion Git:
- Utilisez une combinaison unique et constante de nom d'utilisateur et de mot de passe/jeton (voir Authentification HTTPS unique à un compte).
- Utilisez des attributs utilisateur pour le nom d'utilisateur et le mot de passe/jeton (voir Authentification HTTPS via les attributs utilisateur).
Dans les champs Username (Nom d'utilisateur) et Password (Mot de passe)/Personal Access Token (Jeton d'accès personnel), saisissez les identifiants que votre projet LookML utilisera pour accéder à Git. Cette étape est obligatoire quel que soit le paramètre de connexion Git:
- Si vous avez sélectionné Utiliser une combinaison nom d'utilisateur unique et constant et mot de passe/jeton d'accès personnel, il s'agit du nom d'utilisateur et du mot de passe Git (ou du jeton d'accès) 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/le jeton d'accès personnel, il s'agit du nom d'utilisateur et du mot de passe Git (ou du 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 une authentification à deux facteurs ou 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 pour découvrir comment créer des jetons d'accès personnels pour les principaux fournisseurs Git.
Si vous avez sélectionné Utiliser les attributs utilisateur pour le nom d'utilisateur et le mot de passe/le jeton d'accès personnel, Looker affiche les menus déroulants Attribut utilisateur du nom d'utilisateur et Attribut utilisateur pour le jeton d'accès personnel dans la section Identifiants en mode Développement. Utilisez les menus déroulants pour sélectionner les attributs utilisateur correspondant aux identifiants Git d'un développeur.

(Les utilisateurs de Looker peuvent modifier les valeurs de leurs champs d'attributs utilisateur sur leur page Compte, ou les administrateurs Looker peuvent modifier les valeurs des attributs utilisateur d'un utilisateur sur la page d'administration Utilisateurs.)
Sélectionnez le bouton Poursuivre la configuration.

Git est maintenant configuré pour votre projet LookML. À partir de là, vous pouvez valider votre code LookML, puis créer votre premier commit et le déployer en production pour rendre votre projet disponible en mode Production. Vous pouvez également :

Utilisez le menu Git pour accéder aux commandes Git.
Utilisez le menu Git pour tester votre connexion Git.
Si vous êtes administrateur Looker, accédez à la page Paramètres du projet pour exiger la validation LookML et configurer les options d'intégration Git.

Se connecter à Git via 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 les commits en utilisant le nom d'utilisateur Looker du développeur, ce qui vous permet de savoir qui a effectué 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. Consultez la section Exécuter des commandes Git dans Looker pour en savoir plus sur les menus Git dans Looker.

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

Ouvrez votre projet ou créez un projet LookML.
Dans votre projet, sélectionnez l'icône Settings (Paramètres) dans le menu des icônes situé sur la gauche pour ouvrir la page Project Configuration (Configuration du projet).
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.
La réinitialisation de votre connexion Git préserve l'historique Git pour la branche principale. L'historique de la branche personnelle de chaque développeur Looker sera également conservé après l'extraction, la fusion et le déploiement. Pour conserver l'historique de toutes les branches, consultez la page des bonnes pratiques Migrer vers un nouveau dépôt Git.
Obtenez l'URL SSH de votre dépôt Git. Voici les formats des principaux fournisseurs Git:
- 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 qui ne contiennent pas encore de fichiers), GitHub affiche l'URL SSH dans l'onglet Code lors de la configuration initiale. Veillez à sélectionner le bouton SSH afin d'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 (c'est-à-dire ceux 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 Use SSH (Utiliser SSH). Vous pouvez sélectionner l'icône du presse-papiers pour copier dans le presse-papiers.
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.

Vous pouvez utiliser des URL avec des ports Git personnalisés ou non standards 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.
Looker détecte votre fournisseur Git et affiche une clé de déploiement pour votre dépôt. (Si Looker ne détecte pas votre fournisseur Git, vous serez invité à le sélectionner dans une liste déroulante.) Copiez la clé de déploiement dans votre presse-papiers, puis sélectionnez le lien Deploy Key settings for your repository (Paramètres de déploiement de la clé pour votre dépôt) pour ouvrir la page GitHub Deploy keys (Déployer les clés) pour votre dépôt GitHub.
Dans l'onglet Paramètres de GitHub, sur la page Déployer les clés, sélectionnez le bouton Ajouter une clé de déploiement:

GitHub affiche la page Déployer des clés / Ajouter.
Ajoutez un titre à la clé de déploiement. Le nom n'a pas d'importance, mais vous pouvez inclure « Looker » et le titre de votre projet pour en garder une trace à l'avenir.
Collez la clé de déploiement que vous avez copiée depuis Looker .
Sélectionnez l'option Autoriser l'accès en écriture.

Remarque :Il s'agit d'une étape importante, car Looker a besoin de ce paramètre pour apporter des modifications à votre modèle LookML et les déployer.
Sélectionnez le bouton Ajouter une clé. (À ce stade, votre fournisseur Git peut vous demander de saisir votre mot de passe. Dans ce cas, saisissez votre mot de passe, puis sélectionnez Confirmer le mot de passe.)
GitHub affiche toutes les clés de déploiement qui ont été ajoutées pour votre dépôt.
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.

Utilisez le menu Git pour accéder aux commandes Git.
Utilisez le menu Git pour tester votre connexion Git.
Si vous êtes administrateur Looker, accédez à la page Paramètres du projet pour exiger la validation LookML et configurer les options d'intégration Git.

Configurer un dépôt Git simple

Si vous n'avez pas encore créé de dépôt Git distant, ou si vous souhaitez vous lancer rapidement afin que d'autres utilisateurs puissent profiter de votre code LookML, vous pouvez configurer un dépôt Git simple. La configuration d'un dépôt Git simple crée 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 simple, Looker crée le dépôt sur votre serveur Looker et lance l'historique Git pour le dépôt.

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

Ouvrez votre projet ou créez un projet LookML.
Dans votre projet, sélectionnez l'icône Settings (Paramètres) dans le menu des icônes situé sur la gauche pour ouvrir la page Project Configuration (Configuration du projet).
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.
La réinitialisation de votre connexion Git préserve l'historique Git pour la branche principale. L'historique de la branche personnelle de chaque développeur Looker sera également conservé après l'extraction, la fusion et le déploiement. Pour conserver l'historique de toutes les branches, consultez la page des bonnes pratiques Migrer vers un nouveau dépôt Git.
Sélectionnez Configurer un dépôt simple à la place au bas de la page Configurer Git, située au-dessus du bouton Continuer.
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éé).

Utilisez le menu Git pour accéder aux commandes Git.
Utilisez le menu Git pour tester votre connexion Git.
Si vous êtes administrateur Looker, accédez à la page Paramètres du projet pour exiger la validation LookML et configurer les options d'intégration Git.

Pour les projets configurés avec un dépôt simple, vous pouvez ensuite utiliser l'option Reset Git Connection (Réinitialiser la connexion Git) si vous souhaitez connecter le projet à un fournisseur Git (consultez les procédures pour utiliser HTTPS ou 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 simple, Looker crée un dépôt sur votre serveur Looker et lance l'historique Git pour le dépôt. Si vous connectez ensuite votre projet LookML à un dépôt Git doté d'un historique Git, Looker ne pourra pas rapprocher les deux historiques Git ni effectuer d'actions 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 essentielle 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 qui contient du code LookML existant, comme dans les situations suivantes:

Lorsque vous déplacez un projet LookML existant entre des instances
Lorsque vous ressuscitez le code d'un projet LookML défectueux ou obsolète afin de l'utiliser dans 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 pour faciliter le développement LookML.

Créez un projet LookML en sélectionnant Blank Project (Projet vide) comme point de départ. Un projet vide constitue le point de départ, car il sera renseigné avec des objets LookML provenant d'un dépôt existant, et non d'un schéma de base de données ou d'une requête SQL.
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.
Une fois que vous avez configuré Git pour votre projet, extrayez l'environnement de production du panneau Actions Git.
Une fois l'opération terminée, sélectionnez Déployer en production.

Les modifications que vous apportez au code 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 de 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 destiné à la communauté sur le workflow Git avec un 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 vérifie que vous avez configuré l'URL Git correcte et que l'hôte Git est accessible par Looker . 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 affiche le texte Test Git Connection (Tester la connexion Git) pour vous inviter à résoudre votre problème de connexion.

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

L'outil de test de connexion Git affiche ensuite la procédure à suivre pour tester la connexion Git:

Examiner git distant
Le nom d'hôte du service git sera résolu
La mise en réseau avec le service git est opérationnelle
Valider les identifiants d'autorisation
Vérifier que les identifiants autorisent l'accès en écriture

Si une étape aboutit, 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 "Test de connexion Git" affichant une liste d'étapes avec des coches vertes à côté d'elles 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 "Test de connexion Git" affichant la liste des étapes ayant réussi et échoué Une erreur sous l'étape Vérifier les identifiants d'autorisation indique Impossible de s'authentifier à distance (clé de déploiement Looker).