Intégrer Azure DevOps à Vélocité de changement DevOps — Catalogue de services

Créez, connectez, détectez et configurez votre Azure DevOps instance à l’aide du ServiceNow Catalogue de services.

Avant de commencer

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

Procédure

1. Accédez à la Tout > Catalogue de services > Définitions de catalogues > Gérer les éléments et recherchez DevOps.
   Remarque :

   Vous pouvez également accéder au catalogue de services à partir de ou du portail de Centre des employés services.
2. Parmi les éléments de catalogue, sélectionnez et activez DevOps DevOpsApp Onboarding et DevOps Tool Onboarding.
3. Après l’activation, sélectionnez Intégration de l’outil DevOps , puis Essayer.
4. Dans le formulaire Intégration de l’outil DevOps , saisissez les détails de l’outil :

   Champ	Description
   Nom de l'outil	Nom de votre Azure DevOps intégration.
   Intégration d'outils	Sélectionnez Azure DevOps.
   Se connecter à une organisation ou à un projet	Sélectionnez dans la liste. Connecter une organisation : connectez-vous directement au niveau de votre Azure DevOps organisation. Tous les projets au sein de l’organisation seront détectés et vous pourrez choisir de configurer plusieurs projets au sein de l’organisation. Connecter un projet : connectez-vous directement au niveau du projet.
   URL de l'outil	Azure DevOps l’URL de l’organisation (par exemple, https://dev.azure.com/< votre organisation > ou l’URL du Azure DevOps projet (par exemple, https://dev.azure.com/< votre organisation >/< votre projet>.
   Type d'informations d'identification	Type d’informations d’identification, authentification de base ou OAuth 2.0. Authentification de base Saisissez le nom d’utilisateur de votre instance ADO. Saisissez le jeton d’accès personnel (PAT) ou le mot de passe de votre Azure DevOps instance. Remarque : 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 un accès complet. Consultez Azure DevOps Périmètres PAT pour DevOps. OAuth 2.0 Conditions préalables : Créer un locataire dans Microsoft Entra Ajouter un utilisateur au locataire dans Microsoft Entra Créer une organisation dans le portail Azure Créer une Azure DevOps application S’inscrire Azure DevOps en tant que fournisseur OAuth Configurer les paramètres au niveau de l’organisation et du projet Créer un enregistrement d’informations d’identification et obtenir un jeton OAuth Dans le champ Informations d’identification de l’outil , sélectionnez un enregistrement d’informations d’identification de l’outil OAuth 2.0. Remarque : Seuls les enregistrements qui ne sont pas utilisés et configurés pour ADO peuvent être sélectionnés comme enregistrement d’informations d’identification existants.
   Voulez-vous configurer le Webhook pour cet outil ?	Option permettant d’activer la configuration automatique des webhooks pour Azure DevOps. Sélectionnez cette option pour activer. Remarque : Cette option n’est pas disponible si vous vous connectez au niveau de l’organisation. Vous pouvez configurer les webhooks à partir de la page des enregistrements d’outils.
   Nom d'utilisateur d'intégration	Ce champ n’est disponible que lorsque l’option de configuration du webhook est sélectionnée. Saisissez le nom d’utilisateur du compte d’utilisateur d’intégration 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 nécessaire, les webhooks sont configurés à l’aide de l’authentification basée sur les jetons. Lorsque Configuration DevOps est installée ou que l’opération Connexion générique lors de la configuration pour Azure DevOps est activée, vous pouvez régénérer le jeton (configuration automatique avec un nouveau jeton) à partir de l’interface utilisateur de l’espace de travail uniquement, ce qui met à 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 l’authentification basée sur les jetons. Regénérez votre jeton périodiquement pour une meilleure sécurité. .
   Mot de passe de l'utilisateur d'intégration	Ce champ n’est disponible que lorsque l’option de configuration du webhook est sélectionnée. Saisissez le mot de passe du compte d’utilisateur d’intégration 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 nécessaire, les webhooks sont configurés à l’aide de l’authentification basée sur les jetons. Lorsque Configuration DevOps est installée ou que l’opération Connexion générique lors de la configuration pour Azure DevOps est activée, vous pouvez régénérer le jeton (configuration automatique avec un nouveau jeton) à partir de l’interface utilisateur de l’espace de travail uniquement, ce qui met à 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 l’authentification basée sur les jetons. Regénérez votre jeton périodiquement pour une meilleure sécurité.
   Utiliser un Serveur MID	Facultatif. Sélectionnez une option Serveur MID pour un outil sur site joint à un Serveur MID. L’application est automatiquement définie sur DevOps REST.

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

5. Sélectionnez Commander maintenant.
   Une demande a été créée. Lorsque la demande est approuvée :

   • En cas de connexion à une organisation, l’outil est créé.
   • En cas de connexion à un projet, l’outil est créé, connecté et les objets de projet tels que les plans, les référentiels et les pipelines sont détectés.

Lors de la connexion à un projet, pour les objets détectés, vous pouvez importer des données historiques depuis l’outil et également y associer une application.

6. Dans les éléments de DevOps catalogue, sélectionnez Intégration de l’application DevOps.
7. Sélectionnez Essayer.
8. Dans le formulaire Intégration de DevOps l’application, saisissez les détails :

   Créez-vous une nouvelle application ou complétez-vous une application existante ?	Sélectionnez parmi les options s’il faut créer une nouvelle application ou utiliser une application existante.
   Application	Saisissez le nom de l’application que vous créez ou utilisez.
   Pipelines d'intégration	Entrez le nom de l’outil connecté Azure DevOps .
   Pipelines	Sélectionnez les pipelines pour lesquels vous souhaitez importer des données d’historique.
   Référentiels de l'artefact	Sélectionnez les artefacts pour lesquels vous souhaitez importer des données historiques.
   Référentiels d'intégration	Entrez le nom de l’outil connecté Azure DevOps .
   Importer depuis et Importer vers	Sélectionnez les dates pour lesquelles vous souhaitez importer les données de pipeline et d’artefact. Par défaut, les 30 derniers jours sont sélectionnés. Vous pouvez choisir d’importer des données pour une période maximale de 90 jours.
   Référentiels	Sélectionnez les référentiels pour lesquels vous souhaitez importer des données historiques.
   Importer depuis et Importer vers	Sélectionnez les dates pour lesquelles vous souhaitez importer les données des référentiels. Par défaut, les 30 derniers jours sont sélectionnés. Vous pouvez choisir d’importer des données pour une période maximale de 90 jours.
   Plans d'intégration	Entrez le nom de l’outil connecté Azure DevOps .
   Plans	Sélectionnez les plans pour lesquels vous souhaitez importer des données historiques.
   Importer depuis et Importer vers	Sélectionnez les dates pour lesquelles vous souhaitez importer les données du plan. Par défaut, les 30 derniers jours sont sélectionnés. Vous pouvez choisir d’importer des données pour une période maximale de 90 jours.

9. Sélectionnez Commander maintenant.
   Une demande a été créée. Lorsque la demande est approuvée, les plans, les référentiels, les artefacts et les objets de pipeline sont associés à l’enregistrement d’application, et les webhooks sont configurés pour le suivi en temps réel. Les données historiques sont importées pour les éléments sélectionnés. Le champ Suivre est automatiquement activé pour les plans, référentiels et pipelines importés. Pour les référentiels, l’option Suivre les modifications de fichiers est également activée automatiquement.