Eine Jenkins -Pipeline in DevOpsmodellieren

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 3 Minuten Lesedauer
  • Modellieren Sie eine Jenkins -Pipeline, indem Sie die Pipeline einer App zuordnen und DevOps -Pipeline-Schritte zu Jenkins -Phasen zuordnen.

    Vorbereitungen

    Das Plugin Jenkins für ServiceNow DevOps wird bereitgestellt, um die Change-Beschleunigung zu aktivieren, damit Ihr Orchestration-Tool mit ServiceNow DevOps kommunizieren und bestimmte Aspekte der Pipeline-Ausführungen steuern kann.

    Installieren Sie das Plugin aus dem Jenkins-Marketplace. Navigieren Sie in Ihrer Jenkins-Instanz zu „Jenkins verwalten > Systemkonfiguration > Plugins“. Suchen Sie nach dem ServiceNow DevOps-Plugin, wählen Sie es aus, und wählen Sie dann Installierenaus.

    Erforderliche Rolle: sn_devops.admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sowohl geskriptete Pipelines (Jenkinsfile) als auch Freestyle-Aufträge werden unterstützt.

    Für Jenkinsfile-Pipelines werden Pipelineschritte automatisch und nicht manuell erstellt, zugeordnet und Orchestration-Aufgaben zugeordnet.

    Prozedur

    1. Ordnen Sie Ihre Pipeline einer App in DevOpszu.
      1. Navigieren zu DevOps > Apps und Pipelines > Apps und öffnen Sie den Anwendungsdatensatz, der der Pipeline zugeordnet werden soll.
      2. Klicken Sie in der zugehörigen Liste Pipelines auf Bearbeiten..., um eine Pipeline auszuwählen, die der App zugeordnet werden soll, oder klicken Sie auf Neu, um die Pipeline zu erstellen.
        Füllen Sie für eine neue Pipeline das Feld Orchestration-Pipeline mit dem vollständigen Projektnamen aus, wie in Jenkins angegeben.
        Hinweis:
        Beim Zuordnen einer Pipeline zu einer App werden die Pipelineschritte auch während des Imports abgerufen.
      3. Klicken Sie auf Absenden.
    2. Öffnen Sie den Pipeline-Datensatz erneut, und aktivieren Sie das Kontrollkästchen Nachverfolgen, damit Ereignisse von der Pipeline empfangen werden.
      Hinweis:
      Das Kontrollkästchen Nachverfolgen muss aktiviert sein, um die Pipeline mit DevOpszu integrieren.
    3. Erstellen Sie DevOps -Schritte automatisch oder manuell, um sie jeder Pipeline-Phase Jenkins zuzuordnen, sodass eine Orchestration-Aufgabe erstellt wird.
      • Führen Sie für deklarative oder geskriptete Pipelines die Pipeline Jenkins aus, um Pipelineschritte in DevOpsautomatisch zu erstellen und zuzuordnen.

        Pipeline-Schritte werden automatisch erstellt, zugeordnet und zugeordnet, wenn DevOps während der Ausführung Schrittbenachrichtigungen von Ihrer Jenkins-Pipeline erhält.

      • Erstellen Sie für Freestyle-Aufträge jeden Pipeline-Schritt manuell, und ordnen Sie ihn einem Jenkins -Pipeline-Auftrag zu.

        Klicken Sie in der zugehörigen Liste „Schritte“ auf Neu, um für jede Pipelinestufe Jenkins einen Schritt DevOps zu erstellen (FeldOrchestration-Phase ).

        Hinweis:
        Beim Feldwert Orchestration-Phase jedes Schritts wird zwischen Groß- und Kleinschreibung unterschieden, und er muss mit dem ursprünglichen Namen der entsprechenden Pipelinestufe Jenkins übereinstimmen.
        Name Name des Pipeline-Schritts.
        Pipeline Pipeline, in der der Schritt konfiguriert ist.
        Typ Pipeline-Schritttyp.
        • Build und Test
        • Test
        • Bereitstellen
        • Bereitstellung und Test
        • Manuell
        • Prod-Bereitstellung
        Auftrag

        Reihenfolge, in der die Schritte ausgeführt werden.

        Hinweis:
        Die Schrittreihenfolge bestimmt die Reihenfolge der Karten in der Pipeline-UI.

        Die Reihenfolge der Karten in der Pipeline-UI richtet sich nach Aufgabenausführung.

        Orchestration-Phase

        Jenkins Name der Pipelinephase (Groß-/Kleinschreibung beachten).

        Hinweis:
        Für die Schrittzuordnung zu den Pipelinephasen Jenkins muss das Feld Orchestration-Phase konfiguriert sein.
        Business-Service Konfigurationsservice, der für den Schritt gilt.

        Sobald die Orchestration-Aufgaben erstellt wurden, ordnen Sie jede Orchestration-Aufgabe in der zugehörigen Liste „Orchestration Tasks“ einem Pipelineschritt DevOps zu.

    4. Wahlweise: Aktivieren Sie die Change-Steuerung automatisch oder manuell basierend auf dem Typ der Pipeline.
      • Wenn Sie bei deklarativen oder geskripteten Pipelines das Skript snDevOpsChange in der Pipeline verwendet haben, führen Sie die Pipeline Jenkins aus, um die Change-Steuerung automatisch zu aktivieren. Sie können die Change-Steuerung auch manuell aktivieren, indem Sie die für Freestyle-Aufträge angegebenen Schritte ausführen.
      • Aktivieren Sie bei Freestyle-Aufträgen in einem Schritt das Kontrollkästchen Change-Steuerung, um die Change-Beschleunigung und die entsprechenden Konfigurationsfelder zu aktivieren.
        Hinweis:
        Zur Beschleunigung von Changes muss ServiceNow Change Management installiert sein.
        Änderungsbeleg

        Wählen Sie diese Option aus, um den Change-Beleg für den Schritt zu aktivieren, damit die Pipeline nicht angehalten wird, wenn eine Change-Anforderung erstellt wird.

        Alle Pipeline-Daten sind im Change enthalten, es ist jedoch keine Genehmigung erforderlich, damit die Pipeline fortfahren kann.

        Genehmigungsgruppe ändern

        Genehmigungsgruppe für die Change-Anforderung.

        Die Change-Genehmigungsgruppe wird zur Zuweisungsgruppe im Change Request DevOps.

        Hinweis:
        Stellen Sie sicher, dass die ausgewählte Gruppe Mitglieder und einen Gruppenmanager hat, damit das Feld „Genehmiger“ nicht leer ist.
        Änderungstyp Ändern Sie den Anforderungstyp in „Erstellen“.
        • Normal (Standard)
        • Standard
        • Notfall
        Change-Modell Change-Modell für die Change-Anforderung. Weitere Informationen finden Sie unter DevOps Change-Modelle.

        Vorlage

        Hinweis:
        Dieses Feld wird nur angezeigt, wenn der Change-Typ Normal oder Notfall ist.

        Liste der Vorlagen, die zum automatischen Ausfüllen von Feldern für normale oder Notfall-Change-Anforderungen verwendet werden.

        Wählen Sie eine Vorlage aus, oder erstellen Sie eine neue.

        Standard-Change-Vorlage

        Hinweis:
        Dieses Feld wird nur angezeigt, wenn der Change-Typ Standard ist.
        Liste der Standard-Change-Vorlagen zur Verwendung für Standard-Change-Anforderungen.
        Hinweis:
        Dieses Feld ist für den Change-Typ „Standard“ erforderlich.
        Gesteuerte Verzweigungen ändern

        (Nur mehrere Verzweigungen) Kommagetrennte Liste der Verzweigungen unter Change-Steuerung. Platzhalter werden unterstützt.

    5. Navigieren zu DevOps > Tools > Orchestration-Tools und kopieren Sie im Tooldatensatz Jenkins den Feldwert DevOps Webhook-URL.
      Die Webhook-URL enthält den Speicherort DevOps für Jenkins zum Senden von Nachrichten, einschließlich der sys_id für das Tool:

      https://<devops.integration.user> :<password> @<your-instance> .service-now.com/api/sn_devops/v1/devops/tool/event/{sys_id des Datensatzes}

    Beispiel

    Abbildung : 1. DevOps-App
    DevOps-Pipeline
    Abbildung : 2. DevOps Pipeline
    DevOps-Pipeline-Schritte
    Abbildung : 3. DevOps Pipeline-Schritt
    DevOps-Pipelinephasen