Utiliser l’extension pour Azure DevOps et Azure DevOps les ServiceNow DevOps actions personnalisées

Installez et configurez l’extension DevOps pour Azure DevOps afin d’envoyer des notifications de version et de mise en production de votre pipeline Azure à Vélocité de changement DevOps.

Avant de commencer

Rôle requis : sn_devops.admin

Pourquoi et quand exécuter cette tâche

Vous pouvez utiliser l’extension ServiceNow DevOps sur Visual Studio Marketplace - Extensions for Azure DevOps pour intégrer votre pipeline Azure à l’application ServiceNow DevOps . Pour plus d’informations sur les artefacts et les packages dans , reportez-vous à Vélocité de changement DevOps la section Artefacts et packages.

• Connexion au service ServiceNow DevOps

  Requis pour connecter le pipeline Azure à ServiceNow

• Porte de mise en production ServiceNow DevOps

  Nécessaire pour activer le contrôle des changements dans les pipelines de mise en production Azure (CD) (dans des conditions de prédéploiement uniquement).

Tâches personnalisées de pipeline de version Azure (CI) :

• Tâche (serveur) sans agent
  • Tâche personnalisée d’inscription de l’artefact du serveur ServiceNow DevOps

    Requis pour les tâches sans agent (serveur) afin d’enregistrer un artefact dans l’instance ServiceNow

  • Tâche personnalisée d’inscription du package de serveur ServiceNow DevOps

    Requis pour les tâches sans agent (serveur) afin d’enregistrer un package dans l’instance ServiceNow

  • Tâche personnalisée d’accélération du changement de serveur ServiceNow DevOps

    Requis pour que les tâches sans agent (serveur) créent automatiquement une demande de changement dans ServiceNow Gestion des changements le cadre du pipeline Azure.

    Remarque :

    La tâche d’accélération des changements de serveur ServiceNow DevOps ne nécessite pas de tâches de notification de tâche de serveur ServiceNow DevOps .
  • Serveur ServiceNow DevOps Tâche personnalisée Obtenir un changement

    Nécessaire pour récupérer le numéro de demande de changement dans un pipeline en fonction des détails de changement spécifiques d’une tâche de serveur.

  • Tâche personnalisée de changement de mise à jour du serveur ServiceNow DevOps

    Nécessaire pour mettre à jour les détails de la demande de changement associés à un pipeline pour une tâche de serveur.

• Tâche d’agent
  • Tâche personnalisée d’inscription d’artefact d’agent ServiceNow DevOps

    Requis pour que les tâches d’agent enregistrent un artefact dans l’instance ServiceNow

  • Tâche personnalisée d’inscription du package d’agent ServiceNow DevOps

    Requis pour les tâches d’agent afin d’enregistrer un package dans l’instance ServiceNow

  • Tâche personnalisée Obtenir un changement d’agent ServiceNow DevOps

    Nécessaire pour récupérer le numéro de demande de changement dans un pipeline en fonction des détails de changement spécifiques pour une tâche d’agent.

  • Tâche personnalisée de changement de mise à jour de l’agent ServiceNow DevOps

    Nécessaire pour mettre à jour les détails de la demande de changement associés à un pipeline pour une tâche d’agent.

  Remarque :

  Les tâches Inscription de l’artefact de l’agent ServiceNow DevOps et Inscription du package de l’agent ServiceNow DevOps ne sont pas prises en charge pour les pipelines de mise en production.
• Analyses de la qualité logicielle (SonarQube/SonarCloud)
  • Tâche personnalisée d’inscription de sonar de version ServiceNow DevOps (pour les pipelines de build)
  • Tâche personnalisée d’inscription du sonar de mise en production de ServiceNow DevOps (pour les pipelines de mise en production)
  Remarque :

  La tâche d’enregistrement ServiceNow DevOps Build Sonar n’est pas prise en charge pour les pipelines de mise en production.
• Analyses de sécurité :
  • Tâche personnalisée Résultats de la sécurité de création de ServiceNow DevOps (pour les pipelines de build)
  • Tâche personnalisée des résultats de sécurité de la mise en production de ServiceNow DevOps (pour les pipelines de mise en production)
  Remarque :

  La tâche de résultat de sécurité de version DevOps de ServiceNow n’est pas prise en charge pour les pipelines de mise en production.

Procédure

1. Accédez à Visual Studio Marketplace, recherchez l’extension ServiceNow DevOps et cliquez sur Obtenir gratuitement.

   

