Onboarding Durchführen JiraBis DevOps Change-GeschwindigkeitArbeitsbereich

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer
  • Stellen Sie eine Verbindung mit her JiraServer oder JiraCloud-Instanz aus dem DevOps-Change-Arbeitsbereich, um verfügbare Pläne zu erkennen und Webhooks zu registrieren, um Projekte, Stories, Funktionen und Epics nachzuverfolgen.

    Vorbereitungen

    Schließen Sie die in angegebenen Aufgaben ab Erste Schritte mit DevOps Change-GeschwindigkeitThema.

    Erforderliche Rolle: sn_devops.admin oder sn_devops.Tool_owner

    Prozedur

    1. Navigieren zu Arbeitsbereiche > DevOps – Change-Arbeitsbereich Und verwenden Sie eine der folgenden Optionen, um das Playbook zum Onboarding zu öffnen Jira.
      OptionSchritte
      Homepage
      1. Wählen Sie Aus Verbinden Sie ein Tool .
      2.   Wählen Sie im modalen Dialogfeld mit einem Tool verbinden die Option aus JiraVon Plan Kategorie.
      Anwendungsmodul
      1. Wählen Sie Aus Anwendungen ( Anwendungssymbol.) Aus der primären Navigation.
      2. Wählen Sie eine vorhandene Anwendung aus, oder erstellen Sie eine. Informationen zum Erstellen einer Anwendung finden Sie unter app-create-workspace.html.
      3.   Wählen Sie im Bereich empfohlene Aktionen die aus  Verbinden Sie ein Tool  Karte.
      4.   Wählen Sie im modalen Dialogfeld mit einem Tool verbinden die Option aus JiraVon Plan Kategorie.
      Toolmodul
      1. Wählen Sie Aus Tools ( Symbol „Tools“.) Aus der primären Navigation.
      2. Wählen Sie in der Fähigkeitsliste aus Planung .
      3. Wählen Sie Aus Verbinden Sie ein Tool .
      4.   Wählen Sie im modalen Dialogfeld mit einem Tool verbinden die Option aus Jira .
      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.
    2. Stellen Sie eine Verbindung mit her JiraServer oder JiraCloud-Instanz.
      Jira Server
      1. Von Plattform Liste, wählen Sie aus Jira-Server .
      2. In Toolname Geben Sie einen Namen für das Tool ein.

        Dieser Name wird verwendet, um zu identifizieren JiraInstanz aus der Liste der Tools, die mit verbunden sind DevOps Change-Geschwindigkeit.

      Stellen Sie eine Verbindung zum Jira-Server her.

      Jira Cloud
      1. Von Plattform Liste, wählen Sie aus Jira-Cloud .
      2. In Toolname Geben Sie einen Namen für das Tool ein.

        Dieser Name wird verwendet, um zu identifizieren JiraInstanz aus der Liste der Tools, die mit verbunden sind DevOps Change-Geschwindigkeit.

      Stellen Sie eine Verbindung zur Jira-Cloud her.

    3. Wählen Sie Weiter.

      Die DevOpsDie playbook-Seite wird geöffnet, damit Sie die Onboarding-Aufgaben abschließen können.

    4. Schließen Sie die Verbindung mit ab JiraTool, das das Playbook verwendet.
      1. Geben Sie die Verbindungsdetails ein.
        Jira Server
        1. Geben Sie ein JiraServerinstanz-URL.
        2. Von Anmeldeinformationstyp Wählen Sie den Authentifizierungstyp aus, den Sie für die Verbindung mit verwenden möchten JiraServer.
          • Basisauth.

            1. Geben Sie ein JiraServeranwendername.
              Hinweis:
              Die JiraAnwender, den Sie hier verwenden, muss über verfügen JiraAdministratorberechtigungen.
            2. Geben Sie das Passwort oder das Zugriffstoken ein, um auf diese Instanz zuzugreifen.

            Geben Sie Details zur Standardauthentifizierung des Jira-Servers ein.

          • API-Schlüssel

            Geben Sie das API-Token ein, um auf die Instanz zuzugreifen.

            Geben Sie das API-Token des Jira-Servers ein.

        3. Wenn Sie JiraInstanz ist an angehängt MID-Server, Wählen Sie aus MID-Server Option und geben Sie die Details ein.

          Weitere Informationen zum MID-Server finden Sie unter MID-Serverauswahl

        Jira Cloud
        1. Geben Sie ein JiraCloud-Instanz-URL.
          Hinweis:
          Wenn Sie den Anmeldeinformationstyp als auswählen OAuth 2,0 mit 3LO Im nächsten Schritt müssen Sie Ihre Jira-Instanz-URL im folgenden Format eingeben:
          https://api.atlassian.com/ex/jira/<Cloud-ID>
          Informationen zum Abrufen des Werts der Cloud-ID finden Sie unter Obtain the value of Cloud ID.
        2. Wählen Sie den Anmeldeinformationstyp als aus Standardauthentifizierung Oder OAuth 2,0 mit 3LO .

          Basisauth.

          1. Geben Sie ein JiraCloud-Anwendername.
            Hinweis:
            Die JiraAnwender, den Sie hier verwenden, muss über verfügen JiraAdministratorberechtigungen.
          2. Geben Sie das Passwort oder das Zugriffstoken ein, um auf diese Instanz zuzugreifen. Geben Sie Jira-Cloud-Instanzdetails für die Standardauthentifizierung ein

          OAuth 2.0 mit 3LO

          Voraussetzungen:
          • Erstellen Sie einen Anmeldeinformationsdatensatz für Jira Cloud
          Wählen Sie einen vorhandenen OAuth 2,0-Anmeldeinformationsdatensatz in aus Anmeldeinformationen Feld, oder wählen Sie aus Erstellen Sie einen OAuth 2,0-Anmeldeinformationsdatensatz Dient zum Erstellen eines neuen Datensatzes. Anweisungen zum Erstellen eines neuen Anmeldeinformationsdatensatzes finden Sie unter Erstellen Sie einen Anmeldeinformationsdatensatz für Jira Cloud .
          Hinweis:
          • Die Option zum Erstellen eines neuen OAuth 2,0 ist nur verfügbar, wenn Sie über die Rolle „Verbindung“ und „OAuth-Administrator“ verfügen.
          • Nur Datensätze, die nicht verwendet und für Jira Cloud konfiguriert sind, können als vorhandener Anmeldeinformationsdatensatz ausgewählt werden.
          Geben Sie Details zur Jira-Cloud-Instanz für die OAuth 2,0-Authentifizierung ein
        3. Wenn Sie JiraInstanz ist an angehängt MID-Server, Wählen Sie aus MID-Server Option und geben Sie die Details ein.

          Weitere Informationen zum MID-Server finden Sie unter MID-Serverauswahl

      2. Wählen Sie Aus Verbinden .

        Wenn die Verbindung erfolgreich ist, wird das Tool in erstellt DevOps Change-GeschwindigkeitUnd mit verbunden JiraInstanz.

      3. 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 aus Geben Sie die Anmeldeinformationen erneut ein . Detaillierte Informationen zu allen erforderlichen Berechtigungen finden Sie unter Jira-Berechtigungen in Berechtigungen erforderlich für DevOpsTools.

        Sie können mit der Toolverbindung fortfahren, auch wenn Sie nicht über alle erforderlichen Berechtigungen verfügen.

        Berechtigungsüberprüfungen für die Verbindung mit Jira.

    5. Geben Sie den Zugriff für das Tool an.
      1. Wenn Sie den Zugriff auf das Tool steuern möchten, fügen Sie die Gruppen hinzu, denen Zugriff auf das Tool in gewährt werden muss Verwaltet von Feld.
        Die Aufgaben, die diese Anwender in den Gruppen ausführen können, hängen von der ihnen zugewiesenen Rolle ab.
        • DevOps Toolbesitzer-Rolle: Kann das Tool anzeigen und bearbeiten.
        • DevOps App-Besitzerrolle: Kann das Tool anzeigen und Verlaufsdaten zuordnen, erkennen, importieren und Pipeline-Schritte (falls zutreffend) der Objekte des Tools (z. B. Pläne, Repositorys und Pipelines) ändern.
        • DevOps Administratorrolle: Kann alle Tools bearbeiten.
        • Sonstiges DevOpsRollen: Kann das Tool anzeigen.
        Hinweis:
        Wenn Sie keine Gruppe auswählen und diesen Schritt überspringen, alle Anwender mit DevOpsDie Rolle „Toolbesitzer“ kann das Tool bearbeiten.
      2. Wenn Sie den Zugriff auf das Tool steuern möchten, wird der Alle App-Besitzer können Toolobjekte anzeigen und Anwendungen zuordnen Option wird zur Auswahl verfügbar.

        Diese Option aktiviert alle Anwender mit DevOpsApp-Besitzerrolle für den Zugriff auf das Tool. Wenn diese Option ausgewählt ist, können sie Verlaufsdaten anzeigen, zuordnen, erkennen, importieren und Pipeline-Schritte (falls zutreffend) der Objekte des Tools ändern.

      3. Klicken Sie auf Zuweisen.

        Geben Sie den Toolzugriff an.

    6. Zum Senden von Daten in Echtzeit zwischen DevOpsUnd Ihr JiraInstanz, wählen Sie aus Konfigurieren .
      Mit dieser Aktion wird Folgendes ausgeführt:
      • Registriert einen Webhook zwischen JiraUnd ServiceNowInstanzen und aktiviert die Echtzeitdatenübertragung zwischen den beiden.
      • Wenn Sie Ihr Jira-Tool über die OAuth 2,0-basierte Authentifizierung verbunden haben, werden die Webhooks für die OAuth 2,0-Integrations-App in Jira erstellt, wenn Sie automatisch konfigurieren. Wenn Sie eine Verbindung über die Standardauthentifizierung hergestellt haben, werden die Webhooks für alle Ihre Projekte in Jira erstellt. Wenn Sie die Webhooks manuell für ein Jira-Tool konfigurieren, das mit der OAuth 2,0-basierten Authentifizierung erstellt wurde, kann ein doppelter Webhook erstellt werden.

      Alle erkannten JiraProjekte werden als Pläne aufgeführt.

      Wenn Sie jetzt nicht konfigurieren, können Sie die nächtliche Abfrage später aktivieren, um Daten für nachverfolgte Pläne abzurufen, indem Sie festlegen Enable PollingSystemeigenschaft bis Ja .

      Konfigurieren Sie die Jira-Instanz.

      Wählen Sie zum manuellen Konfigurieren aus Manuell konfigurieren . Weitere Informationen finden Sie unter config-webhooks-jira-manually.html.

      Wichtig:
      • Wenn Sie über die Startseite oder das Toolmodul eine Verbindung herstellen, ist die Verbindung abgeschlossen, und Sie werden zur Zusammenfassungsseite weitergeleitet.
      • Wenn Sie über das Anwendungsmodul eine Verbindung herstellen, werden in Ihrer Jira-Instanz verfügbare Pläne erkannt. Sie können Verlaufsdaten nachverfolgen und daraus importieren.
    7. Wählen Sie die nachzuverfolgenden Pläne aus.
      1. Wählen Sie die Pläne aus, für die Sie Aktualisierungen nachverfolgen und der Anwendung zuordnen möchten.

        Nachdem das Tool-Onboarding abgeschlossen ist, werden nur die Arbeitselemente für diese ausgewählten Pläne automatisch importiert.

      2. Wählen Sie Weiter.

        Wählen Sie Pläne aus Jira zum Nachverfolgen aus.

      3. Wenn Sie Plandaten importieren möchten, wählen Sie den Datumsbereich aus, und wählen Sie aus Übermitteln .

        Sie können bis zu 90 Tage Daten importieren.

        Importieren Sie Plandaten.

    8. Von Zusammenfassung Seite auswählen Zeigen Sie den Tooldatensatz an Dient zum Überprüfen der Details der verbundenen Instanz und der darin erkannten Pläne.

      Verbindungszusammenfassung.

    Ergebnisse

    Sie haben erfolgreich ein Onboarding von durchgeführt JiraTool zu DevOps Change-Geschwindigkeit.

    Nächste Maßnahme

    Auf der Tooldatensatzseite können Sie:

    • Details und Status des Tools anzeigen.
    • Erkennen Pläne und Konfigurieren Webhooks.
      Hinweis:
      • Standardmäßig werden Projekte in einem Satz von 50 für erkannt JiraCloud. 50 ist die maximale Paginierungsgrenze, die von unterstützt wird Jira. Wenn Sie diesen Wert reduzieren möchten, sollten 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 von zu steuern Verwaltet von Feld.
    • Überprüfen Sie die Anmeldeinformationsberechtigungen, und aktualisieren Sie die Anmeldeinformationen für das Tool. Weitere Einzelheiten finden Sie unter Berechtigungen überprüfen und Anmeldeinformationen für Tools aktualisieren – Arbeitsbereich.
    • Von Pläne Wählen Sie einen Plan aus, um seine Details anzuzeigen, z. B. importierte Arbeitselemente, Funktionen und andere.
    • 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 Ordnen Sie Toolobjekte Anwendungen zu – Arbeitsbereich.
    Hinweis:
    Es wird empfohlen, den Projektschlüssel für Projekte in nicht zu aktualisieren Jira. Wenn der Projektschlüssel aktualisiert wird, werden die aktualisierten Objektnamen in nicht berücksichtigt DevOps Change-Geschwindigkeit. Nur, wenn das Objekt in aktualisiert wird Jira, Der neue Name wird in widergespiegelt DevOps Change-Geschwindigkeit.