L'intégration Asana pour GitHub est disponible sur les niveaux Asana Starter, Advanced, Enterprise et Enterprise+, ainsi que sur les niveaux et formules antérieures Premium, Business et Legacy Enterprise.
Pour en savoir plus, consultez notre page de tarification.
Avec l'intégration de GitHub et Asana, synchronisez automatiquement vos demandes d'extraction GitHub (pull requests) 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.
Cette intégration ne prend pas en charge GitHub Enterprise Server.
Installer GitHub Actions pour Asana
Connectez GitHub et Asana pour synchroniser vos demandes d'extraction (pull requests) 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.
Configurer l'intégration sur Asana :
- Ouvrez le projet dans lequel vous souhaitez installer l'intégration Asana pour GitHub. Cliquez sur le bouton Personnaliser dans le coin supérieur droit.
- Faites défiler vers le bas pour accéder à Applications, puis cliquez sur + Ajouter une application.
- Sélectionner GitHub
- Suivez les instructions pour autoriser l'accès à votre compte GitHub.
- L'intégration Asana pour GitHub sera installée au niveau du projet.
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 et les secrets des répertoires GitHub. 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 :
- Recevoir automatiquement des notifications sur Asana pour les demandes d'extraction GitHub : cette action indique le statut de la demande d'extraction sur la tâche Asana. Il comprend le titre de la demande d'extraction ainsi qu'un lien vers la tâche Asana associée. Pour configurer cette action, consultez la page relative aux actions GitHub.
- Connecter les descriptions des demandes d'extraction GitHub aux descriptions 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, faites référence au 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. Visitez cette page de configuration et sélectionnez 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 (pull request) à une tâche Asana (sur Asana) :
Après avoir installé l'intégration GitHub dans Asana, un champ GitHub sera présent dans chaque tâche appartenant au projet concerné.
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.
Associer une demande d'extraction (pull request) à 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.
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 (pull requests) 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, vous pouvez ajouter l'URL de la tâche Asana à la nouvelle description de la demande d'extraction GitHub et le widget sera automatiquement remplacé. Vous pouvez également supprimer la demande d'extraction fermée sur Asana en cliquant sur le menu en haut à droite. Une fois supprimé, vous pouvez entrer une nouvelle URL de demande d'extraction GitHub.
Après avoir installé l'intégration GitHub sur Asana et configuré les actions GitHub, vous recevrez des commentaires sur les tâches Asana accompagnées d'une demande d'extraction ouverte. Cela inclura des mises à jour indiquant si la demande d'extraction a été fusionnée ou clôturée.
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 (pull requests) 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 vous essayez de pousser le fichier de flux de travail, git indique que mon jeton n'a pas accès à la création de flux de travail. Que dois-je faire ?
Lorsque l'authentification à deux facteurs est activée et que vous interagissez avec GitHub depuis la ligne de commande, GitHub exige l'utilisation de votre jeton d'accès personnel comme mot de passe. Dans ce cas, veuillez créer un nouveau jeton d'accès personnel GitHub avec le processus concerné.
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.
Vous aimez ce que vous voyez ? Profitez dès aujourd'hui d'un essai Asana gratuit de 30 jours. Essayez-le gratuitement