Intégrer Azure DevOps à Changements de vélocité DevOps — Espace de travail

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 15 minutes de lecture

    • Connectez-vous à votre Azure DevOps instance à l’aide du playbook de l’espace de travail de changement DevOps pour collecter des données pour les fonctions de planification, de codage, d’orchestration, d’artefact et de qualité logicielle.

    Vous pouvez vous connecter à Azure DevOps (ADO) au niveau de votre organisation ou au niveau d’un projet individuel. Si vous vous connectez au niveau d’un projet, vous devez répéter le processus de connexion pour chaque projet de votre organisation. Après vous être connecté à une instance de l’outil, vous pouvez configurer des paramètres supplémentaires qui permettent DevOps d’importer des pipelines, des enregistrements d’exécution de tâches et des enregistrements d’exécution d’étapes.

    Lorsque vous configurez des webhooks dans votre Azure DevOps instance pour envoyer des données à Changements de vélocité DevOps, Azure DevOps utilise l’authentification par jeton pour l’utilisateur d’intégration par défaut. Les Changements de vélocité DevOps API sont invoquées à l’aide de l’authentification par jeton et vous n’avez pas besoin de saisir le nom d’utilisateur et le mot de passe de l’intégration lors de la configuration. Si l’utilisateur devops.system n’est pas disponible dans votre instance ServiceNow, vous devez définir la propriété Basculer sur cet utilisateur une fois l’authentification basée sur le jeton réussie . Pour plus d'informations, consultez Propriétés du Changements de vélocité DevOps. L’étape de saisie du nom d’utilisateur et du mot de passe d’intégration est requise uniquement dans les scénarios suivants :
    • Si Configuration DevOps est installée, les API Configuration DevOps sont invoquées à l’aide de l’authentification de base.
    • Si vous utilisez la connexion au service d’API REST d’invocation Azure. Vous devez activer la This property decides whether to create a Generic Connection on configure operation for Azure DevOps propriété dans ce cas.
    Remarque :
    Changements de vélocité DevOps utilise le terme instance pour désigner une occurrence particulière d’un outil. Azure DevOps utilise le terme projet à la place.

    Se connecter à une organisation

    Connectez et configurez votre Azure DevOps instance 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. Vous pouvez gérer l’outil au niveau de l’organisation.

    Avant de commencer

    Effectuez les tâches spécifiées dans la Premiers pas avec Changements de vélocité DevOps rubrique.

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

    Procédure

    1. Accédez à la Espaces de travail > Espace de travail de changement DevOps et utilisez l’une des options suivantes pour ouvrir le Playbook à embarquer Azure DevOps.
      OptionÉtapes
      Page d'accueil
      1. Sélectionnez Connecter un outil.
      2. Dans le modal Se connecter à un outil, sélectionnez Azure DevOps la catégorie appropriée (Orchestration, Plan, Code, Artefact ou Qualité logicielle).
      Module d’application
      1. Sélectionnez Applications ( icône Applications.) dans la navigation primaire.
      2. Sélectionnez une application existante ou créez-en une. Pour créer une application, reportez-vous à la section ../task/app-create-workspace.html.
      3. Dans le volet Actions recommandées, sélectionnez la fiche Connecter un outil .
      4. Dans le modal Se connecter à un outil, sélectionnez Azure DevOps la catégorie appropriée (Orchestration, Plan, Code, Artefact ou Qualité logicielle).
      Module d’outils
      1. Sélectionnez Outils ( icône Outils)dans la navigation primaire.
      2. Dans la liste Aptitude, sélectionnez la catégorie appropriée (Orchestration, Planification, Codage, Artefact ou Qualité logicielle).
      3. Sélectionnez Connecter un outil.
      4. Dans le modal Se connecter à un outil, sélectionnez Azure DevOps.
      Important :
      Si vous souhaitez détecter et suivre des objets d’outil tels que des pipelines, des plans ou des référentiels lors de la connexion à l’outil, vous devez connecter votre outil à partir du module Application.
    2. Dans le modal Se connecter à un outil, saisissez les détails de la connexion.
      1. Sélectionnez Connecter une organisation dans la liste déroulante.
      2. Saisissez l’URL Azure DevOps de l’organisation.
      3. Dans le champ Nom de l’outil , saisissez un nom pour l’outil.

      4. Sélectionnez Suivant.

        Connectez-vous à l’organisation.

        Le DevOps playbook s’ouvre pour vous aider à accomplir les tâches d’intégration.

    3. Saisissez les détails de l’instance de votre outil.
      1. Entrez le mot de passe ou le jeton d’accès pour accéder à cette instance.
        Pour plus d’informations sur la création d’un PAT, consultez Jeton d’accès personnel (PAT).
      2. Facultatif : Si votre instance d’outil est attachée à un Serveur MID, sélectionnez l’option Serveur MID et entrez ses détails.

        Pour plus d’informations sur Serveur MID, reportez-vous à la section Sélection d’un Serveur MID.

      3. Sélectionnez Connexion.

        Détails de l’instance Azure.

      4. Les contrôles d’autorisation sont exécutés sur les informations d’identification que vous avez saisies.
        Les autorisations requises et les autorisations disponibles s’affichent. Si vous souhaitez saisir des informations d’identification avec de meilleures autorisations, sélectionnez Saisir à nouveau les informations d’identification. Pour obtenir des informations détaillées sur toutes les autorisations requises, consultez Autorisations Azure DevOps dans Autorisations requises pour DevOps les outils.

        Vous pouvez choisir de continuer avec la connexion de l’outil même si vous ne disposez pas de toutes les autorisations requises.

        Remarque :
        Lors de l’intégration d’une organisation, le privilège Administrateurs de projet exige que le propriétaire du PAT soit membre du groupe Administrateurs de collection de projets de l’organisation.

        Vous avez besoin du privilège Administrateurs de projet uniquement pour l’intégration de l’outil. Une fois l’outil intégré, vous pouvez choisir de désactiver le privilège Administrateurs de projet dans le PAT.

        Autorisations requises pour Azure PAT.

    4. Spécifiez l’accès pour l’outil.
      1. 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 .
        Les tâches que ces utilisateurs peuvent effectuer dans les groupes dépendent du rôle qui leur est affecté.
        • 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 :
        Si vous ne sélectionnez pas de groupe et ignorez cette étape, tous les utilisateurs ayant le rôle de propriétaire de l’outil DevOps seront en mesure de modifier l’outil.
      2. Si vous choisissez de contrôler l’accès à l’outil, l’option Tous les propriétaires d’applications DevOps peuvent afficher et associer des objets d’outil aux applications devient disponible pour sélection.
        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.
      3. Sélectionnez Affecter.
        Affectez des groupes d’accès.
    5. Installez l’extension ServiceNow DevOps dans votre Azure DevOps instance.

      L’extension ServiceNow DevOps créera automatiquement des connexions de service lors de la configuration des webhooks. Des connexions de service sont requises pour envoyer des notifications de version et de mise en production à partir de Azure DevOps. L’extension contient également des tâches personnalisées pour modifier les pipelines pour le contrôle des changements, les artefacts et les Azure DevOps packages.

      Pour plus d’informations sur l’extension, reportez-vous à la section Utiliser l’extension ServiceNow DevOps pour Azure DevOps et Azure DevOps les actions personnalisées.

      Remarque :
      Si vous ignorez cette étape, pour envoyer des notifications à partir d'Azure DevOps, vous devez créer manuellement des connexions de service après avoir configuré des webhooks.

      Après avoir installé l’extension, sélectionnez Marqué comme installé.

      Installez l’extension ServiceNow DevOps.

    6. Configurez automatiquement les webhooks dans votre Azure DevOps instance pour envoyer des données à Changements de vélocité DevOps.
      Choisissez d’envoyer des données par interrogation nocturne ou par configuration de webhooks pour envoyer des données en temps réel.
      • Webhooks : activez les notifications en temps réel pour les exécutions de vos pipelines. Les notifications en temps réel sont idéales pour maintenir les informations les plus à jour, notamment pour automatiser les demandes de changement.

        Pour utiliser des webhooks, sélectionnez Configurer.

      • Interrogation nocturne : si vous ne choisissez pas de configurer maintenant, vous pouvez activer l’interrogation nocturne ultérieurement pour extraire les données de tous les plans suivis en définissant la Enable Polling propriété sur Oui.
      1. Saisissez le nom d’utilisateur et le mot de passe de l’intégration DevOps .

        Pour en savoir plus sur la création de l’utilisateur et du mot de passe d’intégration, reportez-vous à la DevOps section Configurer le compte d’utilisateur d’intégration dans Changements de vélocité DevOps.

      2. Sélectionnez les projets pour lesquels vous souhaitez configurer des webhooks.

      3. Sélectionnez Configurer.

        Configurez Azure DevOps pour l’organisation.

      Pour configurer manuellement les webhooks, sélectionnez Configurer manuellement. Consultez Configurer manuellement les webhooks Azure DevOps pour plus d'informations.

      La configuration et la détection du Webhook se produisent en arrière-plan, et vous êtes redirigé vers la page Résumé.

      Résumé de la connexion de l’organisation.

    7. Sur la page Résumé, sélectionnez Afficher l’enregistrement de l’outil pour examiner les détails de l’outil connecté.

    Résultats

    Vous avez intégré avec succès votre Azure DevOps outil Changements de vélocité DevOps au niveau de l’organisation.

    Que faire ensuite

    Dans l’onglet Projets de la page d’enregistrement de l’outil, sélectionnez un projet pour accéder à la page d’enregistrement de projet. À partir de là, vous pouvez détecter les objets du projet et configurer des webhooks pour le 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.
    • Si vous avez créé l’outil directement au niveau du projet, la sélection de Découvrir les projets dans l’onglet Projets de la page d’enregistrement de l’outil détectera également tous les projets de votre organisation.
    • Sélectionnez Configurer et entrez les informations d’identification de l’utilisateur d’intégration pour configurer les webhooks pour le projet.
    • Si vous êtes sur la page des enregistrements d’outils, sélectionnez Configurer les projets et entrez les informations d’identification de l’utilisateur d’intégration pour obtenir la liste des projets non configurés dans votre organisation. Sélectionnez les projets pour lesquels vous souhaitez configurer des webhooks, puis sélectionnez Configurer.
    • Pour importer des données historiques dans des objets de projet tels que des plans, des référentiels ou des pipelines, associez les objets à une application et importez les données. Pour plus d'informations, consultez Associer des objets d’outil à des applications : espace de travail.

    Se connecter à un projet

    Connectez et configurez votre Azure DevOps instance directement au niveau du projet. Si vous avez plusieurs projets au sein de l’organisation, vous devez les connecter séparément.

    Avant de commencer

    Effectuez les tâches spécifiées dans la Premiers pas avec Changements de vélocité DevOps rubrique.

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

    Procédure

    1. Accédez à la Espaces de travail > Espace de travail de changement DevOps et utilisez l’une des options suivantes pour ouvrir le Playbook à embarquer Azure DevOps.
      OptionÉtapes
      Page d'accueil
      1. Sélectionnez Connecter un outil.
      2. Dans le modal Se connecter à un outil, sélectionnez Azure DevOps la catégorie appropriée (Orchestration, Plan, Code, Artefact ou Qualité logicielle).
      Module d’application
      1. Sélectionnez Applications ( icône Applications.) dans la navigation primaire.
      2. Sélectionnez une application existante ou créez-en une. Pour créer une application, reportez-vous à la section ../task/app-create-workspace.html.
      3. Dans le volet Actions recommandées, sélectionnez la fiche Connecter un outil .
      4. Dans le modal Se connecter à un outil, sélectionnez Azure DevOps la catégorie appropriée (Orchestration, Plan, Code, Artefact ou Qualité logicielle).
      Module d’outils
      1. Sélectionnez Outils ( icône Outils)dans la navigation primaire.
      2. Dans la liste Aptitude, sélectionnez la catégorie appropriée (Orchestration, Planification, Codage, Artefact ou Qualité logicielle).
      3. Sélectionnez Connecter un outil.
      4. Dans le modal Se connecter à un outil, sélectionnez Azure DevOps.
      Important :
      Si vous souhaitez détecter et suivre des objets d’outil tels que des pipelines, des plans ou des référentiels lors de la connexion à l’outil, vous devez connecter votre outil à partir du module Application.
    2. Dans le modal Se connecter à un outil, saisissez les détails de la connexion.
      1. Sélectionnez Connecter un projet dans la liste déroulante.
      2. Saisissez l’URL Azure DevOps du projet.
      3. Dans le champ Nom de l’outil , saisissez un nom pour l’outil.

      4. Sélectionnez Suivant.

        Le DevOps playbook s’ouvre pour vous aider à accomplir les tâches d’intégration.

      Connectez-vous au projet.

    3. Saisissez les détails de l’instance de votre outil.
      1. Entrez le mot de passe ou le jeton d’accès pour accéder à cette instance.
        Pour plus d’informations sur la création d’un PAT, consultez Jeton d’accès personnel (PAT).
      2. Facultatif : Si votre instance d’outil est attachée à un Serveur MID, sélectionnez l’option Serveur MID et entrez ses détails.

        Pour plus d’informations sur Serveur MID, reportez-vous à la section Sélection d’un Serveur MID.

      3. Sélectionnez Connexion.

        Détails de l’instance Azure.

      4. Les contrôles d’autorisation sont exécutés sur les informations d’identification que vous avez saisies.
        Les autorisations requises et les autorisations disponibles s’affichent. Si vous souhaitez saisir des informations d’identification avec de meilleures autorisations, sélectionnez Saisir à nouveau les informations d’identification. Pour obtenir des informations détaillées sur toutes les autorisations requises, consultez Autorisations Azure DevOps dans Autorisations requises pour DevOps les outils.

        Vous pouvez choisir de continuer avec la connexion de l’outil même si vous ne disposez pas de toutes les autorisations requises.

        Remarque :
        Lors de l’intégration d’un projet, le privilège Administrateurs de projet exige que le propriétaire du PAT soit membre du groupe d’administrateurs de projet du projet.

        Vous avez besoin du privilège Administrateurs de projet uniquement pour l’intégration de l’outil. Une fois l’outil intégré, vous pouvez choisir de désactiver le privilège Administrateurs de projet dans le PAT.

        Autorisations requises pour Azure PAT.

    4. Spécifiez l’accès pour l’outil.
      1. 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 .
        Les tâches que ces utilisateurs peuvent effectuer dans les groupes dépendent du rôle qui leur est affecté.
        • 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 :
        Si vous ne sélectionnez pas de groupe et ignorez cette étape, tous les utilisateurs ayant le rôle de propriétaire de l’outil DevOps seront en mesure de modifier l’outil.
      2. Si vous choisissez de contrôler l’accès à l’outil, l’option Tous les propriétaires d’applications DevOps peuvent afficher et associer des objets d’outil aux applications devient disponible pour sélection.
        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.
      3. Sélectionnez Affecter.
        Affectez des groupes d’accès.
    5. Installez l’extension ServiceNow DevOps dans votre Azure DevOps instance.

      L’extension ServiceNow DevOps créera automatiquement des connexions de service lors de la configuration des webhooks. Des connexions de service sont requises pour envoyer des notifications de version et de mise en production à partir de Azure DevOps. L’extension contient également des tâches personnalisées pour modifier les pipelines pour le contrôle des changements, les artefacts et les Azure DevOps packages.

      Pour plus d’informations sur l’extension, reportez-vous à la section Utiliser l’extension ServiceNow DevOps pour Azure DevOps et Azure DevOps les actions personnalisées.

      Remarque :
      Si vous ignorez cette étape, pour envoyer des notifications à partir d'Azure DevOps, vous devez créer manuellement des connexions de service après avoir configuré des webhooks.

      Après avoir installé l’extension, sélectionnez Marqué comme installé.

      Installez l’extension ServiceNow DevOps.

    6. Configurez automatiquement les webhooks dans votre Azure DevOps instance pour envoyer des données à Changements de vélocité DevOps.
      Choisissez d’envoyer des données par interrogation nocturne ou par configuration de webhooks pour envoyer des données en temps réel.
      • Webhooks : activez les notifications en temps réel pour les exécutions de vos pipelines. Les notifications en temps réel sont idéales pour maintenir les informations les plus à jour, notamment pour automatiser les demandes de changement.

        Pour utiliser des webhooks, sélectionnez Configurer.

      • Interrogation nocturne : si vous ne choisissez pas de configurer maintenant, vous pouvez activer l’interrogation nocturne ultérieurement pour extraire les données de tous les plans suivis en définissant la Enable Polling propriété sur Oui.
      1. Saisissez le nom d’utilisateur et le mot de passe de l’intégration DevOps .

        Pour en savoir plus sur la création de l’utilisateur et du mot de passe d’intégration, reportez-vous à la DevOps section Configurer le compte d’utilisateur d’intégration dans Changements de vélocité DevOps.

      2. Sélectionnez Configurer.

        Configurez Azure DevOps pour un projet.

        Important :
        • Si vous vous connectez à partir de la page d’accueil ou du module Outils, la connexion est terminée et vous êtes redirigé vers la page Résumé.
        • Si vous vous connectez à partir du module Applications, les plans, les référentiels et les pipelines disponibles dans votre projet sont détectés. Vous pouvez en suivre et en importer des données historiques.
    7. Sélectionnez les plans à suivre.
      1. Sélectionnez les plans pour lesquels vous souhaitez suivre les mises à jour et les associer à l’application.

      2. Sélectionnez Suivant.

        Sélectionnez les plans à suivre.

      3. Si vous souhaitez importer des données de plan, sélectionnez la plage de dates, puis Soumettre.

        Vous pouvez importer jusqu’à 90 jours de données.

        Importez les données du plan.

    8. Sélectionnez les référentiels à suivre.
      1. Sélectionnez les référentiels pour lesquels vous souhaitez suivre les mises à jour et les associer à l’application.

      2. Sélectionnez Suivant.

        Sélectionner les référentiels à suivre.

      3. Si vous souhaitez importer des données de référentiel, sélectionnez la plage de dates, puis sélectionnez Soumettre.

        Vous pouvez importer jusqu’à 90 jours de données.

        Importez les données du référentiel.

    9. Sélectionnez les pipelines à suivre.

      1. Sélectionnez les pipelines pour lesquels vous souhaitez suivre les mises à jour et les associer à l’application.

      2. Sélectionnez Suivant.

        Sélectionnez les pipelines à suivre.

      3. Pour chaque pipeline sélectionné, toutes les étapes sont importées pour la dernière exécution réussie. Dans l’activité Affecter des services aux étapes du pipeline, vous pouvez sélectionner les éléments suivants pour chaque étape du pipeline :

        1. Type d’étape du pipeline : sélectionnez un type d’étape auquel vous souhaitez affecter un service.

          Conseil :
          Spécifiez au moins le type d’étape pour les Prod deploy étapes qui représentent le déploiement de production afin de permettre DevOps d’identifier les exécutions de pipeline réussies en tant que déploiements de production.

        2. Service : sélectionnez le service d’application CMDB auquel l’étape de pipeline est toujours mappée.

          Le service d’application est mappé approximativement à l’environnement. Si vous utilisez la même étape de pipeline pour le déploiement dans différents environnements, laissez le champ vide. Les informations sur le service permettent DevOps d’identifier et de signaler des mesures opérationnelles telles que les incidents, les pannes, etc.

      4. Sélectionnez Suivant.

        Affectez des services aux étapes du pipeline.

      5. Si vous souhaitez importer des données de pipeline, sélectionnez la plage de dates, puis sélectionnez Soumettre.

        Vous pouvez importer jusqu’à 90 jours de données.

        Importez des données de pipeline historiques.

    10. Vous êtes redirigé vers la page Résumé.

      Sur la page Résumé, sélectionnez Afficher l’enregistrement de l’outil pour examiner les détails de l’outil connecté.

      Résumé de la connexion du projet.

    Résultats

    Vous avez intégré avec succès votre Azure DevOps outil Changements de vélocité DevOps au niveau du projet.

    Que faire ensuite

    Dans l’onglet Projets de la page d’enregistrement de l’outil, sélectionnez un projet pour accéder à la page d’enregistrement de projet. À partir de là, vous pouvez détecter les objets du projet et configurer des webhooks pour le projet.
    • Sélectionnez Détecter les projets pour détecter les objets du projet, y compris les plans (tableaux), les référentiels et les pipelines existants. Cela détectera également tous les projets de votre organisation.
    • Sélectionnez Configurer les projets pour configurer les webhooks du projet.
    • Si vous êtes sur la page des enregistrements d’outils, sélectionnez Configurer les projets et entrez les informations d’identification de l’utilisateur d’intégration pour obtenir la liste des projets non configurés dans votre organisation. Sélectionnez les projets pour lesquels vous souhaitez configurer des webhooks, puis sélectionnez Configurer.
    • Pour importer des données historiques dans des objets de projet tels que des plans, des référentiels ou des pipelines, associez les objets à une application et importez les données. Pour plus d'informations, consultez Associer des objets d’outil à des applications : espace de travail.