Il vous sera ensuite demandé de choisir une organisation sur votre compte :

Puis vous devrez autoriser monday.com sur votre compte GitHub :

Une fois l'appli installée, les utilisateurs peuvent ajouter de nouveaux modèles GitHub et seront automatiquement authentifiés avec votre compte GitHub.

Cliquez ici pour savoir ce que signifient ces autorisations

Il est important de noter que monday.com ne fait qu'accéder aux données utiles, telles que les noms et emplacements de vos données, pour garantir la fonctionnalité du système. Ces autorisations comprennent :

• Accès à votre code - Spécifique au modèle TODO, monday.com lit les changements sur le PR, sans sauvegarder le code, afin de le connecter à votre élément monday. 
• Problèmes - monday.com doit accéder aux informations concernant les problèmes pour pouvoir déclencher les automatisations monday pertinentes.
• Métadonnées - monday.com doit accéder à une collection de points de terminaison en lecture seule avec métadonnées pour pouvoir déclencher les automatisations monday pertinentes. Ces points de terminaison ne fournissent aucune information privée ou sensible concernant le dépôt.
• Demandes d'extraction - monday.com doit lire les modifications effectuées dans le PR, ainsi qu'accéder aux informations concernant les autorisations d'extraction, pour pouvoir déclencher les automatisations  monday et les modèles à synchronisation bidirectionnelle

Ajoutez-le à votre processus de travail 

Pour ajouter les nouveaux modèles d'intégration GitHub au tableau de votre choix, vous pouvez vous rendre sur ce tableau et cliquer sur Intégrer dans le coin supérieur droit :

Dans le centre des automatisations, tapez « GitHub » dans la barre de recherche :

Cliquez sur la bannière GitHub pour trouver les modèles disponibles dans notre intégration :

Il vous suffit ensuite de sélectionner les modèles que vous souhaitez ajouter à votre tableau.

Les modèles d'intégration pris en charge par monday.com sont les suivants :

• Lorsqu'un problème a l'étiquette quelque chose dans ce répertoire, créer un élément
• Lorsqu'une demande de tirage est fusionnée dans ces répertoires et que l'ID d'un élément y est mentionné, passer le ,statut à quelque chose
• Lorsqu'un problème est créé dans ces répertoires, créer un élément
• Lorsqu'une demande de tirage est créée dans ces répertoires et que l'ID d'un élément y est mentionné, passer le ,statut à quelque chose
• Lorsqu'une demande de tirage est créée dans ces répertoires et que l'ID d'un élément y est mentionné, ajouter le lien de la demande dans cette colonne Lien
• Lorsqu'une branche est créée dans ces répertoires, créer un élément
• Lorsque le statut d'un problème passe à quelque chose dans ces répertoires et que l'ID d'un élément y est mentionné, faire passer le statut à quelque chose
• Lorsqu'un utilisateur GitHub fait passer un commentaire TODO dans ces répertoires, créer un élément
• Lorsqu'un problème est créé dans ces répertoires et que l'ID d'un élément y est mentionné, ajouter le lien à cette colonne Lien
• Lorsque le statut d'une demande de tirage passe à quelque chose dans ces répertoires et que l'ID d'un élément y est mentionné, faire passer le statut à quelque chose
• Lorsqu'un problème a l'étiquette quelque chose dans ce répertoire et que l'ID de l'élément y est mentionné, faire passer le statut à quelque chose
• Lorsque le statut d'une demande de tirage passe à quelque chose dans ces répertoires et que l'ID d'un élément y est mentionné, créer une mise à jour
• Lorsqu'une demande de tirage a l'étiquette quelque chose dans ce répertoire et que l'ID d'un élément y est mentionné, faire passer le statut à quelque chose
• Lorsqu'un problème est créé dans ces répertoires, créer un élément et synchroniser les modifications ultérieures
• Lorsqu'un problème est créé avec ces étiquettes dans ce répertoire, créer un élément et synchroniser les modifications ultérieures
• Lorsqu'une demande d'extraction est créée ou mise à jour dans ces répertoires, créer un élément et synchroniser les modifications ultérieures
• Lorsqu'un élément est créé ou mis à jour, créez un problème dans ce répertoire, avec ces champs et synchronisez toutes les modifications futures

