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. Lorsque 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égrer 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 à l'aide d'un nom d'utilisateur et d'un mot de passe (ou d'un 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 sur le site Web de votre fournisseur Git, comme décrit dans la section Se connecter à Git à l'aide de SSH.
Se connecter à Git à l'aide de 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 au nom 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 de la communauté Configurer une connexion HTTPS Git avec l'authentification A2F activée pour savoir comment créer des 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 avec 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 à l'aide du nom d'utilisateur Looker du 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 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 n'ont pas besoin de disposer de leur propre compte utilisateur Git.
Authentification HTTPS multicompte avec des 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 au jeton d'accès si les comptes utilisateur Git sont associés à 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 mot de passe ou 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 domaine.
- 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.
L'exemple suivant montre la page Compte d'un utilisateur Looker dans laquelle il a saisi ses identifiants Git dans les champs d'attribut utilisateur.
Configurer l'authentification Git HTTPS
Pour configurer un projet LookML avec authentification HTTPS Git, 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 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 votre presse-papiers.
Pour les dépôts GitHub existants (dépôts 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 Paramètres dans la barre de navigation.
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).
Sélectionnez le bouton Configurer Git ou Réinitialiser la connexion Git pour ouvrir la page Configurer Git.
Réinitialiser votre connexion Git permet de conserver l'historique Git pour la branche principale. 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.
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étecte votre fournisseur Git et met à jour la fenêtre avec des informations sur votre dépôt Git.
Si Looker ne parvient pas à détecter votre fournisseur Git, il vous demandera de choisir dans une liste déroulante.
Sélectionnez votre option de connexion Git:
- Utilisez une combinaison unique et constante de nom d'utilisateur, de mot de passe et de jeton (voir Authentification HTTPS pour un seul compte).
- Utiliser des attributs utilisateur pour le nom d'utilisateur et le mot de passe/jeton (voir Authentification HTTPS par attribut utilisateur).
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 opération est obligatoire, quel que soit le 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/le jeton d'accès personnel, 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 extraire la version de production du dépôt. Ce compte utilisateur Git doit disposer au moins 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 savoir comment créer des jetons d'accès personnels pour les fournisseurs Git courants.
Si vous avez sélectionné Utiliser des 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 du jeton d'accès personnel dans la section Identifiants en mode développement. Utilisez les menus déroulants pour sélectionner les attributs utilisateur des identifiants Git d'un développeur individuel.
(Les utilisateurs Looker peuvent modifier les valeurs des champs d'attributs utilisateur sur leur page Compte, tandis que les administrateurs Looker peuvent modifier les valeurs des attributs utilisateur d'un utilisateur sur la page Utilisateurs de l'administrateur.)
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 :
- 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 aux paramètres du projet pour exiger la validation LookML et configurer les options d'intégration Git.
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 Exécuter des commandes Git dans Looker .
Pour configurer un projet LookML avec une authentification SSH Git, procédez comme suit:
- Ouvrez votre projet ou créez un projet LookML.
- 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.
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.
Réinitialiser votre connexion Git permet de conserver l'historique Git pour la branche principale. 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.
Obtenez l'URL SSH de votre dépôt Git. Voici les formats des 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 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 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 le copier dans votre presse-papiers.
- GitHub:
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.gitVous 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 parvient pas à détecter votre fournisseur Git, il vous invite à choisir dans une liste déroulante.) Copiez la clé de déploiement dans le presse-papiers, puis sélectionnez le lien Deploy Key settings for your repository (Paramètres de la clé de déploiement pour votre dépôt) pour ouvrir la page Deploy keys (Clés de déploiement) de votre dépôt GitHub.
Dans l'onglet Settings (Paramètres) de GitHub, sur la page Deploy keys (Clés de déploiement), sélectionnez le bouton Add deploy key (Ajouter une clé de déploiement) :
GitHub affiche la page Clés de déploiement / Ajouter.
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 le retrouver plus tard.
Collez la clé de déploiement que vous avez copiée depuis Looker .
Sélectionnez l'option Autoriser l'accès en écriture.
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.)
GitHub affiche toutes les clés de déploiement qui ont été ajoutées à votre dépôt.
Revenez à la fenêtre Looker, puis sur la page Configurer Git, sélectionnez 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 :
- 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 aux paramètres du projet pour exiger la validation LookML et configurer les options d'intégration Git.
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 configurer rapidement votre LookML pour que d'autres puissent en profiter, 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 de création d'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.
Lorsque vous créez un projet lors du processus de génération d'un modèle, il est automatiquement configuré avec un dépôt nu.
Pour configurer un projet LookML avec un dépôt Git nu:
- Ouvrez votre projet ou créez un projet LookML.
- 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.
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.
Réinitialiser votre connexion Git permet de conserver l'historique Git pour la branche principale. 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.
Sélectionnez Configurer un dépôt nu à la place en bas de la page Configurer Git.
Dans la boîte de dialogue Configurer un dépôt Git nu, sélectionnez 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 :
- 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 aux 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 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 démarre l'historique Git pour le dépôt. Si vous associez ensuite votre projet LookML à un dépôt Git disposant d'un historique Git, Looker ne pourra pas réconcilier 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 disposer de 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.
- Créez un projet LookML en sélectionnant Blank Project (Projet vide) comme point de départ. Un projet vide est le point de départ, car il sera renseigné avec des objets LookML à partir d'un dépôt existant, plutôt que d'un schéma de base de données ou d'une requête SQL.
- 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.
- Une fois que vous avez configuré Git pour votre projet, extrayez-le à partir de la production dans le panneau Actions Git.
- Une fois la version de production extraite, sélectionnez Deploy to Production (Déployer en production).
Les modifications que vous apportez au LookML de votre projet n'affecteront pas le dépôt d'origine. Elles 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 à l'aide d'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é la bonne URL Git et que l'hôte Git est accessible par Looker . 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 qu'il suit pour tester la connexion Git:
- Examiner le dépôt distant git
- Le nom d'hôte du service Git sera résolu.
- La mise en réseau avec le service Git est opérationnelle.
- Vérifier 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 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:
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 remoteHost name for git service will resolveNetworking to the git service is operational
Les coches rouges à gauche des deux dernières étapes indiquent qu'elles ont échoué:
Verify authorization credentialsEnsure credentials allow write access
