GitHub et Asana | Guide produit

Présentation

Avec l’intégration de GitHub et Asana, synchronisez automatiquement vos demandes d’extraction GitHub et les mises à jour de statut de vos tâches Asana pour améliorer la collaboration interfonctionnelle.

Cette nouvelle intégration a été conçue pour renforcer la visibilité et la transparence autour du travail de développement des équipes techniques et non techniques. Grâce à elles, les développeurs peuvent communiquer sans effort sur Asana afin de tenir les équipes et parties prenantes interfonctionnelles informées, évitant ainsi que certaines tâches ne passent entre les mailles du filet.

L’intégration Asana pour GitHub est disponible pour tous les clients Premium, Business et Enterprise.

Installer GitHub Actions pour Asana

Connectez GitHub et Asana pour synchroniser vos demandes d’extraction et recevoir des mises à jour de statut. Configurez l’intégration depuis Asana pour commencer à vous en servir, puis configurez-la également dans GitHub pour bénéficier des fonctionnalités supplémentaires.

écran pour l’ajout de l’application depuis le menu Personnaliser

Pour configurer l’intégration sur Asana :

  1. Ouvrez le projet dans lequel vous souhaitez installer l’intégration Asana pour GitHub. Cliquez sur le menu déroulant Personnaliser dans le coin supérieur droit.
  2. Faites défiler le menu vers le bas pour accéder à la section Applications, puis cliquez sur + Ajouter une application.

application Github

  • Ajoutez GitHub en cliquant sur le bouton + Ajouter à un projet.
  • Suivez les instructions pour autoriser l’accès à votre compte GitHub.
  • L’intégration Asana pour GitHub sera installée au niveau du projet.
  • L’écran qui suit vous invite à indiquer les autres projets auxquels vous souhaitez ajouter l’intégration.

Félicitations, vous pouvez désormais connecter vos demandes d’extraction GitHub à vos tâches Asana ! Si vous souhaitez activer des fonctionnalités supplémentaires, veuillez consulter la section suivante. Dans le cas contraire, passez directement à la section Fonctionnalité principale ci-dessous.

Configurer GitHub Actions

Dans cette section, nous partons du principe que les utilisateurs connaissent les fondamentaux de git, ainsi que le fonctionnement des secrets des répertoires GitHub (ou GitHub repositories). Si vous n’avez pas accès à la configuration des secrets des répertoires, veuillez contacter le propriétaire du répertoire concerné.

Deux types d’actions GitHub sont prises en charge sur Asana :

  1. Recevoir automatiquement des notifications sur Asana pour les demandes d’extraction GitHub : cette action indique le statut de la demande d’extraction dans la tâche Asana, en précisant le titre de la demande et en ajoutant un lien vers la tâche Asana correspondante. Pour configurer cette action, consultez la page relative aux actions GitHub.
  2. Connecter les pièces jointes liées aux descriptions des demandes d’extraction GitHub à Asana : cette action associe automatiquement une demande d’extraction GitHub à une ou plusieurs tâches Asana, en ajoutant le lien de la/des tâche(s) Asana correspondante(s) à la description de la demande d’extraction. Pour configurer cette action, consultez la page relative aux actions GitHub.

Comme c’est le cas pour les autres actions GitHub, les actions précitées ne s’exécutent que lorsqu’un événement se produit dans le répertoire pour lequel vous les avez configurées. Par exemple, vous pouvez configurer une action qui s’exécutera chaque fois qu’un utilisateur fusionne ou commente une demande d’extaction.

Chacune de ces actions GitHub doit être configurée individuellement, à moins qu’il existe plusieurs actions identiques dans le même répertoire. Par exemple, vous pouvez configurer une action pour commenter une tâche Asana dans la description de la demande d’extraction dès qu’un test est terminé, puis définir une autre action pour ajouter un autre commentaire à la tâche lorsque la demande d’extraction est fusionnée.

Vous pouvez également configurer des actions GitHub depuis un processus existant. Pour en savoir plus, consultez le guide des actions GitHub.

Révoquer les jetons secrets

Si vous avez configuré des actions Github dans la section précédente, vous pouvez révoquer les jetons secrets. Pour ce faire, consultez cette page de configuration, et sélectionnez Revoke all (Révoquer tout).

Tous les jetons secrets actifs des actions GitHub seront révoqués.

 Vous pourrez toujours afficher les informations relatives aux demandes d’extraction au sein des projets Asana en cours pour lesquels vous avez installé cette intégration.

