Erreurs courantes dans Vélocité de changement DevOps

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 17 minutes de lecture

    • Identifiez la cause première des erreurs qui se produisent dans Vélocité de changement DevOpset découvrez les étapes correspondantes susceptibles de les résoudre.

    Connexion de l’outil

    Ce tableau répertorie les étapes nécessaires pour résoudre les erreurs qui peuvent se produire lorsque vous sélectionnez le bouton Soumettre ou Connecter après avoir saisi les détails de l’outil dans le processus de connexion de l’outil :

    Message Action
    L’outil ne peut pas être créé car le nom de l’outil n’a pas été saisi. Entrez le nom de l’outil, puis réessayez. Saisissez à nouveau le nom de l’outil.
    L’outil ne peut pas être créé car l’intégration de l’outil n’a pas été sélectionnée. Sélectionnez la valeur d’intégration d’outils correcte, puis réessayez. Sélectionnez la valeur d’intégration d’outils correcte.
    L’outil ne peut pas être créé car l’URL de l’outil n’est pas valide ou est incorrecte. Entrez de nouveau l’URL de l’outil, puis réessayez. Saisissez à nouveau l’URL de l’outil.
    L’outil ne peut pas être créé car la version de la plateforme ne peut pas être déterminée. Créez la propriété système glide.buildtag.last et réessayez.
    1. Accédez à la Propriétés du > d’administration > DevOps.
    2. Vérifiez si la glide.buildtag.last sys propriété existe.
    3. Si ce n’est pas le cas, créez la glide.buildtag.last sys propriété.
    L’outil ne peut pas être créé, car la connexion de l’outil CreateDevOps associée n’est pas valide. Créez un alias de connexion valide, puis réessayez.
    1. Accédez à la Toutes les connexions et informations d’identification > > alias de connexion et d’informations d’identification et ouvrez l’enregistrement CreateDevOpsTool .
    2. Dans la liste connexe Connexions, créez un enregistrement et entrez un nom pour la connexion.
    3. Dans le formulaire Connexion, sélectionnez la liste de recherche du champ Informations d’identification , puis sélectionnez Nouveau pour créer des informations d’identification administrateur.
    4. Sélectionnez Informations d’identification pour l’authentification de base et entrez un nom.
    5. Saisissez le nom d’utilisateur et le mot de passe d’administrateur (requis pour accéder aux outils de votre environnement DevOps).

      Un utilisateur disposant connection_admin rôle peut configurer une connexion HTTP.

    6. Sur le formulaire Connexion, entrez https://<nom d’instance>.service-now.com/ pour l’URL de connexion.
    L’outil ne peut pas être créé, car les informations d’identification de l’alias CreateDevOpsTool sont incorrectes. Mettez à jour l’enregistrement des informations d’identification et réessayez.
    1. Sélectionnez le lien d’enregistrement des informations d’identification dans le message. Si vous vous connectez à l’outil à partir de l’interface utilisateur de l’espace de travail, cliquez avec le bouton droit sur le lien d’enregistrement des informations d’identification, puis sélectionnez Ouvrir dans un nouvel onglet.
    2. Sur la page d’enregistrement des informations d’identification, saisissez les informations d’identification correctes dans les champs Nom d’utilisateur et Mot de passe .
    3. Enregistrez les changements et réessayez de vous connecter à l’outil.
    L’outil ne peut pas être créé, car l’URL de connexion de l’alias CreateDevOpsTool est incorrecte. Utilisez l’URL suivante : https://<instancename>.service-now.com et réessayez.
    1. Accédez à la Toutes les connexions et informations d’identification > > alias de connexion et d’informations d’identification et ouvrez l’enregistrement CreateDevOpsTool .
    2. Sur le formulaire Connexion, entrez https://<nom d’instance>.service-now.com/ pour l’URL de connexion.
    Pour créer un alias de connexion, vous avez besoin du rôle connection_admin. Contactez votre administrateur système. Cette erreur se produit si le champ Alias de connexion est vide pour un enregistrement d’outil. Pour créer la connexion de l’outil, vous avez besoin d’un alias de connexion. Seul un utilisateur ayant leconnection_admin rôle peut créer un alias de connexion. Vous devez contacter un utilisateur disposant de ce rôle, comme un administrateur, et créer l’alias de connexion.
    L’outil ne peut pas être créé car le nom d’outil <nom d’outil> existe déjà. Entrez un autre nom et réessayez. Utilisez un nom différent pour l’outil.
    L’outil ne peut pas être créé, car le <nom d’outil> ne dispose pas d’une configuration de Serveur MID valide. Configurez un serveur MID valide, puis réessayez.
    1. Si vous utilisez l’espace de travail, vérifiez si le Serveur MID est en cours d’exécution et accessible.
    2. Si vous utilisez le catalogue et le créateur d’enregistrement, vérifiez si le serveur MID est en cours d’exécution et accessible avec l’application en tant que DevOps et l’aptitude en tant que REST.
    L’outil ne peut pas être créé car aucun alias de connexion et d’informations d’identification n’est disponible pour le périmètre de DevOps Data Model. Créez un alias de connexion et d’informations d’identification, puis réessayez.

    Cette erreur se produit pour l’authentification OAuth.

    1. Accédez à la Toutes les connexions et informations d’identification > > alias de connexion et d’informations d’identification.
    2. Créez un alias avec l’application en tant que modèle de données DevOps.
    L’outil ne peut pas être créé en raison d’un problème technique lors de la création de l’enregistrement d’informations d’identification.
    1. Accédez à la Tous les > Automatisation des processus > Concepteur de flux > exécutions.
    2. Vérifiez la dernière exécution du flux secondaire sn_devops.devops_create_credentials pour connaître les détails de l’erreur.
    Impossible de créer l'outil, car des informations d'identification et un domaine pour un enregistrement actif existent déjà.

    Cette erreur se produit pour l’authentification OAuth.

    1. Utilisez des informations d’identification différentes.
    2. Vérifiez si les informations d’identification existantes sont utilisées par une connexion active.
    L’outil ne peut pas être créé en raison d’un problème technique lors de la création de l’enregistrement de connexion.
    1. Accédez à la Tous les > Automatisation des processus > Concepteur de flux > exécutions.
    2. Vérifiez la dernière exécution de l’action sn_devops.create_connection_for_tool pour connaître les détails de l’erreur.
    L’outil ne peut pas être créé pour les raisons suivantes :
    • Le flux secondaire de validation n’est pas configuré et
    • Un enregistrement d’aptitude d’intégration portant le même nom de flux secondaire n’existe pas pour l’intégration de l’outil associée.
    Configurez le flux secondaire et créez l’enregistrement d’aptitude d’intégration avec l’action Valider et un nom de flux secondaire pour l’intégration de l’outil, puis réessayez.

    Cette erreur se produit uniquement pour les intégrations d’outils personnalisés.

    1. Accédez à la Tous les > Automatisation des processus > Concepteur de flux.
    2. Sur la page Concepteur de flux, sélectionnez l’onglet Flux secondaires .
    3. Ouvrez l’enregistrement Flux secondaire de validation de démonstration DevOps à partir de la liste.
    4. Dans la section Actions, ouvrez l’enregistrement de l’action de validation de démonstration DevOps en sélectionnant l’icône Ouvrir l’action dans le concepteur d’action ( icône Ouvrir l’action dans le concepteur d’action).
    5. Sélectionnez le menu Plus d’actions > Action de copie.Boîte de dialogue Action de copie
    6. Saisissez un nouveau nom pour l’action et sélectionnez l’application en tant qu’intégrations DevOps, puis sélectionnez Copier.
    7. Dans l’action copiée, sélectionnez Entrées > l’étape REST.
    8. Dans la section Détails de la demande, saisissez le chemin d’accès de la ressource de votre outil personnalisé dans le champ Chemin d’accès de la ressource.Écran Valider l’action
    9. Entrez la version de l’API de votre outil personnalisé dans le champ Paramètres de requête .
    10. Enregistrez les changements.
    11. Publiez l’action en sélectionnant Publier.
    12. Revenez à l’enregistrement du flux secondaire de validation de démonstration DevOps .
    13. Sélectionnez le menu Actions supplémentaires > Copier le flux secondaire.
    14. Saisissez un nouveau nom pour le flux secondaire et sélectionnez l’application en tant qu’intégrations DevOps, puis sélectionnez Copier.
    15. Dans le flux secondaire copié, supprimez l’action de validation de démonstration DevOps et ajoutez l’action que vous avez créée à l’étape 11.Ajouter un nouvel enregistrement d’action
      1. Dans le champ Action , sélectionnez l’action que vous avez créée à l’étape 11.
      2. Dans le champ aliasGR , sélectionnez l’enregistrement Alias de connexion et d’informations d’identification dans la section Données > rechercher des enregistrements .
      3. Dans le champ apiversion , sélectionnez la version de l’API dans la section Entrées de flux secondaire > de données .
      4. Enregistrez les changements.
    16. Publiez le flux secondaire en sélectionnant Publier.
    17. Accédez à la DevOps : intégrations > > options d’intégration et créez un enregistrement avec l’action Valider .

      Pour plus d’informations, consultez Créer une intégration d’outil DevOps.

      Onglet connexe Options d’intégration
    18. Associez le flux secondaire que vous avez créé à l’étape 16 à l’enregistrement d’aptitude d’intégration.
    L’outil ne peut pas être créé en raison d’un problème de connectivité. Consultez le flux secondaire de <validate_subflow_name> pour en savoir plus, puis réessayez.
    1. Accédez à la Tous les > Automatisation des processus > Concepteur de flux > exécutions.
    2. Vérifiez la dernière exécution de <validate_subflow_name> flux secondaire pour connaître les détails de l’erreur.
    Les informations d’identification d’autorisation de l’outil ne sont pas valides. Entrez des informations d’identification valides, puis réessayez. Saisissez à nouveau le nom d’utilisateur/mot de passe correct pour l’outil.
    L’outil ne peut pas être créé car il n’y a pas de réponse reçue du serveur. Entrez une URL d’outil valide ou vérifiez si le serveur est en cours d’exécution, puis réessayez.
    1. Saisissez à nouveau l’URL de l’outil.
    2. Vérifiez le MID Server.
    L’URL de connexion est incorrecte, vérifiez les

    URL et réessayez.

    		 Saisissez à nouveau l’URL de l’outil.
    L’outil ne peut pas être connecté parce que le nom de la slug de l’application GitHub est incorrect. Saisissez le nom de slug de l’application GitHub correct et réessayez. Vous pouvez trouver le nom de la slug de l’application GitHub sur la page des paramètres de votre GitHub application. Le GitHub nom de la slug de l’application est le nom convivial de votre GitHub application. Par exemple, si vous avez créé une GitHub application portant le nom Test App, le nom de la slug de l’application URL GitHub correspondante sera test-app. Dans votre GitHub URL : « https://github.com/settings/apps/test-app », « test-app » est le nom de la slug de l’application GitHub . Pour plus d’informations, consultez la documentation GitHub.
    La valeur du mot de passe est trop longue et peut être tronquée après le chiffrement. Veuillez réduire la longueur du mot de passe ou augmenter la taille du champ. À partir du 18 janvier 2023, Jira a étendu la durée des jetons API pour les comptes Atlassian. Vous devez augmenter la valeur maximale du mot de passe à plus de 255 dans la table discovery_credentials pour tenir compte de la longueur étendue des caractères. Pour plus d’informations, consultez l’article de la base de connaissances KB1269878 et la documentation Atlassian.
    Comportement inattendu de l’hôte distant : redirection circulaire vers « https://bitbucket.org/account/signin/?next=%2F...%2Frest%2Fapi%2F1.0%2Fusers ». Cette erreur peut se produire si vous essayez de vous connecter à une instance BitBucket Cloud. BitBucket Cloud n’est pas pris en charge. Vous devez utiliser une instance de BitBucket Server pour vous connecter à ServiceNow DevOps. Connectez-vous à votre instance Bitbucket via un serveur MID. Un Serveur MID est requis si votre instance d’outil est hébergée sur site. Pour plus d’informations sur le serveur MID, voir Sélection du serveur MID 
    Mismatch in tool URL:
