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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 7 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

    1. Accédez à la DevOps > Outils > Créer nouveau (hérité).
    2. 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.

    3. 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

    4. 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.
    1. Facultatif : Si vous souhaitez contrôler l’accès à l’outil, ajoutez les groupes qui doivent avoir accès à l’outil dans le champ Géré par de l’onglet Accès .
      Les tâches que les utilisateurs des groupes peuvent effectuer dépendent des rôles qui leur sont affectés.
      • DevOps Rôle du propriétaire de l’outil : peut afficher et modifier l’outil.
      • DevOps Rôle du propriétaire de l’application : permet d’afficher l’outil et peut associer, détecter, importer des données historiques et modifier les étapes du pipeline (le cas échéant) des objets de l’outil (tels que les plans, les référentiels et les pipelines).
      • DevOps Rôle d’administrateur : peut modifier tous les outils.
      • Autres DevOps rôles : peut afficher l’outil.
      Remarque :
      Seuls les groupes contenant des utilisateurs ayant DevOps des rôles peuvent être sélectionnés dans le champ Géré par .

      L’option Tous les propriétaires d’applications peuvent afficher et associer des objets d’outil à des applications devient disponible à la sélection si vous choisissez de restreindre l’accès à l’outil. Cette option permet à tous les utilisateurs ayant le rôle de DevOps propriétaire de l’application d’accéder à l’outil. Si cette option est sélectionnée, ils seront en mesure d’afficher, d’associer, de détecter, d’importer des données historiques et de modifier les étapes du pipeline (le cas échéant) des objets de l’outil.

    2. 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.

    3. 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 :
        • L’étape pour entrer le nom d’utilisateur et le mot de passe de l’intégration est requise pour configurer uniquement lorsque Configuration DevOps est installée ou que la This property decides whether to create a Generic Connection on configure operation for Azure DevOps propriété est activée. Si cette étape n’est pas requise, les webhooks sont configurés à l’aide d’une authentification basée sur un jeton.
        • Lorsque Configuration DevOps est installée ou que l’opération Connexion générique lors de la configuration pour la propriété Azure DevOps est activée, vous pouvez régénérer le jeton (configurer automatiquement avec un nouveau jeton) à partir de l’interface utilisateur de l’espace de travail uniquement, ce qui mettra à jour le mot de passe de l’utilisateur d’intégration. Lorsque Configuration DevOps n’est pas installée, le jeton peut être régénéré à partir de l’espace de travail et de l’interface utilisateur classique pour une authentification basée sur le jeton. Regénérez périodiquement votre jeton pour une meilleure sécurité.
      Remarque :
      Pour les plans, le champ Suivre est automatiquement défini sur Vrai.
    4. 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.
    5. 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.