Fonctionnalité principale

Associer une demande d’extraction à une tâche Asana (sur Asana) :

Après avoir installé l’intégration GitHub dans les projets Asana de votre choix, un champ GitHub sera présent dans chaque tâche appartenant aux projets concernés.

Champ GitHub dans une tâche

Pour associer une demande d’extraction à une tâche Asana, copiez le lien de cette demande, puis collez-le dans le champ GitHub encore vide. Un widget GitHub sera directement associé à la tâche Asana en question et vous précisera les informations suivantes : statut de la révision, statut du développement, statut de la demande d’extraction, lignes modifiées et nombre de conversations dans GitHub.

Lien d’une demande d’extraction GitHub

Associer une demande d’extraction à une tâche Asana (sur GitHub) :

Après avoir installé l’intégration GitHub sur Asana et configuré les actions GitHub, vous pourrez associer automatiquement une demande d’extraction à une tâche Asana à partir d’une description de demande d’extraction GitHub.

Description d’une demande d’extraction GitHub

Dans la description de votre demande d’extraction GitHub, copiez le lien de la tâche Asana, puis collez-le dans la description. Un widget GitHub s’affichera dans votre tâche Asana et vous précisera les informations suivantes : statut de la révision, statut du développement, statut de la demande d’extraction et lignes modifiées.

 Toute erreur éventuelle est visible sur GitHub sous l’onglet « GitHub Actions » (Actions GitHub).

Recevoir des mises à jour à propos des fusions et clôtures

Les demandes d’extraction peuvent être clôturées sur GitHub une fois que les équipes concernées ont vérifié et fusionné les modifications. Le statut du widget sera automatiquement mis à jour sur Asana.

Si vous souhaitez joindre une nouvelle demande d’extraction GitHub, ajoutez le lien de la tâche Asana à la description de la nouvelle demande et le widget sera automatiquement remplacé. Il est également possible de supprimer la demande d’extraction clôturée dans Asana ; il suffit de cliquer sur le menu en haut à droite. Une fois supprimée, vous pourrez ajouter le lien de votre nouvelle demande d’extraction GitHub.

Après avoir installé l’intégration et configuré les actions GitHub dans Asana, vous recevrez des commentaires sur chaque tâche Asana associée à une demande d’extraction ouverte, notamment les mises à jour indiquant que la demande d’extraction a été fusionnée ou clôturée.

mises à jour

FAQ

  • Les informations générées à partir d’un même jeton secret peuvent-elles servir dans plusieurs répertoires ?
    • Oui
  • Mes collègues ont-ils accès aux informations liées aux demandes d’extraction que j’associe à une tâche Asana, même s’ils n’ont pas accès à ces demandes ?
    • Oui. Lorsque vous associez une demande d’extraction à une tâche, tous les utilisateurs qui peuvent visualiser cette tâche ont accès aux informations du widget.
  • Générer un nouveau jeton désactive-t-il mon ancien jeton secret ?
    • Non, vos anciens jetons secrets resteront actifs. Pour désactiver vos jetons secrets existants, rendez-vous sur ce lien.
  • Les informations générées à partir d’un même jeton secret peuvent-elles servir dans plusieurs répertoires ?
    • Oui
  • Lorsque j’essaie de transférer le fichier du processus, git m’indique que mon jeton ne me donne pas les accès nécessaires pour créer des processus. Que faire ?
  • Pourquoi ces autorisations GitHub me sont-elles demandées ?
    • Dans le cadre de cette intégration, nous procédons uniquement à la lecture et à l’écriture des fichiers relatifs aux demandes d’extraction. L’autorisation de la page d’authentification est la plus restrictive proposée par GitHub afin de nous permettre d’accéder aux demandes d’extraction.
  • Que se passe-t-il lorsqu’une action GitHub associe une demande d’extraction à une tâche appartenant à un projet pour lequel l’intégration n’est pas activée ?
    • Une pièce jointe associée à la demande d’extraction sera visible dans les commentaires de la tâche, mais vous ne pourrez pas voir le widget qui synchronise le statut de la demande.

Malheureusement, votre navigateur n’est pas pris en charge

Asana ne fonctionne pas sur le navigateur Internet que vous utilisez actuellement. Veuillez vous inscrire depuis l’un des navigateurs pris en charge par Asana.

Choisissez votre langue

La sélection d’une langue modifie la langue et/ou le contenu du site asana.com