Onboarding von Jira auf DevOps Change-Geschwindigkeit – Arbeitsbereich
Stellen Sie über den DevOps-Change-Arbeitsbereich eine Verbindung zu Ihrer Jira -Server- oder Jira -Cloud-Instanz her, um verfügbare Pläne zu erkennen und Webhooks zu registrieren, um Projekte, Stories, Funktionen und Epics nachzuverfolgen.
Vorbereitungen
Führen Sie die im Thema Erste Schritte mit DevOps Change-Geschwindigkeit angegebenen Aufgaben aus.
Erforderliche Rolle: sn_devops.admin oder sn_devops.tool_owner
Prozedur
-
Navigieren zu und öffnen Sie das Playbook für das Onboarding von Jiramit einer der folgenden Optionen.
Option Schritte Homepage - Wählen Sie Tool verbinden.
- Wählen Sie im Modal „Mit einem Tool verbinden Jira “ aus der Kategorie Planen aus.
Modul „Anwendungen“ - Wählen Sie in der primären Navigation Anwendungen (
). - Wählen Sie eine vorhandene Anwendung aus, oder erstellen Sie eine. Informationen zum Erstellen einer Anwendung finden Sie unter Anwendung erstellen – Arbeitsbereich.
- Wählen Sie im Bereich Empfohlene Aktionen die Karte Tool verbinden.
- Wählen Sie im Modal „Mit einem Tool verbinden Jira “ aus der Kategorie Planen aus.
Modul Tools - Wählen Sie in der primären Navigation Tools (
). - Wählen Sie in der Fähigkeitsliste Planungaus.
- Wählen Sie Tool verbinden.
- Wählen Sie im Modal Mit einem Tool verbinden die Option Jiraaus.
Wichtig:Wenn Sie Toolobjekte wie Pläne erkennen und nachverfolgen möchten, während Sie eine Verbindung zum Tool herstellen, müssen Sie Ihr Tool über das Anwendungsmodul verbinden. -
Stellen Sie eine Verbindung zu Ihrem Jira Server oder Ihrer Jira Cloud-Instanz her.
Jira Server - Wählen Sie in der Liste „Plattform“Jira Serveraus.
- Geben Sie im Feld Toolname einen Namen für das Tool ein.
Dieser Name wird verwendet, um Ihre Instanz Jira in der Liste der mit DevOps Change-Geschwindigkeitverbundenen Tools zu identifizieren.
Jira Cloud - Wählen Sie in der Liste Plattform den Eintrag Jira Cloudaus.
- Geben Sie im Feld Toolname einen Namen für das Tool ein.
Dieser Name wird verwendet, um Ihre Instanz Jira in der Liste der mit DevOps Change-Geschwindigkeitverbundenen Tools zu identifizieren.
-
Stellen Sie mithilfe des Playbooks eine Verbindung zu Ihrem Tool Jira her.
-
Geben Sie die Verbindungsdetails ein.
Jira Server - Geben Sie die URL Ihrer Jira -Serverinstanz ein.
- Wählen Sie in der Liste Anmeldeinformationstyp den Authentifizierungstyp aus, den Sie für die Verbindung mit dem Server Jira verwenden möchten.
-
Basisauth.
- Geben Sie Ihren Jira -Server-Anwendernamen ein.Hinweis:Der -Benutzer Jira, den Sie hier verwenden, muss über die Administratorberechtigungen Jira verfügen.
- Geben Sie das Passwort oder Zugriffstoken ein, um auf diese Instanz zuzugreifen.
- Geben Sie Ihren Jira -Server-Anwendernamen ein.
- API Key
Geben Sie das API-Token ein, um auf die Instanz zuzugreifen.
-
- Wenn Ihre Instanz Jira an ein MID-Serverangehängt ist, wählen Sie die Option MID-Server, und geben Sie die zugehörigen Details ein.
Weitere Informationen zum MID-Server finden Sie unter MID-Server-Auswahl
Jira Cloud - Geben Sie die URL der Cloud-Instanz Jira ein.Hinweis:Wenn Sie im nächsten Schritt OAuth 2.0 mit 3LO als Anmeldeinformationstyp auswählen, müssen Sie Ihre Jira-Instanz-URL im folgenden Format eingeben:
Informationen zum Abrufen des Werts der Cloud-ID finden Sie unter Obtain the value of Cloud ID.https://api.atlassian.com/ex/jira/<Cloud-ID> - Wählen Sie als Anmeldeinformationstyp Basisauth. oder OAuth 2.0 mit 3LOaus.
Basisauth.
- Geben Sie Ihren Jira Cloud-Anwendernamen ein.Hinweis:Der -Benutzer Jira, den Sie hier verwenden, muss über die Administratorberechtigungen Jira verfügen.
- Geben Sie das Passwort oder Zugriffstoken ein, um auf diese Instanz zuzugreifen.
OAuth 2.0 mit 3LO
Voraussetzungen:Wählen Sie im Feld „Anmeldeinformationen“ einen vorhandenen OAuth 2.0-Anmeldeinformationsdatensatz aus, oder wählen Sie OAuth 2.0-Anmeldeinformationsdatensatz erstellen, um einen neuen Datensatz zu erstellen. Anweisungen zum Erstellen eines neuen Anmeldeinformationsdatensatzes finden Sie unter Anmeldeinformationsdatensatz für Jira Cloud erstellen.Hinweis:- Die Option zum Erstellen einer neuen OAuth 2.0-Instanz ist nur verfügbar, wenn Sie über die Verbindungs- und OAuth-Administratorrolle verfügen.
- Nur Datensätze, die nicht für Jira Cloud verwendet werden und für sie konfiguriert sind, können als vorhandener Anmeldeinformationsdatensatz ausgewählt werden.
- Geben Sie Ihren Jira Cloud-Anwendernamen ein.
- Wenn Ihre Instanz Jira an ein MID-Serverangehängt ist, wählen Sie die Option MID-Server, und geben Sie die zugehörigen Details ein.
Weitere Informationen zum MID-Server finden Sie unter MID-Server-Auswahl
-
Berechtigungsprüfungen werden für die von Ihnen eingegebenen Anmeldeinformationen ausgeführt.
Erforderliche Berechtigungen und verfügbare Berechtigungen werden angezeigt. Wenn Sie Anmeldeinformationen mit besseren Berechtigungen eingeben möchten, wählen Sie Anmeldeinformationen erneut eingeben aus. Ausführliche Informationen zu allen erforderlichen Berechtigungen finden Sie unter Jira-Berechtigungen in Für DevOps Tools sind Berechtigungen erforderlich.
Sie können mit der Toolverbindung fortfahren, auch wenn Sie nicht über alle erforderlichen Berechtigungen verfügen.
-
Geben Sie die Verbindungsdetails ein.
-
Geben Sie den Zugriff für das Tool an.
- Wenn Sie den Zugriff auf das Tool steuern möchten, fügen Sie im Feld Verwaltet von die Gruppen hinzu, die Zugriff auf das Tool erhalten müssen.Die Aufgaben, die diese Benutzer in den Gruppen ausführen können, hängt von der ihnen zugewiesenen Rolle ab.
- DevOps Rolle Tool-Besitzer: Kann das Tool anzeigen und bearbeiten.
- DevOps Rolle App-Besitzer: Kann das Tool anzeigen und Verlaufsdaten zuordnen, erkennen, importieren und Pipelineschritte (falls zutreffend) der Objekte des Tools (z. B. Pläne, Repositorys und Pipelines) ändern.
- DevOps Administratorrolle: Kann alle Tools bearbeiten.
- Andere DevOps -Rollen: Können das Tool anzeigen.
Hinweis:Wenn Sie keine Gruppe auswählen und diesen Schritt überspringen, können alle Anwender mit der Rolle DevOps Toolbesitzer das Tool bearbeiten. - Wenn Sie den Zugriff auf das Tool steuern möchten, wird die Option Alle App-Besitzer können Toolobjekte anzeigen und Anwendungen zuordnen zur Auswahl.
Mit dieser Option können alle Anwender mit der Rolle DevOps „ App-Besitzer auf das Tool zugreifen. Wenn diese Option ausgewählt ist, können sie Verlaufsdaten anzeigen, zuordnen, erkennen, importieren und Pipelineschritte (falls zutreffend) der Objekte des Tools ändern.
- Klicken Sie auf Zuweisen.
- Wenn Sie den Zugriff auf das Tool steuern möchten, fügen Sie im Feld Verwaltet von die Gruppen hinzu, die Zugriff auf das Tool erhalten müssen.
-
Um Daten in Echtzeit zwischen DevOps und Ihrer Instanz Jira zu senden, wählen Sie Konfigurierenaus.
Diese Aktion bewirkt Folgendes:
- Registriert einen Webhook zwischen den Instanzen Jira und ServiceNow und ermöglicht die Echtzeit-Datenübertragung zwischen beiden.
- Wenn Sie Ihr Jira-Tool mit OAuth 2.0-basierter Authentifizierung verbunden haben, werden die Webhooks für die OAuth 2.0-Integrations-App in Jira erstellt, wenn Sie automatisch konfigurieren. Wenn Sie hingegen die Standardauthentifizierung verwendet haben, werden die Webhooks für alle Ihre Projekte in Jira erstellt. Wenn Sie die Webhooks für ein Jira-Tool, das mit der OAuth 2.0-basierten Authentifizierung erstellt wurde, manuell konfigurieren, wird möglicherweise ein doppelter Webhook erstellt.
Alle erkannten Jira -Projekte werden als Pläne aufgeführt.
Wenn Sie jetzt nicht konfigurieren möchten, können Sie die nächtliche Abfrage später aktivieren, um Daten für alle nachverfolgten Pläne abzurufen, indem Sie die Systemeigenschaft Enable Polling auf Jafestlegen.
Wählen Sie Manuell konfigurieren aus, um manuell zu konfigurieren. Weitere Informationen finden Sie unter Konfigurieren Sie Webhooks manuell in Jira..
Wichtig:- Wenn Sie über die Startseite oder das Modul Tools eine Verbindung herstellen, wird die Verbindung hergestellt, und Sie gelangen zur Seite „Zusammenfassung“.
- Wenn Sie über das Anwendungsmodul eine Verbindung herstellen, werden die in Ihrer Jira-Instanz verfügbaren Pläne erkannt. Sie können Verlaufsdaten daraus verfolgen und importieren.
-
Wählen Sie die nachzuverfolgenden Pläne aus.
Wählen Sie die Pläne aus, für die Sie Updates nachverfolgen und der -Anwendung zuordnen möchten.
Nach Abschluss des Tool-Onboardings werden nur die Arbeitselemente für diese ausgewählten Pläne automatisch importiert.
Wählen Sie Weiter.
Wenn Sie Plandaten importieren möchten, wählen Sie den Datumsbereich aus, und wählen Sie Absenden aus.
Sie können Daten von bis zu 90 Tagen importieren.
-
Wählen Sie auf der Seite „Zusammenfassung“die Option Tooldatensatz anzeigen aus, um die Details der verbundenen Instanz und der von ihr erkannten Pläne zu überprüfen.
Ergebnisse
Sie haben das Onboarding des Tools Jira erfolgreich in DevOps Change-Geschwindigkeitdurchgeführt.
Nächste Maßnahme
Auf der Tooldatensatzseite haben Sie folgende Möglichkeiten:
- Sehen Sie sich die Details und den Status des Tools an.
- Erkennen Sie Pläne, und Konfigurieren Sie Webhooks.Hinweis:
- Standardmäßig werden -Projekte in einem Satz von 50 für Jira Cloud erkannt. 50 ist der maximale von Jiraunterstützte Paginierungsgrenzwert. Wenn Sie diesen Wert reduzieren möchten, müssen Sie die entsprechende Konstante im DevOpsCommonConstants-Skript bearbeiten.
- Erkannte Projekt- und Versionsdaten werden nicht in Echtzeit aktualisiert oder nachverfolgt.
- Weisen Sie Gruppen zu, um den Zugriff auf das Tool mithilfe des Felds Verwaltet von zu steuern.
- Überprüfen Sie die Berechtigungen der Anmeldeinformationen, und aktualisieren Sie die Anmeldeinformationen für das Tool. Weitere Einzelheiten finden Sie unter Überprüfen Sie Berechtigungen, und aktualisieren Sie die Anmeldeinformationen für -Tools – Arbeitsbereich.
- Wählen Sie auf der Registerkarte Pläne einen Plan aus, um seine Details wie importierte Arbeitselemente, Funktionen usw. anzuzeigen.
- Um Verlaufsdaten aus den Plänen zu importieren, ordnen Sie die Pläne einer Anwendung zu, und importieren Sie die Daten. Weitere Informationen finden Sie unter Toolobjekte Anwendungen zuordnen – Arbeitsbereich.