Verwenden Sie die Erweiterung ServiceNow DevOps für die anwenderdefinierten Aktionen Azure DevOps und Azure DevOps .

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 7 Minuten Lesedauer

    • Installieren und konfigurieren Sie die Erweiterung DevOps für Azure DevOps, um Build- und Release-Benachrichtigungen aus Ihrer Azure-Pipeline an DevOps Change-Geschwindigkeitzu senden.

    Vorbereitungen

    Erforderliche Rolle: sn_devops.admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können die ServiceNow DevOps- Erweiterung im Visual Studio Marketplace – Erweiterungen für Azure DevOps verwenden, um Ihre Azure-Pipeline mit der Anwendung ServiceNow DevOps zu integrieren. Weitere Informationen zu Artefakten und Paketen in DevOps Change-Geschwindigkeitfinden Sie unter Artefakte und Pakete.

    • ServiceNow DevOps -Serviceverbindung

      Erforderlich, um die Azure-Pipeline mit zu verbinden ServiceNow

    • ServiceNow DevOps Release-Gate

      Erforderlich, um die Change-Steuerung in Azure-Release-Pipelines (CD) zu aktivieren (nur für Bedingungen vor der Bereitstellung).

    Benutzerdefinierte Aufgaben in der Azure Build (CI)-Pipeline:
    • Agentloser (Server-)Auftrag
      • Anwenderdefinierte Aufgabezur Registrierung von ServiceNow DevOps-Serverartefakten

        Erforderlich für agentenlose (Server-)Aufträge, um ein Artefakt in der Instanz ServiceNow zu registrieren

      • Anwenderdefinierte Aufgabezur Registrierung von ServiceNow DevOps-Serverpaketen

        Ist für Aufgaben ohne Agent (Server) erforderlich, um ein Paket in der Instanz ServiceNow zu registrieren

      • Anwenderdefinierte Aufgabezur Beschleunigung von ServiceNow DevOps-Server-Changes

        Ist für Aufträge ohne Agent (Server) erforderlich, um automatisch eine Change-Anforderung in ServiceNow Change-Management als Teil der Azure-Pipeline zu erstellen.

        Hinweis:
        Für die Aufgabe „ServiceNow DevOps-Server-Change-Beschleunigung“ sind keine Aufgaben für ServiceNow DevOps-Serverauftragsbenachrichtigungen erforderlich.
      • ServiceNow DevOps Server – Anwenderdefinierte Change-Aufgabe abrufen

        Erforderlich, um die Anzahl der Change-Anforderungen in einer Pipeline basierend auf bestimmten Change-Details für einen Serverauftrag abzurufen.

      • Anwenderdefinierte Aufgabezum Ändern des ServiceNow DevOps-Server-Updates

        Erforderlich, um die Details der Change-Anforderung zu aktualisieren, die einer Pipeline für einen Serverauftrag zugeordnet sind.

    • Agent-Auftrag
      • Anwenderdefinierte Aufgabezur Registrierung von ServiceNow DevOps-Agent-Artefakten

        Erforderlich für Agent-Aufträge, um ein Artefakt in der Instanz ServiceNow zu registrieren

      • Anwenderdefinierte Aufgabezur Registrierung des ServiceNow DevOps-Agent-Pakets

        Erforderlich für Agent-Aufträge zum Registrieren eines Pakets in der Instanz ServiceNow .

      • Anwenderdefinierte Aufgabezum Abrufen von Changes für ServiceNow DevOps-Agents

        Erforderlich, um die Nummer der Change-Anforderung in einer Pipeline basierend auf bestimmten Change-Details für einen Agent-Auftrag abzurufen.

      • Anwenderdefinierte Aufgabezum Ändern von ServiceNow DevOps-Agent-Updates

        Erforderlich, um die Details der Change-Anforderung zu aktualisieren, die einer Pipeline für einen Agent-Auftrag zugeordnet sind.

      Hinweis:
      Die Aufgaben „ServiceNow DevOps-Agent-Artefaktregistrierung“ und „ServiceNow DevOps-Agent-Paketregistrierung“ werden für Release-Pipelines nicht unterstützt.
    • Softwarequalitätsprüfungen (SonarQube/SonarCloud)
      • Benutzerdefinierte Aufgabe„ServiceNow DevOps-Build-Sonar-Registrierung“ (für Build-Pipelines)
      • Anwenderdefinierte Aufgabezur Sonar-Registrierung von ServiceNow DevOps-Releases (für Release-Pipelines)
      Hinweis:
      Die ServiceNow DevOps-Build-Sonar-Registrierungsaufgabe wird für Release-Pipelines nicht unterstützt.
    • Sicherheitsscans:
      • Anwenderdefinierte Aufgabe„ServiceNow DevOps-Build-Sicherheitsergebnisse“ (für Build-Pipelines)
      • Anwenderdefinierte Aufgabe„ServiceNow DevOps Release-Sicherheitsergebnisse“ (für Release-Pipelines)
      Hinweis:
      Die Aufgabe „ServiceNow DevOps – Sicherheitsergebnis erstellen“ wird für Release-Pipelines nicht unterstützt.

    Prozedur

    1. Wechseln Sie zum Visual Studio Marketplace, suchen Sie nach der Erweiterung ServiceNow DevOps, und klicken Sie auf Get it kostenlos erhalten.
      DevOps Azure-Erweiterung
    2. Wählen Sie Ihre Organisation Azure DevOps und dann Installierenaus.
    3. Navigieren Sie aus Ihrem Projekt Azure DevOps zu Projekteinstellungen > Pipelines > Serviceverbindungen.
    4. Wählen Sie New service connection (Neue Serviceverbindung) und anschließend ServiceNow DevOpsaus.
    5. Wählen Sie Weiter aus und geben Sie die folgenden Details ein:
      Authentifizierungsmethode Wählen Sie aus, ob die Authentifizierung tokenbasiert oder standardmäßig erfolgt.
      ServiceNow-Instanz

      https://<your-instance> .service-now.de/
      Tool-ID

      Die sys_id des Orchestration-Tools.

      Sie können diesen Wert mit dem Befehl sys_id kopieren im Formular „Orchestration Tool“ kopieren. Wenn Sie den Arbeitsbereich verwenden, wählen Sie im Formular Azure DevOps das Tool „Weitere Formularoptionen“ ( Symbol „Weitere Formularoptionen“) > „sys_id kopieren“. Wenn Sie Servicekatalog oder Classic verwenden, wählen Sie im Formular Azure DevOps das Tool „Zusätzliche Aktionen“ ( Symbol „Zusätzliche Aktionen“ ) > „Sys_id kopieren“ aus.
      Anwendername Geben Sie devops.integration.userein.
      Hinweis:
      Die Eingabe des Integrationsbenutzernamens und des Passworts ist nur dann für die Konfiguration erforderlich, wenn DevOps Config installiert oder die Eigenschaft This property decides whether to create a Generic Connection on configure operation for Azure DevOps deaktiviert ist. Wenn dieser Schritt nicht erforderlich ist, werden Webhooks mithilfe der tokenbasierten Authentifizierung konfiguriert.
      Passwort Passwort für DevOps-Integrationsanwender.
      Hinweis:
      Die Eingabe des Integrationsbenutzernamens und des Passworts ist nur dann für die Konfiguration erforderlich, wenn DevOps Config installiert oder die Eigenschaft This property decides whether to create a Generic Connection on configure operation for Azure DevOps deaktiviert ist. Wenn dieser Schritt nicht erforderlich ist, werden Webhooks mithilfe der tokenbasierten Authentifizierung konfiguriert.
      API-Token API-Token für die Verbindung mit dem Endpunkt.
      Serviceverbindungsname Geben Sie die DevOps-Verbindungein
      Erteilen Sie allen Pipelines Zugriffsberechtigungen Aktivieren Sie die Checkbox.

    Beispiel

    Abbildung : 1. Azure Pipeline: Standardauthentifizierungsmethode für ServiceNow DevOps-Serviceverbindungen
    Neue Serviceverbindung in Azure DevOps für Standardauthentifizierungsmethode
    Abbildung : 2. Azure Pipeline: Authentifizierungsmethode auf Basis des ServiceNow DevOps-Serviceverbindungstokens
    Neue Serviceverbindung in Azure DevOps für die tokenbasierte Authentifizierungsmethode

    Richten Sie eine Azure Build(CI)-Pipeline in ein DevOps

    Verwenden Sie die Erweiterung ServiceNow DevOps für Azure DevOps, um die Change-Steuerung sowie Artefakte und Pakete in Ihrer Azure Build(CI)-Pipeline zu konfigurieren.

    Vorbereitungen

    Erforderliche Rolle: sn_devops.admin

    Prozedur

    1. Navigieren Sie in Ihrer Azure DevOps-Instanz zu Pipelines.
    2. Wählen Sie die Pipeline aus, für die Sie die Change-Steuerung aktivieren möchten.
    3. Wählen Sie Ansichtaus.
      Der YAML-Editor für die Pipeline wird zusammen mit dem Suchbereich Aufgaben auf der rechten Seite angezeigt.
    4. Suchen Sie im Aufgabenbereich nach der gewünschten anwenderdefinierten Aktion, und wählen Sie sie aus.
      Anwenderdefinierte Aktion Schritte
      ServiceNow DevOps Server Change Acceleration
      1. Geben Sie im Feld AnzeigenameServiceNow Change Acceleration ein.
      2. Geben Sie im Feld ServiceNow-EndpunktMeine Verbindungein.
      3. Geben Sie im Feld Vorgelagerter Auftrag ausgeführt den Wert ein, der den vorherigen Auftrag in der Warteschlange angibt. Der Auftrag vor dem Server könnte beispielsweise Testsein.
      4. Legen Sie im Feld Details zur Change-Anforderungden Abschlusscode und die Felder Change-Anforderung aus der Pipeline fest.
      Wählen Sie das Informationssymbol, um eine Beispielausgabe anzuzeigen.

      Weitere Informationen zur Change-Beschleunigung finden Sie unter Change-Beschleunigung.
      ServiceNow DevOps – Agent-Artefaktregistrierung
      1. Geben Sie im Feld ServiceNow-EndpunktMeine Verbindungein.
      2. Geben Sie im Feld Nutzlast der Artefakte die JSON-Datei ein, die die Liste der Artefakte enthält.
      Weitere Informationen zu Artefakten finden Sie unter Artefakte und Pakete.
      ServiceNow DevOps – Agent-Paketregistrierung
      1. Geben Sie im Feld ServiceNow-EndpunktMeine Verbindungein.
      2. Geben Sie im Feld Paketname den Namen des Pakets ein, das Artefakte enthält.
      3. Geben Sie im Feld Nutzlast der Artefakte das JSON-Objekt ein, das Build-Details und die Liste der Artefakte enthält.
      Weitere Informationen zu Artefakten finden Sie unter Artefakte und Pakete.
      ServiceNow DevOps-Server – Change abrufen Ruft Details zu Change-Anforderungen in der Pipeline Azure DevOps ab, und aktualisiert sie
      ServiceNow DevOps-Serverupdate-Change Ruft Details zu Change-Anforderungen in der Pipeline Azure DevOps ab, und aktualisiert sie
      ServiceNow DevOps-Agent – Change abrufen Ruft Details zu Change-Anforderungen in der Pipeline Azure DevOps ab, und aktualisiert sie
      ServiceNow DevOps – Agent-Update-Change Ruft Details zu Change-Anforderungen in der Pipeline Azure DevOps ab, und aktualisiert sie
    5. Wählen Sie Hinzufügenaus, um die anwenderdefinierte Aufgabe zum Abschnitt Aufgaben Ihrer Azure-Pipeline hinzuzufügen.

    Beispiel

    Abbildung : 3. Azure-Pipeline: Anwenderdefinierte Aufgabe zur ServiceNow DevOps-Change-Beschleunigung
    Erweiterung „DevOps Azure Change“.
    Erweiterung „DevOps ServiceNow Change Acceleration“.

    Azure DevOps anwenderdefinierte Serveraufgaben

    Abbildung : 4. Beispiel für Details einer Change-Anforderung
    DevOps Azure-Change-Details

    Richten Sie in eine Azure-Release-Pipeline (CD) ein DevOps

    Verwenden Sie die Erweiterung ServiceNow DevOps für Azure DevOps, um die Change-Steuerung sowie Artefakte und Pakete in Ihrer Azure-Release-Pipeline (CD) zu konfigurieren.

    Vorbereitungen

    Erforderliche Rolle: sn_devops.admin

    Warum und wann dieser Vorgang ausgeführt wird

    Hinweis:
    Die Change-Steuerung in Azure-Release-Pipelines (CD) wird nur in Toren vor der Bereitstellung unterstützt. Change-Anforderungen für das Tor vor der Bereitstellung werden der Schrittausführung des ersten Auftrags in dieser Phase zugeordnet.

    Phasen in einer Azure-Release-Pipeline werden einem Schritt zugeordnet. Der Schrittname für einen Auftrag mit mehreren Konfigurationen oder mehreren Agents darf nur den Phasennamen und nicht den tatsächlichen Auftragsnamen enthalten, der zur Laufzeit der Pipeline-Ausführung abgeleitet wird.

    Aufgabenausführungen für übersprungene Aufgaben werden als fehlgeschlagen markiert.

    Prozedur

    1. Wählen Sie unter Azure DevOps Pipelines die Option aus Pipelines > Releases, und wählen Sie dann Ihre Release-Pipeline aus.
    2. Wählen Sie Bearbeiten aus, um den Pipeline-Editor zu öffnen.
    3. Wählen Sie das Vor-Bereitstellungssymbol ( Vor-Bereitstellungssymbol) für Ihre Phase und dann die Umschaltfläche, um Gateszu aktivieren. Aktivieren Sie „Gates“ in den Bedingungen vor der Bereitstellung
    4. Wählen Sie +Hinzufügenund anschließend ServiceNow DevOps Release-Gateaus. Fügen Sie das ServiceNow DevOps-Release-Gate hinzu
    5. Wählen Sie ServiceNow DevOps Release-Gate und anschließend den ServiceNow-Endpunkt aus. ServiceNow DevOps-Release-Gate-Felder
    6. Beenden Sie die Release-Gate-Konfiguration, und erweitern Sie den Abschnitt „Bewertungsoptionen“, um die folgenden Timing-Felder zu konfigurieren.
      Die Zeit zwischen der erneuten Auswertung von Toren

      Intervall für erneute Auswertung in Minuten, Stunden oder Tagen.

      Wenn die Change-Anforderung abgebrochen oder abgelehnt wird, wertet das Releasegate der Azure-Pipeline den Status der Change-Anforderung im konfigurierten Intervall bis zur Zeitüberschreitung neu aus.

      Für weitere Neubewertungsversuche ist keine Benutzerinteraktion erforderlich, nachdem die Change-Anforderung bereits genehmigt, abgelehnt oder storniert wurde.
      Die Zeitüberschreitung, nach der ein Tor fehlschlägt Zeitüberschreitungswert in Minuten, Stunden oder Tagen.

      Wenn die Bedingungen für die Vorbereitstellung fehlschlagen, werden die nachfolgenden Aufträge der Phase als fehlgeschlagen markiert, und Start- und Endzeit werden standardmäßig auf die aktuelle Systemzeit festgelegt.
      Abbildung : 5. Azure-Release-Pipeline-Gate-Konfiguration vor der Bereitstellung
      DevOps Azuregate-Konfiguration
    7. Wahlweise: Artefakte in Ihrer Azure-Release-Pipeline (CD) konfigurieren.
      Um Artefakte mit der Build-Pipeline als Quelle einzurichten, müssen diese Namen übereinstimmen.
      • Repository-Name und Build-Pipeline-Name (z. B. DeployableRepo).
      • Namenseigenschaft des Build-Pipeline-Artefakts und Quellenalias-Eigenschaft des Release-Pipeline-Artefakts (z. B. BuildDrop).
      Zusätzlich zur Build-Pipeline können Sie Artefakte aus acht weiteren Quellen auswählen. Befolgen Sie diese Regeln, um Commit- und Arbeitselementdetails nachzuverfolgen.
      • Wenn die Quelle die Build-Pipeline ist, muss die semantische Versionseigenschaft der Artefakte das Format MAJOR.MINOR.PATCH haben (z. B. 5.1.3).
      • Wenn die Quelle nicht die Build-Pipeline ist, definieren Sie eine semantische Version durch die Implementierung der DevOpsArtifactSemanticVersionAPI -Erweiterungsschnittstelle.

      Weitere Informationen zu Artefakten finden Sie unter Artefakte und Pakete.

    Beispiel

    Abbildung : 6. Artefakt-Setup – Build-Pipeline-Quelle
    YAML-Konfiguration des DevOps-Artefakts
    Abbildung : 7. Artefakt-Setup – Release-Pipeline
    Konfiguration der DevOps-Artefaktpipeline