Intégrer Azure DevOps à Changements de vélocité DevOps — classique

Rversion finale: Xanadu

Mis à jour 1 août 2024

5 minutes de lecture

Créez un enregistrement d’outil Azure DevOps pour Changements de vélocité DevOps connecter, détecter et importer Azure DevOps des données d’outils.

Avant de commencer

Rôle requis : sn_devops.admin ou sn_devops.tool_owner

Pourquoi et quand exécuter cette tâche

Actions :

Connectez-vous à l’organisation ou au Azure DevOps projet.
Détecter les plans, les référentiels, les tâches d’orchestration et les pipelines.
Configurez les webhooks dans Azure DevOps.
Importez des enregistrements d’élément de travail, de version de plan et de fonctionnalité, des enregistrements de branche et de validation, ainsi que des enregistrements d’exécution de tâches et d’exécution d’étapes.

Pour personnaliser l’importation Azure Boards des états ou des types d’éléments de travail, utilisez l’include de DevOpsAzureDevOpsWorkItemHelper script.

Procédure

Accédez à la DevOps > Outils > Créer nouveau (hérité).

Renseignez les champs du formulaire Créer DevOps un outil.


Champ	Description
Nom de l'outil	Nom de votre choix pour identifier cet outil.
Intégration d'outils	Sélectionnez Azure DevOps.
Se connecter à une organisation ou à un projet	Sélectionnez une option dans la liste. Se connecter à une organisation : connectez-vous directement au niveau de votre Azure DevOps organisation. Tous les projets de l’organisation peuvent être détectés, et vous pouvez choisir de configurer plusieurs projets au sein de l’organisation. Se connecter à un projet : se connecter directement au niveau du projet.
URL de l'outil	Azure DevOps URL de l’organisation (par exemple, `https://dev.azure.com/<votre organisation>` ou URL du Azure DevOps projet (par exemple, `https://dev.azure.com/<votre organisation>/<votre projet >`, en fonction de votre sélection précédente.
Nom d’utilisateur de l’outil	Azure DevOps Nom d’utilisateur de l’instance.
Mot de passe/jeton d’accès de l’outil	Jeton d’accès personnel (PAT) pour votre Azure DevOps instance. Remarque : Seul un jeton d’accès personnel est pris en charge. Lorsque vous générez un jeton d’accès personnel (PAT) pour Azure DevOps, vous devez sélectionner les champs d’application à autoriser si vous n’accordez pas l’accès complet. Consultez Azure DevOps Périmètres PAT pour DevOps.

Pour obtenir la liste de toutes les autorisations requises sur les informations d’identification pour la connexion à Azure DevOps, reportez-vous à la section Azure DevOps Autorisations dans Autorisations requises pour DevOps les outils.

Facultatif : Si votre Azure DevOps instance est associée à un Serveur MID, sélectionnez l’option Utiliser un serveur MID et entrez ses détails.

Pour plus d’informations sur le MID Server, reportez-vous à la section Sélection du MID Server
Sélectionnez Soumettre.

L’outil est automatiquement connecté à l’aide d’un alias de connexion et d’une connexion HTTP (informations d’identification de base), et les détails de l’enregistrement de l’outil sont affichés dans un formulaire.

Remarque :
Si vous ne disposez pas des privilèges d’administration globale pour votre outil (pour permettre la configuration automatique de l’URL Webhook), vous devrez peut-être demander à l’utilisateur administrateur de l’outil de la configurer pour vous (copiez et collez l’URL Webhook dans la configuration de l’outil). Une fois le webhook configuré dans l’outil, passez en mode de configuration manuelle pour vous connecter manuellement à l’outil, puis quittez.

Une fois l’outil créé, vous êtes redirigé vers la page d’enregistrement de l’outil.

