GitHub et Asana

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

Présentation

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.

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.

Félicitations, vous pouvez désormais connecter vos demandes de tirage 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 (pull requests) : 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 (pull request) à 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.

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, 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.

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 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 ?

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.

Envie d’optimiser la gestion de votre travail ? Essayez gratuitement Asana pendant 30 jours. Essayer gratuitement