Erreurs courantes dans Changements de vélocité DevOps

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

    • Identifiez la cause première des erreurs qui se produisent dans Changements de vélocité DevOps, et reportez-vous aux étapes correspondantes susceptibles de les résoudre.

    Connexion de l’outil

    Ce tableau répertorie les étapes requises pour résoudre les erreurs qui peuvent se produire lorsque vous sélectionnez le bouton Soumettre ou Connecter après avoir entré 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. Saisissez le nom de l’outil, puis réessayez. Entrez à 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 et 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 incorrecte. Entrez à nouveau l’URL de l’outil, puis réessayez. Entrez de 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, puis réessayez.
    1. Accédez à l’administration > DevOps > Propriétés.
    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 à Tous les alias de connexion et d’informations d’identification > Connexions et informations d’identification > et ouvrez l’enregistrement CreateDevOpsTool .
    2. Dans la liste connexe Connexions, créez un enregistrement et saisissez 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 d’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. Dans le formulaire Connexion, saisissez 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, puis réessayez.
    1. Sélectionnez le lien d’enregistrement d’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 à Tous les alias de connexion et d’informations d’identification > Connexions et informations d’identification > et ouvrez l’enregistrement CreateDevOpsTool .
    2. Dans le formulaire Connexion, saisissez 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 d’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 disposant duconnection_admin rôle peut créer un alias de connexion. Vous devez contacter un utilisateur ayant ce rôle, tel qu’un administrateur, et obtenir l’alias de connexion créé.
    L’outil ne peut pas être créé car le nom d’outil <toolname> 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 <toolname> n’a pas de configuration de serveur MID valide. Configurez un MID Server valide et réessayez.
    1. Si vous utilisez l’espace de travail, vérifiez si le MID Server est en cours d’exécution et accessible.
    2. Si vous utilisez le catalogue et le créateur d’enregistrement, vérifiez si le MID Server est en cours d’exécution et accessible avec l’application en tant que DevOps et l’option 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 à tous les alias de connexion et d’informations d’identification > Connexion et 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 des informations d’identification.
    1. Accéder à toutes les exécutions de > Process Automation > Flow Designer >.
    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 d’autres informations d’identification.
    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éder à toutes les exécutions de > Process Automation > Flow Designer >.
    2. Recherchez 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 d’outils associée.
    Configurez le flux secondaire et créez l’enregistrement de l’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ées.

    1. Accéder à tout > Automatisation des processus > Concepteur de flux.
    2. Sur la page Concepteur de flux, sélectionnez l’onglet Flux secondaires .
    3. Ouvrez l’enregistrement de flux secondaire de validation de démo DevOps à partir de la liste.
    4. Dans la section Actions, ouvrez l’enregistrement Validation de l’action 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 Actions supplémentaires > Action de copie.Boîte de dialogue Copier l’action
    6. Entrez 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 >é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 à la ressource .Écran Valider l’action
    9. Saisissez la version d’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 de flux secondaire de validation de démo DevOps .
    13. Sélectionnez le menu Actions supplémentaires > Copier le flux secondaire.
    14. Entrez un nouveau nom pour le flux secondaire et sélectionnez l’application en tant que Intégrations DevOps, puis sélectionnez Copier.
    15. Dans le flux secondaire copié, supprimez l’action de validation de démo 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 Data > Rechercher des enregistrements .
      3. Dans le champ apiversion , sélectionnez la version de l’api dans la section Données > entrées de flux secondaire .
      4. Enregistrez les changements.
    16. Publiez le flux secondaire en sélectionnant Publier.
    17. Accédez à Intégrations > DevOps > Options d’intégration et créez un enregistrement avec l’action Valider .

      Pour plus d’informations, consultez Créer une intégration d’outils 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 <validate_subflow_name> pour en savoir plus, puis réessayez.
    1. Accéder à toutes les exécutions de > Process Automation > Flow Designer >.
    2. Recherchez 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 et réessayez. Entrez à 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. Entrez de nouveau l’URL de l’outil.
    2. Vérifiez le MID Server.
    L’URL de connexion est incorrecte, vérifiez le

    URL et réessayez.

    		 Entrez de 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 la 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 l’URL de votre GitHub application. Par exemple, si vous avez créé une GitHub application portant le nom Test App, le nom de la slug d’application compatible GitHub avec l’URL correspondant 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 soit réduire la longueur du mot de passe, soit augmenter la taille du champ. À partir du 18 janvier 2023, Jira a prolongé la durée des tokens 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 de caractères étendue. 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 serveur Bitbucket pour vous connecter à ServiceNow DevOps. Connectez-vous à votre instance BitBucket via un MID Server. Un MID Server est nécessaire si votre instance d’outil est hébergée sur site. Pour plus d’informations sur le MID Server, reportez-vous à la section Sélection du MID Server 
    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 DevOps est différente de l’URL Jenkins saisie dans votre Jenkins instance.

    À partir de 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 requises pour résoudre les erreurs d’autorisation d’outil lorsque vous créez un outil DevOps à l’aide de playbooks d’espace de travail. Les instructions 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 externe DevOps. Sélectionnez Actualiser dans la fenêtre contextuelle pour effectuer à nouveau les vérifications.
    • Fermez la fenêtre contextuelle, utilisez d’autres informations d’identification et sélectionnez Se connecter à nouveau. 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 de l’outil

    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 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 vérifications des autorisations entraînent une erreur, essayez d’augmenter la valeur du délai d’expiration, puis sélectionnez Actualiser dans la fenêtre contextuelle des autorisations.

    Notification d’outil

    Ce tableau répertorie les étapes requises 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 possèdent 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 et sélectionnerPlus d’actions ( icône Plus d’actions) > Vérifiez les autorisations des informations d’identification pour connaître les autorisations requises.
    • Vérifiez si vous avez entré 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 Actions supplémentaires) > Mettre à jour les informations d’identification. Pour plus d’informations sur la mise à jour des informations d’identification, reportez-vous à Mettre à jour les informations d’identification d’outils tiers dans Changements de vélocité DevOps.
    Il n’y a pas de réponse du serveur. Vérifiez l’état de la connexion au serveur et réessayez.
    • Vérifiez que le serveur d’outils DevOps est accessible et réactif.
    • Si le MID Server est configuré, vérifiez si le serveur 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 possèdent 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 et sélectionnerPlus d’actions ( icône Plus d’actions) > Vérifiez les autorisations des informations d’identification pour connaître les autorisations requises.
    La configuration du MID Server n’est pas valide. Configurez un MID Server valide et réessayez. Vérifiez si le MID Server est en cours d’exécution et accessible.
    L’URL de connexion n’est pas valide. Entrez une URL valide et réessayez.
    1. Accédez à Tous les alias de connexion et d’informations d’identification > > de connexion et d’informations d’identification et ouvrez l’enregistrement de connexion et d’informations d’identification requis.
    2. Dans 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.
    La limite des taux a été dépassée. Réessayez après {0}.

    La limite de taux correspond au nombre d’appels d’API qu’une application ou un utilisateur peut effectuer au cours d’une période donnée. La limitation de débit est une technique permettant de limiter le trafic réseau afin d’éviter que les utilisateurs n’épuisent les ressources du système. Si la limite maximale de taux 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 possèdent 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 et sélectionnerPlus d’actions ( icône Plus d’actions) > Vérifiez 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é de type est désactivé. Activez le marqueur de compatibilité de type dans les propriétés système, 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éder à Toutes les propriétés système > et activer la com.snc.change_management.change_model.type_compatibility propriété, ou
    • Ajoutez le modèle de changement dans le formulaire Étape ou les attributs de changement 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 modèle ou le type de changement dans le formulaire Étape ou les attributs de changement du pipeline.

    Erreurs générales

    Ce tableau répertorie les étapes requises pour résoudre quelques erreurs générales qui peuvent se produire lors de l’utilisation de l’application DevOps Change Velocity.

    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, puis réessayez.

    Remarque :
    Supprimez la demande existante pour retenter 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.
    • Des tâches et des étapes de l’application ont été configurées dans votre instance.
    La création de demandes 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 (il s’agit d’une tâche autonome, par exemple).
    • C’est le premier dans le pipeline.
    • Est dans le pipeline, mais l’utilisateur déclenche manuellement ou effectue l’extraction SCM directement sur la tâche sous contrôle des changements (ce qui ne déclenche pas le pipeline dès le début).
    Jenkins Ne bloque pas la tâche sous contrôle des changements (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 (à l’aide du 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 présentent une erreur en raison d’un TimeoutException/FlowObjectAPIException de l’API REST
    Mettez à jour la Retry Errored Inbound Events tâche planifiée pour réessayer de traiter les événements entrants qui sont dans Error l’état.
    • Mettez à jour la liste d’erreurs ou d’exceptions pour spécifier les exceptions pour lesquelles vous souhaitez retenter 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 dans ServiceNow DevOps n’avance 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 du 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 de SonarQube dans les analyses de la 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 Changements de vélocité DevOps
    L’interface utilisateur du pipeline affiche les liens rompus entre les étapes. Accédez à Exécutions de tâches et assurez-vous que la colonne Exécutions en amont contient les références de lien en amont appropriées.