Erreurs courantes dans Vélocité de changement DevOps
Identifiez la cause première des erreurs qui se produisent dans Vélocité de changement DevOps, et reportez-vous aux étapes correspondantes susceptibles de les résoudre.
Connexion d'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 saisi les détails de l'outil dans le processus de connexion de l'outil :
| Message | Action |
|---|---|
| Il est impossible de créer l'outil, car le nom de l'outil n'a pas été saisi. Saisissez le nom de l'outil, puis réessayez. | Saisissez à nouveau le nom de l'outil. |
| Il est impossible de créer l'outil, car l'intégration d'outils 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. |
| Il est impossible de créer l'outil, car l'URL de l'outil n'est pas valide ou est incorrecte. Saisissez à nouveau l'URL de l'outil, puis réessayez. | Saisissez à nouveau l'URL de l'outil. |
| Il est impossible de créer l'outil, car la version de la plateforme ne peut pas être déterminée. Créez la propriété glide.buildtag.last, puis réessayez. |
|
| Il est impossible de créer l'outil, car la connexion de l'outil CreateDevOps associée n'est pas valide. Créez un alias de connexion valide, puis réessayez. |
|
| Il est impossible de créer l'outil, car les informations d'identification de l'alias CreateDevOpsTool sont incorrectes. Mettez à jour l'enregistrement d'informations d'identification, puis réessayez. |
|
| Il est impossible de créer l'outil, car l'URL de connexion de l'alias CreateDevOpsTool est incorrecte. Utilisez l'URL suivante : https://<nominstance>.service-now.com et réessayez. |
|
| Pour créer un alias de connexion, vous devez disposer 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 devez disposer d'un alias de connexion. Seul un utilisateur disposant du rôle connection_admin peut créer un alias de connexion. Vous devez contacter un utilisateur disposant de ce rôle, notamment un administrateur, et obtenir l'alias de connexion créé. |
| Il est impossible de créer l'outil, car le nom de l'outil <nomoutil> existe déjà. Saisissez un autre nom et réessayez. | Utilisez un nom d'outil différent. |
| Il est impossible de créer l'outil, car le <nomoutil> ne dispose pas d'une configuration de serveur MID valide. Configurez un serveur MID valide et réessayez. |
|
| Il est impossible de créer l'outil, car aucun alias de connexion et d'informations d'identification n'est disponible pour le champ d'application de Modèle de données DevOps. Créez un nouvel alias de connexion et d'informations d'identification, puis réessayez. | Cette erreur se produit pour l'authentification OAuth.
|
| Il est impossible de créer l'outil en raison d'un problème technique lors de la création de l'enregistrement de connexion. |
|
| 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.
|
| Il est impossible de créer l'outil en raison d'un problème technique lors de la création de l'enregistrement de connexion. |
|
Il est impossible de créer l'outil pour les raisons suivantes :
|
Cette erreur se produit uniquement pour les intégrations d'outils personnalisées.
|
| Il est impossible de créer l'outil en raison d'un problème technique. Consultez le flux secondaire <validate_subflow_name> pour en savoir plus, puis réessayez. |
|
| Les informations d'identification d'autorisation de l'outil ne sont pas valides. Saisissez des informations d'identification valides et réessayez. | Saisissez à nouveau le nom d'utilisateur/mot de passe correct de l'outil. |
| Il est impossible de créer l'outil, car aucune réponse n'a été reçue du serveur. Saisissez une URL d'outil valide ou vérifiez si le serveur est en cours d'exécution, puis réessayez. |
|
| L'URL de connexion est incorrecte, vérifiez l'URL et réessayez. |
Saisissez à nouveau l'URL de l'outil. |
| Il est impossible de connecter l'outil, car 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. | Le nom de la slug de l'application GitHub se trouve sur la page des paramètres de votre application GitHub. Le nom de la slug de l'application GitHub est le nom convivial de l'URL de votre application GitHub. Par exemple, si vous avez créé une application GitHub portant le nom Test App, le nom de la slug de l'application GitHub compatible avec l'URL correspondant est test-app. Dans votre URL GitHub « 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. Réduisez la longueur du mot de passe ou augmentez la taille du champ. | À partir du 18 janvier 2023, Jira a augmenté le nombre de caractères des jetons d'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 l'augmentation du nombre de 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 tentez 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 serveur MID. Un serveur MID est nécessaire si votre instance d'outil est hébergée sur site. Pour plus d'informations sur le serveur MID, consultez Sélection de Serveur MID. |
| Incohérence dans l’URL de l’outil : URL de l’outil saisie dans ServiceNow : https://<URL de l’instance Jenkins que vous avez entrée> URL de l’outil saisie dans Jenkins : https://<URL d’emplacement Jenkins saisie dans Jenkins> Dans Jenkins, sous Gérer le système > Jenkins, vérifiez que votre URL Jenkins configurée est la même que l’URL de l’outil saisie ici. Consultez les erreurs d'intégration de l'outil de dépannage. | Cette erreur se produit lorsque l'URL Jenkins saisie dans DevOps est différente de l'URL Jenkins saisie dans votre instance Jenkins. À partir de votre Jenkins instance, accédez à . 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 une nouvelle fois Connecter. La fenêtre contextuelle de vérification des autorisations s'affiche avec les résultats des informations d'identification nouvellement saisies.
- Passez en revue la colonne Impact et, si l'impact n'a pas d'incidence sur votre cas d'utilisation, sélectionnez Continuer.
- Propriété Délai de vérification d'autorisation d'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 le délai que 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 la vérification d'autorisation d'outil (en millisecondes). Si vous constatez que certaines vérifications d'autorisation entraînent une erreur, essayez d'augmenter la valeur du délai d'expiration, puis sélectionnez Actualiser dans la fenêtre contextuelle Autorisations.
Notification d'outil
Ce tableau répertorie les étapes requises pour résoudre les erreurs susceptibles de 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 de pipeline, des détails de la demande d'extraction et des résumés des tests :
| Motif | Action |
|---|---|
| Les informations d'identification d'autorisation ne sont pas valides ou n'ont pas les autorisations minimales requises. |
|
| Absence de réponse du serveur. Vérifiez l'état de la connexion au serveur et réessayez. |
|
| 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, puis sélectionner pour connaître les autorisations requises. |
| La configuration du serveur MID n'est pas valide. Configurez un serveur MID valide et réessayez. | Vérifiez si le serveur MID est en cours d'exécution et accessible. |
| L'URL de connexion n'est pas valide. Saisissez une URL valide et réessayez. |
|
| Limite de débit dépassée. Réessayez après {0}. | La limite de débit 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 système. Si la limite de débit maximale autorisée dans votre outil tiers est dépassée, cette erreur risque de se produire. |
| Vos informations d'identification ne 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, puis sélectionner 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 |
|---|---|
| Il est impossible de créer la demande de changement, car le marqueur de compatibilité des types est désactivé. Activez le marqueur de compatibilité des types dans les propriétés système ou configurez le modèle de changement dans l'enregistrement d'étape dans ServiceNow, ou saisissez le sys id du modèle de changement approprié dans le 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 certaines 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, Jira ou GitHub), supprimez la demande d'importation, puis réessayez. Remarque : Supprimez la demande existante pour relancer l'importation de la même plage. |
| Échec de la connexion d'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 tâche Jenkins soumise au contrôle du changement | Vérifiez les points suivants :
La création de la demande de changement n'est pas prise en charge si la tâche est soumise au contrôle du changement :
|
| Jenkins ne bloque pas la tâche soumise au contrôle du changement (n'attend pas l'approbation de la demande de changement) | Vérifiez que l'emplacement Jenkins est configuré : Accédez à la et indiquez le nom d’hôte du 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 la première fois que vous ouvrez le formulaire. |
| É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ésactivée.
Passez en mode de configuration manuelle et relancez la connexion. |
| Relancer les événements entrants qui échouent ou présentent une erreur en raison d'une erreur TimeoutException/FlowObjectAPIException de l'API REST | Mettez à jour le travail planifié Retry Errored Inbound Events pour relancer le traitement des événements entrants à l'état Error.
|
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 a bien été créé. Si ce n'est pas le cas, créez l'outil SonarQube et relancez l'événement entrant. » |
Pour toutes les étapes de SonarQube des 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 Vélocité de changement DevOps |
| L'interface utilisateur du pipeline affiche des 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. |