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

Installer et configurer l’extension DevOps pour Azure DevOps envoyer des notifications de version et de mise en production de votre pipeline Azure à Changements de vélocité 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 pour 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 à Changements de vélocité DevOpsla section Artefacts et packages.

• Connexion au service ServiceNow DevOps

  Requis pour connecter le pipeline Azure à ServiceNow

• Porte de la mise en production ServiceNow DevOps

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

Azure : tâches personnalisées de pipeline de génération (CI) :

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

    Nécessaire pour que les tâches sans agent (serveur) enregistrent un artefact dans l’instance ServiceNow

  • Serveur ServiceNow DevOps Inscription du package Tâche personnalisée

    Nécessaire pour que les tâches sans agent (serveur) enregistrent un package dans l’instance ServiceNow

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

    Nécessaire pour que les tâches sans agent (serveur) créent automatiquement une demande de changement dans ServiceNow Gestion des changements le 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 Obtenir la tâche personnalisée de changement

    Nécessaire pour récupérer le numéro de demande de changement dans un pipeline basé sur les détails d’un changement spécifique pour 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 de l’artefact de l’agent ServiceNow DevOps

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

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

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

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

    Nécessaire pour récupérer le numéro de demande de changement dans un pipeline basé sur les détails d’un changement spécifique 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 d’enregistrement de l’artefact de l’agent ServiceNow DevOps et d’enregistrement 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 version)
  • Tâche personnalisée d’inscription de ServiceNow DevOps Release Sonar (pour les pipelines de mise en production)
  Remarque :

  La tâche d’inscription 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 des résultats de sécurité de version ServiceNow DevOps (pour les pipelines de version)
  • Tâche personnalisée des résultats de sécurité de mise en production ServiceNow DevOps (pour les pipelines de mise en production)
  Remarque :

  La tâche Résultat de sécurité de version de ServiceNow DevOps 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 sélectionnez Installer.
3. À partir de 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	Choisissez 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	La sys_id de l’outil d’orchestration. Vous pouvez copier cette valeur à l’aide de la commande Copier sys_id du formulaire de l’outil d’orchestration. Si vous utilisez l’espace de travail, sélectionnez Autres options de formulaire ( ) > 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 ( ) > Copier sys_id sur le formulaire de connexion de l’outil Azure DevOps .
   Nom d'utilisateur	Saisissez devops.integration.user.
   Mot de passe	Mot de passe de l’utilisateur d’intégration DevOps.
   Jeton d'API	Jeton d’API pour la connexion au point de terminaison.
   Nom de la connexion au service	Entrer la connexion DevOps
   Accorder une autorisation d’accès à tous les pipelines	Sélectionnez la case à cocher.

Exemple

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

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

Configurer un pipeline Azure build (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 build (CI) Azure.

Avant de commencer

Rôle requis : sn_devops.admin

Procédure

1. Accédez à 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 pour le pipeline s’affiche avec le volet de recherche 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 dans la ligne. Par exemple, la tâche avant Serveur peut être Test. Dans le champ Détails de la demande de changement , définissez le code de fermeture et les champs de 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 de l’artefact de l’agent ServiceNow DevOps	Dans le champ Point de terminaison ServiceNow , saisissez Ma connexion. Dans le champ Charge utile des artefacts , entrez 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	update-change-request-details-in-an-azure-devops-pipeline.html
   Changement de mise à jour du serveur ServiceNow DevOps	update-change-request-details-in-an-azure-devops-pipeline.html
   Agent ServiceNow DevOps : obtenir un changement	update-change-request-details-in-an-azure-devops-pipeline.html
   Changement de mise à jour de l’agent ServiceNow DevOps	update-change-request-details-in-an-azure-devops-pipeline.html

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 de détails de 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 les artefacts et 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 la version 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 d’étape de la première tâche de cette étape.

Les phases d’un pipeline de mise en production Azure sont mappées à une étape. Le nom d’étape d’une tâche multi-configuration ou multi-agent doit inclure uniquement le nom de la phase et non le nom de tâche réel dérivé lors 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, accédez à votre pipeline de mise en production et ouvrez la fenêtre Conditions de pré-déploiement.
2. Activez le paramètre Gates et cliquez sur +Ajouter.
3. Cliquez sur la porte de la version ServiceNow DevOps et sélectionnez le point de terminaison ServiceNow.
4. Quittez la configuration de porte de mise en production et développez la section Options d’évaluation pour configurer les champs de durée.

   Temps entre les réévaluations des portails

   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 continue de réévaluer l’état de la demande de changement à l’intervalle configuré jusqu’au délai d’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 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 les heures de début et de fin sont définies par défaut sur l’heure système actuelle.

5. Facultatif : Configurez les artefacts dans votre pipeline de mise en production Azure (CD).
   Pour configurer des artefacts à l’aide du 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é de 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 génération, vous pouvez sélectionner des artefacts parmi les huit autres sources. Pour suivre les détails de la validation et de l’élément de travail, suivez ces règles.

   • Lorsque la source est le pipeline de build, 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 build, 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 5. ServiceNow DevOps extension pour Azure DevOps - Release Gate

Figure 6. Configuration de la porte de pré-déploiement du pipeline de mise en production Azure

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

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