Tool URL entered in ServiceNow below: https://<URL of the Jenkins instance you entered>
Tool URL entered in Jenkins: https://<Jenkins location URL entered in Jenkins>
In Jenkins, under Manage Jenkins > System, check that your configured Jenkins URL is the same as the Tool URL entered here.
See the troubleshooting tool on-boarding errors.

    Cette erreur se produit lorsque l’URL Jenkins saisie est DevOps différente de celle Jenkins saisie dans votre Jenkins instance.

    Depuis votre Jenkins instance, accédez à Gérer Jenkins > Système > Emplacement Jenkins. L’URL Jenkins saisie ici doit correspondre à l’URL de l’instance Jenkins saisie dans DevOps.

    Autorisations des outils

    Cette section répertorie les étapes nécessaires pour résoudre les erreurs d’autorisation d’outil lorsque vous créez un outil DevOps à l’aide de playbooks de l’espace de travail. Les directives de vérification des autorisations d’outils s’affichent dans une fenêtre contextuelle lorsque vous vous connectez à un outil à partir de l’espace de travail.

    Action

    Si une autorisation est manquante, procédez comme suit :

    • Mettez à jour les autorisations pour les informations d’identification fournies dans l’outil DevOps externe. Sélectionnez Actualiser dans la fenêtre contextuelle pour effectuer à nouveau les vérifications.
    • Fermez la fenêtre contextuelle, utilisez des informations d’identification différentes et sélectionnez à nouveau Se connecter . La fenêtre contextuelle de vérification des autorisations apparaît avec les résultats des informations d’identification nouvellement saisies.
    • Examinez la colonne Impact, et si l’impact n’affecte pas votre cas d’utilisation, sélectionnez Continuer quand même.
    Si toutes les vérifications d’autorisation réussissent :
    Propriété du délai d’expiration de la vérification des autorisations d’outils

    Pendant le processus de connexion de l’outil, le système effectue des validations d’autorisation au premier plan et restreint la page de connexion de l’outil. Pour chaque validation d’autorisation, un appel d’API REST est effectué vers des outils externes afin d’évaluer la disponibilité de l’autorisation. Le délai de réponse de l’API REST peut varier en fonction de vos paramètres réseau. Pour éviter les retards, vous pouvez spécifier combien de temps le système doit attendre pour obtenir une réponse d’un outil externe avant de marquer l’autorisation comme une erreur. Vous pouvez spécifier ce délai à l’aide de la propriété (sn_devops.permission_check_timeout)Délai d’expiration de la vérification des autorisations de l’outil par enregistrement (en millisecondes). Si vous constatez que certaines des vérifications d’autorisation entraînent une erreur, essayez d’augmenter la valeur du délai d’expiration et sélectionnez Actualiser dans la fenêtre contextuelle Autorisations.

    Notification de l’outil

    Ce tableau répertorie les étapes nécessaires pour résoudre les erreurs qui peuvent se produire dans des scénarios tels que la récupération des détails de la validation, des détails de l’exécution du pipeline, des détails de la demande d’extraction, des résumés de tests :

    Motif Action
    Les informations d'identification d'autorisation ne sont pas valides ou n'ont pas les autorisations minimales requises.
    • Vérifiez si les informations d’identification de vos outils tiers ont les champs d’application requis. Si vous utilisez l’interface utilisateur de l’espace de travail, vous pouvez accéder à l’enregistrement de l’outil, puis sélectionner Actions supplémentaires ( icône Plus d’actions) > Vérifier les autorisations des informations d’identification pour connaître les autorisations requises.
    • Vérifiez si vous avez saisi le nom d’utilisateur/mot de passe correct pour votre outil tiers. Si vous utilisez l’interface utilisateur de l’espace de travail et que vous souhaitez mettre à jour les informations d’identification de votre outil, accédez à l’enregistrement de l’outil et sélectionnez Actions supplémentaires ( icône Plus d’actions) > Vérifier les autorisations des informations d’identification. Pour plus d’informations sur la mise à jour des informations d’identification, reportez-vous à la section Mettre à jour les informations d’identification de l’outil tiers dans Vélocité de changement DevOps.
    Il n’y a aucune réponse du serveur. Vérifiez l’état de la connexion du serveur et réessayez.
    • Vérifiez que le serveur d’outils DevOps est accessible et réactif.
    • Si Serveur MID est configuré, vérifiez qu’il est opérationnel.
    Impossible de traiter la demande. Vérifiez si le nombre maximal d’instances associées à un webhook est dépassé. Si vous avez rencontré cette erreur pour GitHub, vérifiez si vous avez associé plus de 20 instances à un webhook.
    Les informations d'identification d'autorisation n'ont pas les autorisations minimales requises. Vérifiez si les informations d’identification de vos outils tiers ont les champs d’application requis. Si vous utilisez l’interface utilisateur de l’espace de travail, vous pouvez accéder à l’enregistrement de l’outil, puis sélectionner Actions supplémentaires ( icône Plus d’actions) > Vérifier les autorisations des informations d’identification pour connaître les autorisations requises.
    La configuration du serveur MID n’est pas valide. Configurez un serveur MID valide, puis réessayez. Vérifiez si le Serveur MID est en cours d’exécution et accessible.
    L’URL de connexion n’est pas valide. Entrez une URL valide, puis réessayez.
    1. Accédez à la Toutes les connexions et informations d’identification > > alias de connexion et d’informations d’identification et ouvrez l’enregistrement de connexion et d’informations d’identification requis.
    2. À partir de la liste connexe Connexions, ouvrez le formulaire Connexion connexe.
    3. Sur le formulaire Connexion , vérifiez si l’URL de connexion de l’outil tiers est correcte.
    Limite des taux dépassée. Réessayez après {0}.

    La limite de débit est le nombre d’appels d’API qu’une application ou un utilisateur peut effectuer au cours d’une période donnée. La limitation du débit est une technique permettant de limiter le trafic réseau afin d’éviter que les utilisateurs n’épuisent les ressources système. Si la limite de débit maximale autorisée dans votre outil tiers est dépassée, vous risquez de rencontrer cette erreur.
    Vos informations d'identification n'e possèdent pas les champs d'application requis. Vérifiez si les informations d’identification de vos outils tiers ont les champs d’application requis. Si vous utilisez l’interface utilisateur de l’espace de travail, vous pouvez accéder à l’enregistrement de l’outil, puis sélectionner Actions supplémentaires ( icône Plus d’actions) > Vérifier les autorisations des informations d’identification pour connaître les autorisations requises.

    Demande de changement

    Ce tableau répertorie les étapes requises pour résoudre les erreurs qui peuvent se produire lors de la création d’une demande de changement :

    Erreur Action
    Impossible de créer la demande de changement, car le marqueur de compatibilité type est désactivé. Activez le marqueur de compatibilité de type dans les propriétés système ou configurez le modèle de changement dans l’enregistrement d’étape dans ServiceNow, ou saisissez l’ID système du modèle de changement approprié dans le pipeline.
    • Accédez à toutes les propriétés système > et activez la com.snc.change_management.change_model.type_compatibility propriété, ou
    • Ajoutez le modèle de changement dans le formulaire Étape ou modifiez les attributs du pipeline.
    Impossible de créer une demande de changement car le type de changement ou le modèle de changement n'est pas configuré pour le pipeline. Ajoutez le type ou le modèle de changement dans le formulaire Étape ou les attributs de changement du pipeline.

    Erreurs générales

    Ce tableau répertorie les étapes nécessaires pour résoudre quelques erreurs générales qui peuvent se produire lors de l’utilisation de l’application Vélocité de changement DevOps.

    Problème Action
    La demande d’importation ne progresse pas

    Si une demande d’importation reste trop longtemps à l’état Demandé lors de l’exécution d’une importation pour un outil (tel que Jenkins, Jiraou GitHub ), supprimez la demande d’importation et réessayez.

    Remarque :
    Supprimez la demande existante pour réessayer d’importer la même plage.
    Échec de la connexion de l’outil

    Supprimez la barre oblique ('/') dans le champ URL de connexion du formulaire de connexion HTTP.
    Aucune demande de changement n’est créée pour une Jenkins tâche sous contrôle de changement Vérifiez que :
    • L’intégration de l’outil dans votre instance est correctement configurée.
    • La tâche a été synchronisée dans votre instance.
    • Les tâches et les étapes de l’application ont été configurées dans votre instance.
    La création d’une demande de changement n’est pas prise en charge si la tâche est sous contrôle de changement :
    • Ne fait pas partie d’un pipeline (est une tâche autonome, par exemple).
    • Est le premier dans le pipeline.
    • Se trouve dans le pipeline, mais l’utilisateur le déclenche manuellement ou effectue la sortie SCM directement sur la tâche sous contrôle des changements (ne déclenchant donc pas le pipeline depuis le début).
    Jenkins ne bloque pas la tâche sous contrôle de changement (n’attend pas l’approbation de la demande de changement)

    Vérifiez que l’emplacement Jenkins est configuré :

    Accédez à la Jenkins > Gérer Jenkins > Configurer le système et fournissez le nom d’hôte pour le champ URL Jenkins dans la Jenkins section Emplacement.

    Remarque :
    Pour éviter les problèmes de mise en cache, cliquez sur Enregistrer même si le champ URL Jenkins contient déjà une valeur lorsque vous ouvrez le formulaire pour la première fois.
    Événements se produisant dans le journal de charge utile avec l’état Non connecté
    Si l’un des éléments suivants change pour une connexion effectuée manuellement (en utilisant le mode de configuration manuelle), la connexion est automatiquement déconnectée.
    • Alias associé à l’outil
    • Type d’outil
    • Nouvelle connexion HTTP active pour le même domaine ajoutée à l’alias
    • Connexion HTTP existante pour le même domaine activée
    • URL de connexion de la connexion HTTP
    • Informations d’identification de la connexion HTTP
    • Utiliser Serveur MID le paramètre dans la connexion HTTP

    Passez en mode de configuration manuelle et reconnectez-vous.
    Réessayer les événements entrants qui échouent ou qui ont généré une erreur en raison de l’API REST TimeoutException/FlowObjectAPIException
    Mettez à jour la tâche planifiée pour réessayer de traiter les Retry Errored Inbound Events événements entrants qui sont dans Error l’état.
    • Mettez à jour la liste des erreurs ou des exceptions pour spécifier les exceptions pour lesquelles vous souhaitez relancer le traitement des événements.
    • Modifiez le nombre par défaut Maximum Retry .
    Pour plus d'informations, voir Réessayer les événements entrants présentant des erreurs

    L’exécution du pipeline n’avance ServiceNow DevOps pas et attend indéfiniment car les analyses SonarQube n’ont pas lieu en raison de l’absence de l’outil SonarQube.

    L’événement entrant de qualité logicielle affiche le message d’erreur suivant dans le champ Détails de traitement. « Vérifiez si l’outil SonarQube respectif est créé avec succès. Si ce n’est pas le cas, créez l’outil SonarQube et réessayez l’événement entrant.

    Pour toutes les étapes SonarQube des analyses de qualité du code, l’utilisateur doit créer l’outil SonarQube dans l’instance ServiceNow DevOps .

    Pour plus d'informations, voir SonarQube intégration avec Vélocité de changement DevOps
    L’interface utilisateur du pipeline affiche les liens rompus entre les étapes. Accédez aux exécutions de tâches et assurez-vous que la colonne Exécutions en amont possède les références de lien en amont appropriées.