2. Sélectionnez votre Azure DevOps organisation, puis Installer.
3. Depuis votre Azure DevOps projet, accédez à Paramètres du projet > Pipelines > Connexions de service.
4. Sélectionnez Nouvelle connexion de service , puis dans la liste, sélectionnez ServiceNow DevOps.
5. Sélectionnez Suivant et saisissez les détails suivants :

   Méthode d'authentification	Indiquez si l’authentification est effectuée via la méthode basée sur les jetons ou la méthode de base.
   Instance ServiceNow	https://<votre-instance>.service-now.com/
   ID d'outil	Le sys_id de l’outil d’orchestration. Vous pouvez copier cette valeur à l’aide de la commande Copier sys_id du formulaire Outil d’orchestration. Si vous utilisez l’espace de travail, sélectionnez Plus d’options de formulaire (icône ) > Copier sys_id sur le formulaire de connexion de l’outil Azure DevOps . Si vous utilisez Service Catalog ou Classic, sélectionnez Actions supplémentaires (icône ) > Copier sys_id sur le formulaire de connexion de l’outil Azure DevOps .
   Nom d'utilisateur	Entrez devops.integration.user. 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 désactivée. Si cette étape n’est pas nécessaire, les webhooks sont configurés à l’aide de l’authentification basée sur les jetons.
   Mot de passe	Mot de passe de l’utilisateur DevOps Integration. 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 désactivée. Si cette étape n’est pas nécessaire, les webhooks sont configurés à l’aide de l’authentification basée sur les jetons.
   Jeton d'API	Jeton d’API pour la connexion au point de terminaison.
   Nom de la connexion de service	Entrer la connexion DevOps
   Accorder l’autorisation d’accès à tous les pipelines	Cochez la case.

Exemple

Figure 1. Pipeline Azure : connexion au service ServiceNow DevOps méthode d’authentification de base

Figure 2. Pipeline Azure : méthode d’authentification basée sur un jeton de connexion de service ServiceNow DevOps

Configurer un pipeline de version Azure (CI) dans DevOps

Utilisez l’extension pour Azure DevOps configurer le ServiceNow DevOps contrôle des changements, les artefacts et les packages dans votre pipeline de version Azure (CI).

Avant de commencer

Rôle requis : sn_devops.admin

Procédure

1. Accédez aux pipelines dans votre instance Azure DevOps.
2. Sélectionnez le pipeline pour lequel vous souhaitez activer le contrôle des changements.
3. Sélectionnez Afficher.
   L’éditeur YAML du pipeline s’affiche avec le volet de recherche de tâches sur la droite.
4. Recherchez l’action personnalisée requise dans le volet Tâches et sélectionnez-la.

   Action personnalisée	Étapes
   Accélération du changement de serveur ServiceNow DevOps	Dans le champ Nom d’affichage , saisissez Accélération du changement ServiceNow. Dans le champ Point de terminaison ServiceNow , saisissez Ma connexion. Dans le champ Tâche exécutée en amont , saisissez la valeur qui indique la tâche précédente en ligne. Par exemple, la tâche avant le serveur peut être Test. Dans le champ Détails de la demande de changement , définissez le code de fermeture et les champs Demande de changement à partir du pipeline. Sélectionnez l’icône d’informations pour afficher l’exemple de sortie. Pour plus d’informations sur l’accélération du changement, consultez Accélération du changement.
   Registre d’artefact d’agent ServiceNow DevOps	Dans le champ Point de terminaison ServiceNow , saisissez Ma connexion. Dans le champ Charge utile des artefacts , saisissez le JSON contenant la liste des artefacts. Pour plus d’informations sur les artefacts, reportez-vous à la section Artefacts et packages.
   Registre du package de l’agent ServiceNow DevOps	Dans le champ Point de terminaison ServiceNow , saisissez Ma connexion. Dans le champ Nom du package , entrez le nom du package qui contient des artefacts. Dans le champ Charge utile des artefacts , saisissez le JSON contenant les détails de la version et la liste des artefacts. Pour plus d’informations sur les artefacts, reportez-vous à la section Artefacts et packages.
   Serveur ServiceNow DevOps Obtenir un changement	Obtenir et mettre à jour les détails de la demande de changement dans le Azure DevOps pipeline
   Changement de mise à jour du serveur ServiceNow DevOps	Obtenir et mettre à jour les détails de la demande de changement dans le Azure DevOps pipeline
   Agent ServiceNow DevOps Obtenir le changement	Obtenir et mettre à jour les détails de la demande de changement dans le Azure DevOps pipeline
   Changement de mise à jour de l’agent ServiceNow DevOps	Obtenir et mettre à jour les détails de la demande de changement dans le Azure DevOps pipeline

