Comment intégrer Jira et Harness Drone

Étape 1. Créez des identifiants OAuth dans Jira

Pour intégrer Harness Drone à votre projet Jira, vous devez créer des identifiants OAuth. Pour ce faire, procédez comme suit :

1. Dans Jira, cliquez sur Apps, puis sur Manage your apps (Gérer vos apps).

2. Sélectionnez Create OAuth credentials (Créer des identifiants OAuth).

3. Cliquez sur le bouton Create new credentials (Créer des identifiants).

4. Renseignez les champs suivants :

a. App name (Nom de l’application) : Drone.

b. Server base URL (URL de base du serveur) : https://www.drone.io

c. Sous Permissions (Autorisations), cochez Deployments (Déploiements).

5. Cliquez sur le bouton Create new credentials (Créer des identifiants). Vous verrez les nouveaux identifiants s'afficher.

Étape 2. Configurez des secrets dans Harness Drone

Ensuite, vous devrez configurer vos identifiants Jira dans Harness Drone afin d'effectuer l'intégration et de mettre à jour les tickets.

1. Connectez-vous à votre compte Harness Drone et sélectionnez le dépôt de l'intégration.

2. Sélectionnez Settings (Paramètres), puis Secrets.

3. Cliquez sur le bouton New Secret (Nouveau secret).

a. Le premier secret doit contenir la valeur Client ID (ID client) de votre identifiant OAuth Jira. Vous pouvez le nommer « jira_client_id ».

b. Le second secret doit contenir la valeur du secret de votre identifiant OAuth Jira. Vous pouvez l'appeler « jira_client_secret ».

Vous devriez maintenant avoir défini les deux secrets dans Harness Drone.

Étape 3. Ajoutez le plug-in Jira à votre pipeline Harness Drone

Lors de son exécution, le pipeline actualise les informations sur l’état, l’avancement du travail et l’environnement de déploiement dans le ticket Jira mentionné dans le message de commit. Pour ce faire, sous Steps (Étapes), modifiez votre pipeline et ajoutez le plug-in Jira Software.

Les attributs suivants seront nécessaires :

1. Name (Nom)

2. Image : plugins/jira

3. client_id : doit correspondre au secret créé à l’étape 2 (« jira_client_id » dans l’exemple ci-dessous)

4. Project (Projet) : doit porter le même nom que votre projet Jira (« DRONE » dans l’exemple ci-dessous). Remarque : le nom du projet est sensible à la casse

5. Instance : sous-domaine de votre compte Atlassian qui peut être récupéré à partir de l’URL https://xxxxxx.atlassian.net (« droneio » dans cet exemple)

6. Environment (Environnement) : doit correspondre à l’une des valeurs suivantes : unmapped (non mappé), development (développement), testing (test), staging ou production.

Après avoir ajouté le plug-in à votre pipeline, vous pouvez déclencher l'exécution et mettre à jour automatiquement un ticket Jira.

Étape 4. Exécutez le pipeline Harness Drone

La méthode courante d'exécuter automatiquement un pipeline Harness Drone consiste à commiter un changement, ce qui déclenchera une exécution. Pour mettre à jour l'état d'un ticket, vous devez fournir l'ID du ticket dans le message de commit. 

Pour ce faire, procédez comme suit :

1. Créez un ticket Jira que vous souhaitez mettre à jour pendant l'exécution du pipeline.

2. Après avoir modifié le code du ticket, ajoutez l'ID du ticket dans le message de commit. Dans l'exemple ci-dessous, le ticket est appelé « Autocomplete username and password » (Saisie automatique du nom d'utilisateur et du mot de passe) et l'ID est DRONE-4.

3. L'exécution du pipeline devrait démarrer. L'exemple ci-dessous implique la mise à jour de l'environnement de production.

Lorsque l'exécution du pipeline est terminée, vous devriez voir l'état du pipeline dans Jira.

Étape 5. Affichez l’état du ticket sur la page Deployments (Déploiements) de Jira

Sur la page Deployments (Déploiements) de Jira, vous devriez voir l’état du ticket en fonction de la progression actualisée par le pipeline Drone.

Si vous cliquez sur Show more information (Afficher plus d'informations), vous pouvez voir l'historique complet et l'état de déploiement du ticket.

Étape 6. Affichez l'état du ticket sur le tableau de bord Jira

Sur le tableau de bord Jira, si vous ouvrez le ticket, vous verrez l’état du dernier déploiement dans le champ Releases (Livraisons). Dans l’exemple suivant, le dernier déploiement a eu lieu dans l’environnement de production.

Atlassian Open DevOps vous permet de créer la chaîne d'outils DevOps de votre choix, grâce à des intégrations avec les principaux fournisseurs et les principales apps du Marketplace. Pour en savoir plus, consultez nos intégrations DevOps.