Comment configurer une intégration bidirectionnelle Jira GitHub

Voici un scénario courant dans la plupart des organisations : l'équipe de développement utilise le référentiel GitHub , tandis que l'équipe de service utilise Jira Service Management. Cependant, le partage d’informations s’avère difficile puisque les deux équipes utilisent des plateformes qui ne sont pas compatibles entre elles.

Pour combler le fossé, le chef de projet fait appel à un tiers Intégration Jira GitHub pour aider les deux équipes à partager automatiquement les données.

Dans ce guide, je vais vous montrer comment mettre en place une intégration bidirectionnelle entre Jira et GitHub.

Quand avez-vous besoin d’une intégration Jira GitHub ?

Suivant l'exemple de scénario mentionné précédemment, les développeurs et les équipes de service client ont besoin d'une intégration Jira GitHub pour partager des données et centraliser les efforts.

Supposons qu'un client dépose une plainte auprès de l'équipe de service. Dans ce cas, l'agent déclarant créera un ticket Jira avec une description, qui sera également visible par les développeurs sur le ticket GitHub.

Désormais, lorsque le développeur apporte des modifications au problème (ou s'il est résolu), les modifications se répercuteront également sur le problème Jira. Pas besoin de mises à jour manuelles ; pas besoin de quitter leurs plateformes de gestion de travail respectives.

Un autre cas d'utilisation de l'intégration Jira GitHub consiste à répliquer le Relation Epic-enfant à l'aide des listes de tâches GitHub . Cela permet de maintenir un semblant de hiérarchie sur GitHub lors du partage d'informations provenant d'Epics à plusieurs niveaux.

Il existe d'autres cas d'utilisation pour les intégrations GitHub Jira, mais vous devez choisir la bonne solution iPaaS pour explorer ces possibilités.

Comment choisir le bon outil d'intégration

Voici quelques facteurs à prendre en compte avant de choisir un outil d'intégration pour Jira et GitHub.

• Flexibilité et évolutivité

  La solution d'intégration doit être capable de s'adapter à différents scénarios de synchronisation grâce à l'utilisation de mappages personnalisables ou de moteurs de script. Cela aidera les équipes à ajuster leurs charges de travail sans surcharger le réseau.

  
  

• Sécurité

  Vous avez besoin d'un outil d'intégration qui garantit la sécurité car vous lui donnez accès à votre base de code et à votre référentiel. Soyez donc toujours attentif aux contrôles d’accès basés sur les rôles, ainsi qu’aux protocoles d’authentification et de chiffrement.

  
  

• Décentralisation

  Dans le cadre de la sécurité, vous devez isoler votre architecture système, en particulier pour les collaborations interentreprises. Choisir un outil d'intégration avec une architecture mono-tenant vous offre un contrôle autonome sur la synchronisation de votre entreprise.

  
  

• Polyvalence

  Les solutions d'intégration pour Jira et GitHub devraient être capables de gérer différents scénarios d'intégration. Qu'il s'agisse d'un simple mappage ou d'une intégration complexe basée sur du code, l'outil doit être capable de le gérer avec élégance.

  
  

• Fiabilité

  L'intégration doit avoir la capacité de gérer des charges croissantes tout en maintenant une disponibilité maximale. Si une connexion échoue, l'intégration devrait pouvoir reprendre automatiquement lorsque la connexion est rétablie.

  
  

• Assistance et gestion des erreurs

  Lorsqu'une erreur se produit, la solution doit fournir des capacités de débogage. Pour les problèmes techniques avancés, l’équipe d’assistance doit être en mesure de fournir un dépannage et une assistance approfondis.

Une solution d'intégration qui coche toutes ces cases est Exalate — une solution d'intégration bidirectionnelle qui permet des synchronisations bidirectionnelles entre Jira et GitHub.

Comment intégrer Jira et GitHub à l'aide d'Exalate

Afin de commencer à partager des données et à contrôler votre côté de la connexion comme vous le souhaitez, vous devez installer Exalate à la fois sur Jira (sur site ou cloud) et sur GitHub.

Étape 1 - Installer Exalate sur Jira

Allez au Marché Atlassian et recherchez « Exalate Jira Issue Sync & More ».

Cliquez sur le bouton « Essayez-le gratuitement », puis sélectionnez « Cloud » parmi les options qui apparaissent. Notez que vous pouvez également installer Exalate sur un serveur Jira ou un Data Center, ainsi que Docker .

Choisissez un site ou entrez l'adresse du site. Ensuite, cliquez sur « Démarrer l’essai gratuit ». Vous serez redirigé vers votre tableau de bord Jira pour confirmer l'essai gratuit.

Voilà ! Vous avez maintenant installé Exalate sur Jira Cloud.

Étape 2 - Installer Exalate sur GitHub

Recherchez « Exalate Two-Way Issue Sync » sur le marché GitHub.

*Cliquez sur « Configurer le plan » et le menu défilera jusqu'au panneau d'installation. Cliquez sur « Installer gratuitement ». Cliquez ensuite sur « Terminer la commande et commencer l'installation ».

Sur l'écran d'autorisation, cliquez sur « Installer » et choisissez l'organisation sur laquelle vous souhaitez installer Exalate. Vous serez redirigé vers la console d'administration Exalate. Enregistrez ce lien dans un endroit sûr.

\Choisissez si vous souhaitez accorder à Exalate l'accès à tous les référentiels ou à quelques-uns seulement. Ne vous inquiétez pas, vous pourrez toujours modifier l'accès plus tard.

\Cliquez sur « Autoriser Exalate » pour donner à Exalate l'accès à vos dépôts.

Entrez vos coordonnées dans l’écran d’inscription. Cliquez sur « Accepter et soumettre » pour terminer l’inscription. Exalate transmettra désormais un e-mail de vérification à votre boîte de réception.

Accédez à votre boîte de réception et ouvrez ce lien de vérification. Cliquez sur « Vérifier l'instance Exalate » sur l'écran qui apparaît. Après vérification, vous serez redirigé vers la console Exalate.

L'écran suivant qui apparaît vous informera que la validation a réussi. Cliquez sur « Continuer » pour continuer.

Entrez votre jeton personnel généré à partir de GitHub. Suivez les instructions à l'écran pour générer un jeton d'accès personnel dans le champ « Jeton ».

Cliquez sur «Connexion» pour terminer le processus d'installation. Et boum ! Vous êtes prêt à commencer à établir des liens.

Étape 3 - Connectez vos instances

La beauté d'Exalate est qu'il vous permet de démarrer la connexion depuis Jira ou GitHub. Le processus est similaire et l’interface est identique sur les deux plateformes.

Cliquez sur « Initier la connexion ». Saisissez l'URL de l'instance de destination dans le champ désigné. Si vous n'avez pas d'URL, cliquez sur le bouton à bascule « Je n'ai pas d'URL ».

Exalate prend en charge deux modes de configuration pour une intégration Jira GitHub :

Mode de base (pour les configurations prédéfinies simples) et mode Script (pour les configurations de script avancées).

Commençons par le mode de base.

Sélectionnez le projet dans lequel vous souhaitez que les numéros entrants soient envoyés et cliquez sur « Suivant ».

Confirmez que vous disposez d'un accès administrateur et cliquez sur « Initier ».

Vous serez automatiquement redirigé vers l'instance distante. Choisissez un référentiel et cliquez sur

"Confirmer". Entrez la clé du problème et cliquez sur « Exalter » pour continuer.

Hourra! Vous avez configuré votre première connexion Basic.

Passons maintenant au mode Script. Établissez la connexion et vérifiez l'URL de l'instance de destination comme mentionné précédemment. Mais au lieu de choisir le mode de base, sélectionnez le mode Script.

Entrez le nom et la description de la connexion avant de cliquer sur « Suivant ». Sélectionnez ensuite le projet et cliquez sur « Lancer ».

Copiez le code d'invitation dans votre presse-papiers. Allez de l’autre côté et cliquez sur « Accepter l’invitation ».

Saisissez le code d'invitation depuis votre presse-papiers avant de cliquer sur « Suivant ». Ensuite, sélectionnez un référentiel et confirmez.

Toutes nos félicitations! Vous avez configuré avec succès une connexion en mode script.

Étape 4 - Configurez votre connexion

De retour sur le tableau de bord Exalate, accédez à la connexion et cliquez sur l'icône « Modifier la connexion ».

Dans l'onglet « Règles », vous verrez un moteur de script pour la « Synchronisation sortante » et la « Synchronisation entrante ». C'est là que la magie opère. Vous pouvez personnaliser vos connexions à l'aide du langage Groovy.

Étape 5 - Créer des déclencheurs de synchronisation automatisés

La prochaine étape est l'onglet « Déclencheurs ». Ici, vous pouvez voir tous les déclencheurs actifs pour automatiser les synchronisations.

Pour configurer un déclencheur, cliquez sur le bouton « + Créer un déclencheur ».

Ensuite, sélectionnez le type d'entité et saisissez la requête. Pour configurer les déclencheurs GitHub, utilisez le Syntaxe de recherche avancée GitHub et spécifiez le dépôt. Les déclencheurs Jira utilisent le langage de requête Jira (JQL).

Étape 6 : Démarrez la synchronisation

Une fois les déclencheurs définis, vous pouvez maintenant commencer à écrire des règles pour connecter vos instances Jira et GitHub. Vous pouvez également suivre les erreurs à l'aide de la trace de pile dans la console.

Jouez avec des règles de synchronisation simples pour comprendre comment fonctionne la connexion. Une fois que vous avez compris les bases, vous pouvez ajouter des règles supplémentaires ou modifier celles dont vous disposez.

Scénarios d'intégration Jira GitHub courants

• Projet de référentiel Git public : les développeurs disposant de code public peuvent utiliser GitHub pour la gestion de projet et le suivi des problèmes. Intégrez Jira et GitHub pour extraire des éléments dans Jira, vous permettant ainsi de surveiller les discussions publiques en privé. Attribuez des problèmes à partir de la base de code publique, décidez des actions et synchronisez les champs choisis avec GitHub. Cela garantit la collaboration avec la communauté open source tout en gardant les discussions internes confidentielles.

  
  

• Service client et collaboration en matière d'ingénierie : le service client enregistre les problèmes dans Jira, certains nécessitant une attention technique. Grâce à l'intégration Jira-GitHub, les problèmes pertinents sont automatiquement transférés vers GitHub. Une fois résolues, les solutions sont mises à jour dans Jira, permettant au service client de communiquer les correctifs aux clients.

  
  

• Développement de produits et assurance qualité : L’équipe qualité garantit que les produits répondent aux normes juridiques mondiales. Ils suivent et résolvent les problèmes juridiques tout en surveillant en permanence la qualité des produits. Avec l'intégration, les problèmes juridiques et liés à la qualité sont automatiquement envoyés à l'équipe de développement dans GitHub. Au fur et à mesure que les développeurs résolvent les problèmes, l'équipe qualité est automatiquement mise à jour via Jira.

• 
  

Points clés à retenir

Déplacer des données entre des systèmes de gestion du travail peut être une tâche difficile. Mais avec une solution tierce fiable et sécurisée comme Exalate, les équipes peuvent partager des informations de manière transparente.

La configuration de votre connexion avec Exalate est un processus simple. Vous pouvez utiliser le mode de base sans code ou opter pour le mode script basé sur du code. Et si vous souhaitez contrôler les tickets en masse, vous pouvez Bulk Exalate avec des déclencheurs personnalisés.

Si vous avez un cas d'utilisation spécifique et souhaitez savoir comment il peut être implémenté avec Exalate, réservez une session gratuite avec un ingénieur d'intégration et voyez-le en action !