Créer une synchronisation bidirectionnelle

Une synchronisation bidirectionnelle se produit lorsque les données sont à la fois transférées de monday.com vers GitHub et extraites de GitHub vers monday.com. Ce type de synchronisation permet de faire correspondre vos données sur les deux plateformes et de rester à jour.

Pour créer une synchronisation dans les deux sens, sélectionnez « dans les deux sens » dans le menu déroulant.

Par exemple, si vous souhaitez mapper la colonne de l'élément Admin de monday.com sur le champ Attribué à de GitHub, vous sélectionnerez ces champs dans les menus déroulants respectifs. Ensuite, dans le menu déroulant « Choisir la direction », choisissez « dans les deux sens ».

Quel est l'ID de l'élément ?

Certains des modèles d'intégration nécessitent une connexion unique entre monday.com et GitHub afin de synchroniser les deux plateformes. L'ID de l'élément sert de numéro unique associé à un élément.

Remarque : vous devez mettre un symbole « # » devant le numéro dans GitHub pour que la colonne ID de l'élément de monday.com reconnaisse la connexion. Ex : utilisez #376479 dans GitHub, et non 376479. 

Par exemple, prenons le modèle d'intégration : « Lorsqu'une demande de tirage est créée dans ce répertoire, et que l'ID de l'élément est mentionné dans le nom de la demande, changez le statut en quelque chose ».

Une fois la demande de tirage créée dans GitHub, le système utilise l'ID de l'élément dans monday.com pour identifier l'élément qu'il doit modifier.

Conseil : vous pouvez cliquer sur la colonne ID de l'élément pour copier facilement et automatiquement la valeur depuis votre tableau.

Actions GitHub

GitHub Actions est un outil intégré à GitHub qui vous permet d'automatiser des tâches au sein de votre processus de travail de développement de logiciels. Il vous aidera à éliminer les tâches répétitives, ce qui rationalisera le processus de développement et le rendra plus efficace.

Que peut faire GitHub Actions ?

• Automatiser le pipeline CI/CD : cela vous permettra de mettre en place des processus automatiques pour construire, tester et déployer votre code à chaque fois qu'il y a des changements. Cela permet de détecter les bugs à un stade précoce et de rationaliser le processus de publication.
• Exécuter un processus de travail basés sur des événements: GitHub Actions peut déclencher des processus de travail basés sur divers événements dans votre référentiel. Par exemple, vous pouvez créer un processus de travail qui exécute des tests automatiquement à chaque fois qu'une demande d'extraction est soumise.
• Utiliser une large base d'actions : il existe une vaste collection d'actions prédéfinies que vous pouvez utiliser pour diverses tâches. Cela peut aller du déploiement de votre code sur différentes plateformes à la création de tickets dans des outils de gestion de projet. Vous pouvez également créer vos propres actions personnalisées.

Vous y trouverez le modèle de notre intégration GitHub qui ouvre un élément sur des processus de travail spécifiques se terminant par des conclusions spécifiques. L'élément peut être alimenté par des données relatives au processus de travail.

Pour utiliser le modèle, accédez au Centre des automatisations et recherchez GitHub. De là, cliquez sur le modèle, comme indiqué ci-dessous.

Remarque : pour utiliser les Actions GitHub, l'administrateur de l'organisation GitHub doit autoriser le paramètre « Actions Read Permission ». Si vous rencontrez des problèmes, contactez-nous. 

Que faut-il savoir de plus ?

La nouvelle intégration fonctionnera-t-elle même si je n'installe pas l'application dans GitHub ?

• Non, l'intégration n'est pas possible sans installer l'application dans GitHub.

Puis-je connecter mon compte monday.com à plusieurs organisations dans GitHub ?

• Oui ! Vous pouvez connecter vos comptes monday.com à plusieurs organisations dans GitHub.

Ensuite, pour désinstaller l'application monday.com de GitHub, vous pouvez aller dans votre compte GitHub > Paramètres > Applications et chercher monday.com. Faites défiler jusqu'à« Zone de danger »et cliquez sur« Désinstaller ».