Créer un hook de service pour Jenkins

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Cet article explique comment configurer un hook de service pour votre projet Azure DevOps afin de déclencher une build Jenkins. Si vous utilisez Jenkins pour créer vos applications, vous pouvez stocker votre code dans un dépôt Git et utiliser Jenkins pour vos builds d’intégration continue. Vous pouvez déclencher une build Jenkins lorsque vous envoyez du code à votre dépôt Git ou lorsque vous archivez du code vers un référentiel TFVC (Team Foundation Version Control).

Vous pouvez créer une partie de votre application dans Azure Pipelines et une partie dans Jenkins. Vous pouvez déclencher une build Jenkins lorsque votre build Azure Pipelines est terminée afin d’utiliser les deux systèmes pour générer votre application.

Azure DevOps ne charge pas la configuration des hooks de service ou l’intégration avec des services externes, et Jenkins est entièrement open source et gratuit à utiliser.

Créer un hook de service Jenkins

Pour gérer les hooks de service pour une organisation ou un projet Azure DevOps, vous devez avoir le rôle Propriétaire ou Administrateur de collection de projets dans l’organisation.

Configurer Jenkins

  1. Si vous n’en avez pas, configurez un serveur Jenkins .

  2. Si vous configurez Jenkins localement, activez HTTPS.

  3. Dans votre fichier de configuration jenkins.xml, définissez la propriété système hudson.plugins.git.GitStatus.NOTIFY_COMMIT_ACCESS_CONTROL en disabled ajoutant ou en mettant à jour la ligne suivante dans la <arguments> balise, avant le -jar paramètre :

    -Dhudson.plugins.git.GitStatus.NOTIFY_COMMIT_ACCESS_CONTROL=disabled.

Configurer une build Jenkins

  1. Dans Jenkins, créez un élément.

    Capture d’écran montrant le lien Nouvel élément dans Jenkins.

  2. Sélectionnez le type de build approprié pour votre projet.

    Capture d’écran montrant le nom et le type de build dans Jenkins.

  3. Entrez l’URL de votre dépôt Git.

    Capture d’écran montrant les paramètres de gestion du code source dans Jenkins avec Git sélectionné.

Configurer le hook de service Jenkins

  1. Dans votre projet Azure DevOps, accédez aux hooks du service de paramètres>de projet à l’adresse https://<organization-name>/<project-name>/_settings/serviceHooks.

    Capture d’écran du choix des hooks de service dans les paramètres du projet.

  2. Dans la page Hooks de service, sélectionnez l’icône + ou Créer un abonnement.

    Capture d’écran de la sélection de créer un abonnement sur la page Hooks de service.

  3. Dans l’écran Service , sélectionnez Jenkins, puis sélectionnez Suivant.

    Capture d’écran de la sélection de Jenkins sur la page Service.

  4. Dans l’écran Déclencheur , sélectionnez et configurez l’événement Azure DevOps que vous souhaitez déclencher une build Jenkins, puis sélectionnez Suivant.

    Capture d’écran de la sélection et de la configuration de l’événement de déclencheur.

  5. Dans l’écran Action , configurez l’action Jenkins à effectuer lorsque l’événement se produit.

    Capture d’écran de la configuration de la boîte de dialogue Action.

  6. Sélectionnez Test pour tester le hook de service et Terminer pour terminer la configuration.

À présent, lorsque l’événement se produit dans le référentiel Git, il déclenche une build Jenkins.

Conseil

Vous pouvez également créer un abonnement de hook de service par programmation avec des API REST. Pour plus d’informations, consultez Créer un abonnement de hook de service par programmation.