5. Sélectionnez Ajouter pour ajouter la tâche personnalisée à la section Tâches de votre pipeline Azure.

Exemple

Figure 3. Pipeline Azure : tâche personnalisée d’accélération du changement ServiceNow DevOps

Figure 4. Exemple des détails de la demande de changement

Configurer un pipeline de mise en production Azure (CD) dans DevOps

Utilisez l’extension pour Azure DevOps configurer le ServiceNow DevOps contrôle des changements, ainsi que des artefacts et des packages dans votre pipeline de mise en production Azure (CD).

Avant de commencer

Rôle requis : sn_devops.admin

Pourquoi et quand exécuter cette tâche

Remarque :

Le contrôle des changements dans les pipelines de mise en production Azure (CD) est pris en charge uniquement dans les portails de pré-déploiement. Les demandes de changement de porte de prédéploiement sont mappées à l’exécution de l’étape de la première tâche à cette étape.

Les phases d’un pipeline de mise en production Azure sont mappées à une étape. Le nom de l’étape d’une tâche multi-configuration ou multi-agent doit inclure uniquement le nom de la phase et non le nom de la tâche réel dérivé au moment de l’exécution du pipeline.

Les exécutions de tâches pour les tâches ignorées sont marquées comme ayant échoué.

Procédure

1. Dans Azure DevOps Pipelines, sélectionnez Pipelines > mises en production, puis sélectionnez votre pipeline de mise en production.
2. Sélectionnez Modifier pour ouvrir l’éditeur de pipeline.
3. Sélectionnez l’icône de pré-déploiement ( ) pour votre étape, puis cliquez sur le bouton bascule pour activer les portes.
4. Sélectionnez +Ajouter, puis sélectionnez Porte de mise en production ServiceNow DevOps.
5. Sélectionnez la porte de mise en production ServiceNow DevOps , puis sélectionnez le point de terminaison ServiceNow.
6. Quittez la configuration de la porte de mise en production et développez la section Options d’évaluation pour configurer les champs de synchronisation suivants.

   Délai entre la réévaluation des points de contrôle

   Intervalle de réévaluation en minutes, heures ou jours. Si la demande de changement est annulée ou rejetée, la porte de mise en production du pipeline Azure réévalue en permanence l’état de la demande de changement à l’intervalle configuré jusqu’à l’expiration. Aucune intervention de l’utilisateur n’est requise pour d’autres tentatives de réévaluation une fois que la demande de changement a déjà été approuvée, rejetée ou annulée.

   Délai d’expiration après lequel les portes échouent

   Valeur du délai d’expiration en minutes, heures ou jours. Si les conditions de prédéploiement échouent, les tâches suivantes de l’étape sont marquées comme ayant échoué et l’heure de début et de fin est définie par défaut sur l’heure actuelle du système.

   Figure 5. Configuration des portes de pré-déploiement du pipeline de mise en production Azure

   

7. Facultatif : Configurez les artefacts dans votre pipeline de mise en production Azure (CD).
   Pour configurer des artefacts en utilisant le pipeline de version comme source, ces noms doivent correspondre.

   • Nom du référentiel et nom du pipeline de version (par exemple, DeployableRepo).
   • Propriété du nom de l’artefact de pipeline de version et propriété d’alias source de l’artefact de pipeline de mise en production (par exemple, BuildDrop).

   En plus du pipeline de version, vous pouvez sélectionner des artefacts à partir de huit autres sources. Pour suivre les détails de validation et d’élément de travail, suivez ces règles.

   • Lorsque la source est le pipeline de version, la propriété de version sémantique des artefacts doit être au format MAJOR. MINEUR. PATCH (par exemple 5.1.3).
   • Lorsque la source n’est pas le pipeline de version, définissez une version sémantique en implémentant l’interface d’extension DevOpsArtifactSemanticVersionAPI .

   Voir Artefacts et packages pour plus d’informations sur les artefacts.

Exemple

Figure 6. Configuration de l’artefact : source de pipeline de version

Figure 7. Configuration de l’artefact : pipeline de mise en production