Häufige Fehler in DevOps Change-Geschwindigkeit
Identifizieren Sie die Ursache von Fehlern, die in DevOps Change-Geschwindigkeitauftreten, und sehen Sie sich die entsprechenden Schritte an, mit denen sie möglicherweise behoben werden.
Toolverbindung
In dieser Tabelle sind die Schritte aufgeführt, die erforderlich sind, um die Fehler zu beheben, die auftreten können, wenn Sie auf die Schaltfläche Absenden oder Verbinden klicken, nachdem Sie die Tooldetails im Toolverbindungsprozess eingegeben haben:
| Nachricht | Aktion |
|---|---|
| Das Tool kann nicht erstellt werden, da der Toolname nicht eingegeben wurde. Geben Sie den Toolnamen ein, und versuchen Sie es erneut. | Geben Sie den Toolnamen erneut ein. |
| Das Tool kann nicht erstellt werden, da die Toolintegration nicht ausgewählt wurde. Wählen Sie den richtigen Toolintegrationswert aus, und versuchen Sie es erneut. | Wählen Sie den richtigen Toolintegrationswert aus. |
| Das Tool kann nicht erstellt werden, da die Tool-URL ungültig oder falsch ist. Geben Sie die Tool-URL erneut ein, und versuchen Sie es erneut. | Geben Sie die Tool-URL erneut ein. |
| Das Tool kann nicht erstellt werden, da die Plattformversion nicht bestimmt werden kann. Erstellen Sie die Systemeigenschaft glide.buildtag.last, und versuchen Sie es erneut. |
|
| Das Tool kann nicht erstellt werden, da die zugehörige Verbindung des CreateDevOps-Tools ungültig ist. Erstellen Sie einen gültigen Verbindungsalias, und versuchen Sie es erneut. |
|
| Das Tool kann nicht erstellt werden, da die Anmeldeinformationen des CreateDevOpsTool-Alias falsch sind. Aktualisieren Sie den Anmeldeinformationsdatensatz, und versuchen Sie es erneut. |
|
| Das Tool kann nicht erstellt werden, da die Verbindungs-URL des CreateDevOpsTool-Alias falsch ist. Verwenden Sie die folgende URL: https://<instancename> .service-now.com, und versuchen Sie es erneut. |
|
| Zum Erstellen eines Verbindungsalias benötigen Sie die Rolle connection_admin. Wenden Sie sich an Ihren Systemadministrator. | Dieser Fehler tritt auf, wenn das Feld „Verbindungsalias“ für einen Tooldatensatz leer ist. Zum Erstellen der Toolverbindung benötigen Sie einen Verbindungsalias. Nur Benutzer mit der Rolleconnection_admin können einen Verbindungsalias erstellen. Sie müssen sich an einen Anwender mit dieser Rolle wenden, z. B. einen Administrator, und den Verbindungsalias erstellen lassen. |
| Das Tool kann aus folgendem Grund nicht erstellt werden:<toolname> Toolname ist bereits vorhanden. Geben Sie einen anderen Namen ein, und versuchen Sie es erneut. | Verwenden Sie einen anderen Namen für das Tool. |
| Das Tool kann aus folgendem Grund nicht erstellt werden:<toolname> hat keine gültige MID-Server-Konfiguration. Konfigurieren Sie einen gültigen MID-Server, und versuchen Sie es erneut. |
|
| Das Tool kann nicht erstellt werden, da für den DevOps-Datenmodell-Bereich keine Aliasse für Verbindungen und Anmeldeinformationen verfügbar sind. Erstellen Sie einen neuen Alias für Verbindungen und Anmeldeinformationen, und versuchen Sie es erneut. | Dieser Fehler tritt bei der OAuth-Authentifizierung auf.
|
| Das Tool kann aufgrund eines technischen Problems beim Erstellen des Anmeldeinformationsdatensatzes nicht erstellt werden. |
|
| Das Tool kann nicht erstellt werden, da die Kombination aus Anmeldeinformationen und Domäne für einen aktiven Datensatz bereits vorhanden ist. | Dieser Fehler tritt bei der OAuth-Authentifizierung auf.
|
| Das Tool kann aufgrund eines technischen Problems beim Erstellen des Verbindungsdatensatzes nicht erstellt werden. |
|
Das Tool kann aus den folgenden Gründen nicht erstellt werden:
|
Dieser Fehler tritt nur für anwenderdefinierte Toolintegrationen auf.
|
| Das Tool kann aufgrund eines Konnektivitätsproblems nicht erstellt werden. Überprüfen Sie<validate_subflow_name> Subflow, um weitere Details zu erhalten, und versuchen Sie es erneut. |
|
| Die Anmeldeinformationen für die Toolautorisierung sind ungültig. Geben Sie gültige Anmeldeinformationen ein, und versuchen Sie es erneut. | Geben Sie den richtigen Anwendernamen/das richtige Passwort für das Tool erneut ein. |
| Das Tool kann nicht erstellt werden, da keine Antwort vom Server empfangen wurde. Geben Sie eine gültige Tool-URL ein, oder überprüfen Sie, ob der Server aktiv ist, und versuchen Sie es erneut. |
|
| Die Verbindungs-URL ist falsch, überprüfen Sie URL, und versuchen Sie es erneut. |
Geben Sie die Tool-URL erneut ein. |
| Das Tool kann nicht verbunden werden, da der Datenfeldname der GitHub-App falsch ist. Geben Sie den korrekten Datenfeldnamen der GitHub-App ein, und versuchen Sie es erneut. | Sie finden den Datenfeldnamen der App GitHub auf der Einstellungsseite Ihrer App GitHub. Der Datenfeldname der App GitHub ist der URL-freundliche Name Ihrer App GitHub. Wenn Sie beispielsweise eine GitHub -App mit dem Namen Test-Apperstellt haben, lautet der entsprechende URL-freundliche Datenfeldname GitHub der -App test-app. In Ihrer GitHub -URL „https://github.com/settings/apps/test-app“ ist „test-app“ der Datenfeldname der GitHub -App. Weitere Informationen finden Sie in der GitHub-Dokumentation. |
| Der Passwortwert ist zu lang und könnte nach der Verschlüsselung gekürzt werden. Reduzieren Sie entweder die Passwortlänge, oder erhöhen Sie die Feldgröße. | Ab dem 18. Januar 2023 hat Jira die Länge der API-Token für Atlassian-Accounts verlängert. Sie müssen den maximalen Passwortwert in der Tabelle „discovery_credentials“ auf über 255 erhöhen, um die erweiterte Zeichenlänge zu berücksichtigen. Weitere Informationen finden Sie im KB-Artikel KB1269878 und in der Atlassian-Dokumentation. |
| Unerwartetes Verhalten des Remote-Hosts: Ringleitung an „https://bitbucket.org/account/signin/?next=%2F...%2Frest%2Fapi%2F1.0%2Fusers“. | Dieser Fehler kann auftreten, wenn Sie versuchen, eine Verbindung zu einer BitBucket-Cloud-Instanz herzustellen. BitBucket Cloud wird nicht unterstützt. Sie müssen eine BitBucket-Serverinstanz verwenden, um eine Verbindung zu ServiceNow DevOps herzustellen. Stellen Sie über einen MID-Server eine Verbindung zu Ihrer BitBucket-Instanz her. Ein MID-Server ist erforderlich, wenn Ihre -Toolinstanz lokal gehostet wird. Weitere Informationen zum MID-Server finden Sie unter MID-Server-Auswahl |
|
Dieser Fehler tritt auf, wenn sich die in JenkinsDevOps eingegebene URL von der in Ihrer Instanz JenkinsJenkins eingegebenen URL unterscheidet. Navigieren Sie in Ihrer Instanz von Jenkins zu . Die hier eingegebene Jenkins-URL muss mit der URL der in DevOpseingegebenen Jenkins-Instanz übereinstimmen. |
Toolberechtigungen
In diesem Abschnitt werden die Schritte aufgelistet, die zum Beheben von Toolberechtigungsfehlern erforderlich sind, wenn Sie ein DevOps-Tool mithilfe von Playbooks für Arbeitsbereiche erstellen. Richtlinien zur Überprüfung der Toolberechtigung werden in einem Popup-Fenster angezeigt, wenn Sie aus dem Arbeitsbereich eine Verbindung zu einem Tool herstellen.
- Aktion
Wenn eine Berechtigung fehlt, führen Sie die folgenden Schritte aus:
- Aktualisiert die Berechtigungen für die angegebenen Anmeldeinformationen im externen DevOps-Tool. Wählen Sie im Popup-Fenster Aktualisieren, um die Prüfungen erneut durchzuführen.
- Schließen Sie das Popup-Fenster, verwenden Sie andere Anmeldeinformationen, und wählen Sie erneut Verbinden. Das Popup-Fenster zur Berechtigungsprüfung wird mit den Ergebnissen der neu eingegebenen Anmeldeinformationen angezeigt.
- Überprüfen Sie die Auswirkungsspalte. Wenn die Auswirkung Ihren Anwendungsfall nicht beeinflusst, wählen Sie trotzdem weiter aus.
- Zeitüberschreitungseigenschaft für die Überprüfung der Toolberechtigung
Während des Toolverbindungsprozesses führt das System im Vordergrund Berechtigungsvalidierungen durch und schränkt die Seite des Tools ein. Bei jeder Berechtigungsvalidierung erfolgt ein REST-API-Aufruf an externe Tools, um die Verfügbarkeit der Berechtigung zu bewerten. Die Antwortzeit der REST API kann je nach Netzwerkeinstellungen variieren. Um Verzögerungen zu vermeiden, können Sie angeben, wie lange das System auf den Erhalt einer Antwort von einem externen Tool warten soll, bevor die Berechtigung als Fehler markiert wird. Sie können diese Zeit mithilfe der Eigenschaft Zeitüberschreitung bei der Überprüfung der Toolberechtigung pro Datensatz (in Millisekunden) (sn_devops.permission_check_timeout)angeben. Wenn Sie feststellen, dass einige der Berechtigungsprüfungen zu einem Fehler führen, versuchen Sie, den Wert für die Zeitüberschreitung zu erhöhen, und wählen Sie im Popup-Fenster Berechtigungen die Option Aktualisieren aus.
Toolbenachrichtigung
In dieser Tabelle sind die Schritte aufgeführt, die zur Behebung von Fehlern erforderlich sind, die in Szenarien auftreten können, z. B. Abrufen von Commit-Details, Pipeline-Ausführungsdetails, Details zu Abrufanforderungen oder Testzusammenfassungen:
| Grund | Aktion |
|---|---|
| Die Anmeldeinformationen für die Autorisierung sind entweder ungültig oder verfügen nicht über die erforderlichen Mindestberechtigungen. |
|
| Es gibt keine Antwort vom Server. Überprüfen Sie den Status der Serververbindung, und versuchen Sie es erneut. |
|
| Die Anforderung kann nicht verarbeitet werden. | Überprüfen Sie, ob die maximale Anzahl von Instanzen, die einem Webhook zugeordnet sind, überschritten hat. Wenn dieser Fehler für GitHub aufgetreten ist, überprüfen Sie, ob Sie einem Webhook mehr als 20 Instanzen zugeordnet haben. |
| Die Anmeldeinformationen für die Autorisierung verfügen nicht über die erforderlichen Mindestberechtigungen. | Vergewissern Sie sich, dass die Anmeldeinformationen für Drittpartei-Tools über die erforderlichen Umfänge verfügen. Wenn Sie die Arbeitsbereich-UI verwenden, können Sie zum Tooldatensatz navigieren und auswählen um mehr über die erforderlichen Berechtigungen zu erfahren. |
| MID-Serverkonfiguration ist ungültig. Konfigurieren Sie einen gültigen MID-Server, und versuchen Sie es erneut. | Überprüfen Sie, ob der MID-Server ausgeführt wird und erreichbar ist. |
| Die Verbindungs-URL ist ungültig. Geben Sie eine gültige URL ein, und versuchen Sie es erneut. |
|
| Die Quotengrenze wurde überschritten. Versuchen Sie es nach {0} erneut. | Die Quotenbegrenzung ist die Anzahl der API-Aufrufe, die eine App oder ein Anwender innerhalb eines bestimmten Zeitraums durchführen kann. Die Quotenbegrenzung ist eine Technik zur Begrenzung des Netzwerkdatenverkehrs, um zu verhindern, dass Benutzer die Systemressourcen überlasten. Wenn die in Ihrem Drittanbieter-Tool zulässige Höchstquotengrenze überschritten wird, kann dieser Fehler auftreten. |
| Ihre Anmeldeinformationen verfügen nicht über die erforderlichen Umfänge. | Vergewissern Sie sich, dass die Anmeldeinformationen für Drittpartei-Tools über die erforderlichen Umfänge verfügen. Wenn Sie die Arbeitsbereich-UI verwenden, können Sie zum Tooldatensatz navigieren und auswählen um mehr über die erforderlichen Berechtigungen zu erfahren. |
Change-Anforderung
Diese Tabelle listet die Schritte auf, die zum Beheben von Fehlern erforderlich sind, die bei der Erstellung von Change-Anforderungen auftreten können:
| Fehler | Aktion |
|---|---|
| Die Change-Anforderung kann nicht erstellt werden, da die Kennzeichnung für die Typkompatibilität deaktiviert ist. Aktivieren Sie die Typkompatibilitätskennzeichnung in den Systemeigenschaften, oder konfigurieren Sie das Change-Modell im Schrittdatensatz in ServiceNow, oder geben Sie die entsprechende Sys-ID des Change-Modells in die Pipeline ein. |
|
| Die Change-Anforderung kann nicht erstellt werden, da entweder der Change-Typ oder das Change-Modell nicht für die Pipeline konfiguriert ist. | Fügen Sie das Change-Modell oder den Typ im Formular Schritt hinzu, oder ändern Sie die Attribute der Pipeline. |
Allgemeine Fehler
Diese Tabelle listet die Schritte auf, die zur Behebung allgemeiner Fehler erforderlich sind, die bei der Arbeit mit DevOps Change-Geschwindigkeit auftreten können.
| Problem | Aktion |
|---|---|
| Importanforderung wird nicht verarbeitet | Wenn eine Importanforderung zu lange im Status Angefordert bleibt, während sie einen Import für ein Tool (z. B. Jenkins, Jiraoder GitHub ) durchführt, löschen Sie die Importanforderung, und versuchen Sie es erneut. Hinweis: Löschen Sie die vorhandene Anforderung, um den Import desselben Bereichs erneut zu versuchen. |
| Toolverbindung schlägt fehl | Entfernen Sie den nachfolgenden Schrägstrich („/“) im Feld „Verbindungs-URL“ im Formular „HTTP-Verbindung“. |
| Für einen Jenkins -Auftrag unter Change-Steuerung wird keine Change-Anforderung erstellt | Stellen Sie Folgendes sicher:
Die Erstellung von Change-Anforderungen wird nicht unterstützt, wenn die Aufgabe unter Change-Steuerung steht:
|
| Jenkins blockiert den Auftrag unter Change-Steuerung nicht (wartet nicht auf Genehmigung der Change-Anforderung) | Stellen Sie sicher, dass der Speicherort Jenkins konfiguriert ist: Navigieren zu und geben Sie den Hostnamen für das Feld Jenkins-URL im Abschnitt Jenkins Standort an. Hinweis: Um Caching-Probleme zu vermeiden, klicken Sie auf Speichern, auch wenn das Feld Jenkins-URL bereits einen Wert enthält, wenn Sie das Formular zum ersten Mal öffnen. |
| Im Nutzlastprotokoll auftretende Ereignisse mit dem Status „Nicht verbunden“. | Wenn eine der folgenden Änderungen für eine Verbindung manuell vorgenommen wird (im manuellen Konfigurationsmodus), wird die Verbindung automatisch getrennt.
Wechseln Sie in den manuellen Konfigurationsmodus, und stellen Sie erneut eine Verbindung her. |
| Eingehende Ereignisse wiederholen, die aufgrund einer REST-API-Zeitüberschreitungsausnahme/FlowObjectAPIException fehlschlagen oder ausfallen | Aktualisieren Sie die geplante Aufgabe Retry Errored Inbound Events, um die Verarbeitung eingehender Ereignisse im Status Error zu wiederholen.
|
Die Pipeline-Ausführung in ServiceNow DevOps wird nicht vorwärts verschoben und wartet auf unbestimmte Zeit, da die SonarQube-Scans aufgrund des Fehlens des SonarQube-Tools nicht stattfinden. Das eingehende Softwarequalitäts-Ereignis zeigt im Feld mit den Verarbeitungsdetails die folgende Fehlermeldung an. Überprüfen Sie, ob das entsprechende SonarQube-Tool erfolgreich erstellt wurde. Wenn nicht, erstellen Sie das SonarQube-Tool, und wiederholen Sie das eingehende Ereignis.“ |
Für alle SonarQube-Schritte in Codequalitätsscans muss der Anwender das SonarQube-Tool in der Instanz ServiceNow DevOps erstellen. Weitere Informationen finden Sie unter Integration von DevOps Change-Geschwindigkeit in SonarQube |
| Die Pipeline-UI zeigt defekte Links zwischen Phasen an. | Navigieren Sie zu Aufgabenausführungen und stellen Sie sicher, dass die Spalte Vorgelagerte Ausführungen die entsprechenden Upstream-Link-Referenzen enthält. |