Détectez les objets de l’outil, y compris les plans d’application existants (projets associés à l’outil), les référentiels, les tâches d’orchestration et les pipelines.
- Connecté à l’organisation : sélectionnez Découvrir les projets pour détecter les projets de l’organisation. Après la détection, les projets de votre organisation sont disponibles dans la liste connexe Projets .
- Connecté à un projet : le projet est détecté lors de la création de la connexion et est disponible dans la liste connexe Projets . Si vous sélectionnez Découvrir les projets dans l’onglet Projets de la page d’enregistrement de l’outil, tous les projets de votre organisation sont détectés.
Sélectionnez un projet dans la liste connexe Projets pour accéder à la page d’enregistrement de projet. Sélectionnez Détecter pour détecter les objets du projet, y compris les plans (tableaux), les référentiels et les pipelines existants.
Configurez les URL Webhook dans Azure DevOps.
1. Vous pouvez configurer directement à partir de la page des enregistrements d’outils ou de la page d’enregistrement de projet pour chaque produit.
  - Pour configurer à partir de la page des enregistrements d’outils, sélectionnez Configurer les projets. Sélectionnez les projets que vous souhaitez configurer, puis sélectionnez Continuer.
  - Pour configurer à partir de la page des enregistrements de projet, sélectionnez d’abord le projet à partir de la page des enregistrements d’outils, puis sélectionnez Configurer.
2. Saisissez l’utilisateur et le mot de passe d’intégration DevOps , puis sélectionnez Envoyer.
  
  Lors de l’envoi, les webhooks et les connexions de service sont automatiquement créés dans Azure DevOps. Cela envoie les notifications des outils à Changements de vélocité DevOps l’utilisateur d’intégration Azure DevOpsDevOps. Pour en savoir plus sur la configuration du compte d’utilisateur Integration, reportez-vous à la section Configurer le compte d’utilisateur d’intégration dans Changements de vélocité DevOps.
Remarque :
Pour les plans, le champ Suivre est automatiquement défini sur Vrai.
Pour les plans détectés, vous pouvez importer des données historiques à partir de l’outil et également y associer une application.
1. Ouvrez un enregistrement de plan à partir de la liste connexe Planx.
2. Sélectionnez le lien connexe d’importation .
  Les enregistrements sont créés pour le plan dans les listes connexes Éléments de travail, Versions du plan et Fonctionnalités.
  - La liste connexe des éléments de travail affiche les tâches, les bogues et les stories.
    Les champs État natif et Type natif de l’élément de travail contiennent les valeurs d’état et de type d’origine de l’outil source.
  - La liste connexe Versions du plan affiche les mises en production.
  - La liste connexe Fonctionnalités affiche les épopées et les fonctionnalités.
  Remarque :
  L’importation historique d’éléments de Azure DevOps travail n’est pas prise en charge pour le processus CMMI des tableaux Agile.
3. Dans la liste connexe Applications, sélectionnez Modifier... pour sélectionner une application à associer au plan (projet) ou sélectionnez Nouveau pour en créer une.
  Un plan doit avoir un enregistrement d’application associé pour terminer la configuration de l’outil de planification.
Pour les référentiels détectés, importez des données historiques pour l’outil et associez le référentiel à une application.
1. Ouvrez l’enregistrement du référentiel à partir de la liste connexe Référentiels.
2. Sélectionnez Importer.
  Les enregistrements de branche et les enregistrements de validation importés à partir du référentiel sont ajoutés aux listes connexes correspondantes.
3. Dans le champ Application , sélectionnez la liste de recherche et sélectionnez un enregistrement d’application à associer au référentiel, ou cliquez sur Nouveau pour en créer un.
Les enregistrements de données historiques importés sont ajoutés aux listes connexes correspondantes.

Que faire ensuite

Pour Azure les pipelines, Modéliser un pipeline Azure dans DevOps procédez à la configuration dans Changements de vélocité DevOps.

Mappez chaque pipeline à une application spécifique.
Créez des étapes de pipeline et mappez chaque étape à une Azure tâche de pipeline.
Configurez le contrôle des changements.