Leçon 3 : Intégration de GitHub dans une chaîne de valeur#

Fournissez des données de référentiel GitHub à la chaîne de valeur.

Avant de commencer

Avant de commencer cette leçon, assurez-vous d'avoir terminé la leçon précédente.

Description de la tâche

Dans cette leçon, vous intégrez un référentiel Git dans la chaîne de valeur du tutoriel.

Pour modifier la chaîne de valeur du tutoriel, procédez comme suit :

Procédure

  1. Cliquez sur Paramètres > Intégration > Plug-ins.

  2. Dans l'onglet Plug-ins, cliquez sur Ajouter une intégration pour l'intégration GitHub.

    Il existe plusieurs manières de définir des intégrations. Vous pouvez les définir directement dans la matrice "integrations" du fichier JSON. Vous pouvez également définir une intégration sur la page Plug-in, puis la référencer dans le fichier JSON. Au cours de cette leçon, nous configurons l'intégration sur la page Plug-in. Dans une leçon ultérieure, nous allons associer l'intégration GitHub à la chaîne de valeur du tutoriel.

  3. Effectuez Jira xxx

  4. Dans la fenêtre Ajouter une intégration GitHub, configurez une intégration en procédant comme suit :

    1. Dans le champ Nom de l'intégration, entrez un nom pour l'intégration, comme « Tuoriel Git ».

      Comme Tutoriel GitHub. Ensuite, nous allons utiliser ce nom pour associer l'intégration à notre chaîne de valeur.

    2. Dans le champ URL, saisissez l'URL du projet GitHub que vous avez configuré précédemment.

      L'URL est similaire à cet exemple, https://github.com/myGitHubID/myGitHubProject.

    3. Dans la zone Nom, entrez le nom du référentiel GitHub.

      Pour l'URL d'exemple de l'étape précédente, le nom est myGitHubProject.

    4. Dans le champ Propriétaire, entrez le compte GitHub qui possède le référentiel.

      Pour l'URL d'exemple, le propriétaire est myGitHubID.

    5. Dans le champ Jeton, entrez votre jeton d'accès personnel GitHub.

    6. Dans le champ URL d'API, entrez l'URL de l'API GitHub.

      Par exemple, https://api.github.com.

    7. Cliquez sur Ajouter.

    L'intégration est répertoriée sur la page Intégrations. Si l'intégration aboutit, le champ Statut affiche Online. Si le statut n'est pas Online, utilisez l'option Afficher le journal pour dépanner l'intégration. Vous pouvez augmenter le niveau de journalisation dans la configuration de l'intégration, dans le cas où vous auriez besoin de plus d'informations de dépannage.

  5. Sur la page Chaînes de valeur, sélectionnez la chaîne de valeur que vous avez créée précédemment dans le tutoriel.

  6. Cliquez sur Configurer la mappe de la chaîne de valeur > Télécharger la mappe de la chaîne de valeur.

    Le fichier tutorial.json est téléchargé sur votre ordinateur.

    Remarque : Après avoir modifié le fichier de mappe de chaîne de valeur par défaut, le nom du fichier téléchargé va représenter le nom de la chaîne de valeur.

  7. Dans votre éditeur de texte, ouvrez le fichier tutorial.json, puis ajoutez l'intégration Jira à la matrice integrations dans le fichier JSON.

    Etant donné que vous avez déjà défini les intégrations Jira, vous pouvez les ajouter à la chaîne de valeur en indiquant son nom, comme dans l'exemple suivant :

    "integrations": [ { "name":"GitHub tutorial" } ],

    Bien entendu, utilisez le nom que vous avez affecté à l'intégration à l'étape 3.

  8. Dans la section linkRules du fichier JSON, définissez les règles qui associent les demandes d'extraction Git aux problèmes Jira.

    Les requêtes DQL affectées à une étape filtrent les informations qui s'affichent dans l'étape, comme le montre l'exemple suivant :

    "linkRules": [ { "fromIntegrationName": "tutorial GitHub", "toIntegrationName": "tutorial Jira", "fromField": "pr.name", "toField": "issue.id", "pattern": "([A-Z]+-[0-9]+)" } ],

    Les règles de lien définissent la manière dont les outils intégrés sont associés les uns aux autres. Pour définir une règle de lien, spécifiez un champ dans l'outil d'origine de la liaison que vous souhaitez associer à un champ dans l'outil de destination de la liaison, ainsi qu'une expression régulière qui définit le pattern correspondant. Dans ce cas, vous liez des demandes d'extraction Git à des problèmes Jira.

  9. Ajoutez une requête à l'étape Fusionné, comme illustré dans l'exemple de code suivant :

    { "name": "Development", "description": null, "stages": [ { "name": "In Progress", "query": "issue.status=\"In Progress\" AND deployment.env!=PROD ", "description": null, "wipLimit": null, "gates": null }, { "name": "Review", "query": "issue.status!=Done and pr.status=open", "description": null, "wipLimit": null, "gates": null }, { "name": "Merged", "query": "(pr.status=MERGED or pr.status=closed) AND build.status!=success AND deployment.env!=DEV and deployment.env!=PROD ", "description": null, "wipLimit": null, "gates": null },

  10. Enregistrez, puis téléchargez le fichier JSON modifié.

résultats

Dans cette leçon, vous avez intégré l'outil externe Git dans la chaîne de valeur, puis l'avez lié à Jira.

Que faire ensuite

Dans la leçon suivante, vous allez apprendre à créer des requêtes qui produisent des données à partir des applications liées.

Sujet parent : Liaison d'outils de chaîne de valeur