Un point de terminaison de déploiement de webhook invite votre instance Looker à déployer les modifications apportées à une branche Git, à un SHA de commit ou à un nom de tag, puis à transférer les modifications vers la version de production de votre projet. (Consultez la section Déployer avec des webhooks pour connaître les formats de webhook de déploiement Looker.) Pour la plupart des projets, Looker gère les intégrations Git et déploie les mises à jour en production. Vous n'avez donc pas besoin de configurer de webhook de déploiement.
Toutefois, vous devez utiliser un webhook de déploiement pour transférer les modifications en production si l'une des conditions suivantes s'applique :
- Vous transférez les mises à jour vers la branche de production distante en dehors de l'IDE Looker, ce qui est courant dans les workflows de développement avec des environnements de staging.
- Vous souhaitez utiliser un webhook pour effectuer un déploiement avec le mode de déploiement avancé, qui vous permet de spécifier la branche, le SHA du commit ou le nom du tag utilisés pour la version de production de votre projet Looker.
- Vous avez configuré votre projet Looker avec des demandes d'extraction Git. Cela signifie que vous devez déclencher un webhook de déploiement une fois que vous avez fusionné une demande d'extraction'extraction afin de transférer ces modifications vers votre environnement de production Looker. La plupart des services d'hébergement Git permettent d'automatiser ce processus si vous ajoutez le webhook à l'interface de votre fournisseur Git.
Si vous êtes administrateur Looker, vous pouvez configurer le webhook de déploiement pour qu'il nécessite un secret. Ainsi, seules les parties autorisées pourront le déclencher. Les développeurs Looker qui ne sont pas administrateurs peuvent consulter la page Configuration du projet, mais ne peuvent pas modifier les options qui s'y trouvent.
Ajouter un secret de déploiement
Looker est compatible avec les secrets Web pour les fournisseurs Git suivants : GitHub, Bitbucket Server et GitLab.
Pour définir un secret de déploiement de webhook dans votre projet :
- En mode Développement, ouvrez votre projet et sélectionnez l'icône Paramètres dans la barre de navigation de l'IDE pour ouvrir le panneau des paramètres du projet.
- Sélectionnez Configuration dans le panneau des paramètres du projet.
- Faites défiler la page jusqu'à la section Webhook Deploy Secret (Secret de déploiement du webhook), puis cliquez sur Set Webhook Secret (Définir le secret du webhook). Looker génère automatiquement un jeton secret. Vous pouvez utiliser ce secret généré automatiquement ou saisir votre propre jeton secret.
- Que vous utilisiez le secret généré automatiquement ou que vous créiez votre propre secret, copiez le secret de déploiement du webhook et collez-le dans un fichier texte. Vous l'aurez ainsi à portée de main si vous devez ajouter le secret au webhook de votre dépôt. Veillez à le copier à ce moment-là. Une fois que vous quittez ou actualisez la page Configuration du projet, vous perdez l'accès au secret de déploiement du webhook. Vous devrez alors modifier ou supprimer le secret de déploiement du webhook pour récupérer l'accès à votre projet.
- Cliquez sur Enregistrer la configuration du projet.
Le webhook de déploiement de votre projet nécessite désormais ce secret. Pour les projets qui utilisent une instance Looker intermédiaire, vous devez inclure le secret de déploiement du webhook dans votre en-tête HTTP afin de déployer en production. Pour les projets avec intégration des demande d'extraction Git, vous devez accéder à l'interface de votre fournisseur Git pour ajouter le secret au webhook de votre dépôt.
Configurer le secret pour le webhook de votre dépôt Git
Pour les projets avec intégration des demande d'extraction Git, si vous avez ajouté un secret de webhook de déploiement à votre projet LookML, vous devez accéder à l'interface de votre fournisseur Git pour ajouter le secret au webhook de votre dépôt. Voici un exemple d'utilisation de GitHub :
Accédez aux paramètres du dépôt de votre projet sur le site Web de votre fournisseur Git.
CONSEIL : Si vous avez configuré votre projet pour l'intégration Git, vous pouvez utiliser l'option Afficher le projet sur Git dans le menu Git de votre projet dans Looker.
Dans les paramètres de votre dépôt, cliquez sur Webhooks.
Recherchez le webhook de votre projet LookML, puis cliquez sur le bouton Modifier.
Dans le champ Secret, collez le secret de déploiement du webhook que vous avez copié dans la section Webhook Deploy Secret (Secret de déploiement du webhook) de Looker.
Cliquez sur Mettre à jour le Webhook.
Le secret du webhook est désormais obligatoire pour déployer les modifications apportées à la version de production de votre projet. Si nécessaire, vous pouvez modifier le secret ou le supprimer de votre projet.
Modifier un secret de déploiement
Une fois qu'un secret de déploiement de webhook a été ajouté à votre projet, si vous êtes un administrateur Looker, vous pouvez le modifier en procédant comme suit :
- Dans votre projet, sélectionnez l'icône Paramètres dans la barre de navigation.
- Faites défiler la page jusqu'à la section Code secret de déploiement du webhook, puis cliquez sur Réinitialiser le code secret. Looker générera automatiquement un nouveau jeton secret. Vous pouvez utiliser ce secret généré automatiquement ou saisir votre propre jeton secret.
- Que vous utilisiez le secret généré automatiquement ou que vous créiez votre propre secret, copiez le secret de déploiement du webhook et collez-le dans un fichier texte. Vous l'aurez ainsi à portée de main si vous devez ajouter le secret au webhook de votre dépôt. Veillez à le copier depuis votre presse-papiers à ce moment-là. Une fois que vous quittez ou actualisez la page Configuration du projet, vous perdez l'accès au secret de déploiement du webhook. Vous devrez alors revenir en arrière et le modifier ou le supprimer complètement.
- Cliquez sur Enregistrer la configuration du projet.
Si votre projet est configuré avec l'intégration des demande d'extraction Git, vous devez également accéder à l'interface de votre fournisseur Git pour mettre à jour le secret du webhook pour votre dépôt.
Supprimer un secret de déploiement
Une fois qu'un secret de déploiement de webhook a été ajouté à votre projet, si vous êtes un administrateur Looker, vous pouvez le supprimer en procédant comme suit :
- Dans votre projet, sélectionnez l'icône Paramètres dans la barre de navigation.
- Faites défiler la page jusqu'à la section Webhook Deploy Secret (Secret de déploiement du webhook), puis cliquez sur Remove Secret (Supprimer le secret). À ce stade, vous pouvez annuler l'opération et conserver le secret de déploiement en cliquant sur Ne pas supprimer.
- Pour supprimer définitivement le secret de déploiement du webhook de votre projet, cliquez sur Enregistrer la configuration du projet.
Votre projet ne nécessite plus de code secret pour le webhook de déploiement. Si votre projet est configuré avec l'intégration des demande d'extraction Git, vous pouvez maintenant accéder à l'interface de votre fournisseur Git pour supprimer le secret du webhook de votre dépôt. Looker lui-même ne recherchera plus de secret côté fournisseur Git. Par conséquent, il n'y a pas de problème si un secret est toujours configuré pour le webhook de votre dépôt Git. Si vous souhaitez supprimer le secret de votre dépôt Git, consultez Configurer le secret pour le webhook de votre dépôt Git pour savoir comment le modifier dans l'interface d'un fournisseur Git.