GitHubPour le déclencheur Web du référentiel

Les déclencheurs web du dépôt GitHub sont utilisés pour surveiller un dépôt au sein d\'une organisation GitHub pour des événements. Une fois que l\'événement se produit dans le dépôt, le déclencheur est activé et lance le flux de travail automatisé.

Mappez votre déclencheur à un référentiel au sein d\'une organisation GitHub et configurez le déclencheur pour exécuter l\'automatisation lorsque des événements se produisent dans le référentiel.

Le déclencheur web du dépôt GitHub prend en charge les événements suivants dans un dépôt :
  • Créer
  • Dupliquer
  • Commentaire sur le problème
  • Problèmes
  • Étiquette
  • Demande de tirage
  • Examen de la demande de tirage
  • Pousser
  • Favori
  • Regarder

Par exemple, créez un déclencheur web de dépôt GitHub pour surveiller un dépôt au sein d\'une organisation GitHub pour une demande de tirage. Lorsqu\'une demande de tirage est effectuée dans le dépôt surveillé, le déclencheur est activé et les actions suivantes dans l\'automatisation sont lancées.

Prérequis

  • Vous devez disposer d\'une licence Bot Creator ou Développeur citoyen.
  • Vous devez disposer de l\'autorisation Afficher mes robots.
  • Vous devez disposer de toutes les autorisations EVENT TRIGGERS pour le rôle.
  • Vous devez disposer des autorisations Archiver et Extraire sur les dossiers où se trouve l\'automatisation.
  • Vous devez être connecté à votre Control Room.
  • Les déclencheurs web GitHub utilisent Personal Access Token pour authentifier l\'identité du profil utilisateur. Le déclencheur web GitHub prend en charge les jetons d\'accès classiques et à granularité fine. Assurez-vous de générer un jeton d\'accès personnel dans les paramètres GitHub utilisateur et de le stocker dans le Credential Vault. Pour plus d\'informations sur la création et la gestion du Personal Access Token, consultez la section Gestion de vos jetons d\'accès personnel.

Procédure

  1. Dans le volet de gauche, cliquez sur Automatisation.
  2. Cliquez Créer > Bot de tâche.
    L\'assistant Create Task Bot est affiché.
  3. Saisissez un nom approprié pour le robot dans le champ Nom.
    Tous les robots sont stockés dans le dossier \Bots par défaut.
  4. Facultatif : Vous pouvez ajouter une description pour le robot dans le champ Description.
  5. Facultatif : Vous pouvez utiliser le bouton Choisir pour enregistrer le robot dans un dossier différent.
  6. Cliquez sur Créer et modifier.
    Le robot est créé et le Edit Task Bot est affiché.
  7. Cliquez sur Déclencheurs > GitHub, puis double-cliquez ou faites glisser Déclencheur Web du référentiel pour ajouter le déclencheur Web à la section Déclencheurs.
  8. Sélectionnez un ou plusieurs événements à écouter dans la liste déroulante Écouter l\'événement.
  9. Saisissez le nom du dépôt GitHub dans le champ Nom du dépôt.
  10. Saisissez le nom du profil GitHub dans le Profil utilisateur.
  11. Sélectionnez l\'une des options suivantes dans la section Sélectionnez le type d\'authentification.
    Le Jeton d\'accès personnel est sélectionné comme type d\'authentification dans Sélectionner le type d\'authentification par défaut.
    • Informations d\'identification : Cliquez sur Choisir pour sélectionner Jeton d\'accès personnel déjà configuré dans le Credential Vault.
    • Chaîne non sécurisée : Copiez et collez la chaîne du jeton d\'accès personnel générée dans GitHub les paramètres du développeur.
      Remarque : Assurez-vous que le jeton d\'accès personnel n\'a pas expiré.
  12. Facultatif : Ajoutez des variables au déclencheur dans l\'option Réponse. Pour plus d\'informations sur les variables, consultez la rubrique Aperçu des variables.
    Remarque : Si vous utilisez une variable existante pour la réponse, assurez-vous que la case à cocher Utiliser comme entrée est activée pour la variable.
  13. Facultatif : Ajoutez d\'autres déclencheurs selon les besoins dans la section Déclencheurs.
  14. Double-cliquez ou faites glisser une action appropriée de la palette Actions vers la section Action.
    Pour plus d\'informations sur les actions, consultez Actions permettant de créer des automatisations.
  15. Cliquez sur Enregistrer pour enregistrer le robot.
Lorsque vous exécutez le robot en utilisant Run with triggers, le déclencheur web est activé et écoute les événements Issues, Star et Watch. Lorsque l\'un des événements se produit dans le dépôt, le déclencheur initie l\'action Zone de message suivante.