Change-Steuerung mit der Azure Invoke-REST-API konfigurieren

Sie können die Azure Invoke-REST API in Ihrer YAML- oder klassischen Azure-Pipeline verwenden, um die Change-Steuerung für DevOpszu konfigurieren.

Sie müssen die Eigenschaft This property decides whether to create a Generic Connection on configure operation for Azure DevOps aktivieren, um die REST-API aufrufen zu können.

Einzelheiten zum Aufrufen der REST-API für Azure finden Sie auf der Microsoft-Dokumentationswebsite, und suchen Sie nach der Aufgabe HTTP-REST-API aufrufen – Azure Pipelines.

Wichtig:

Wenn Sie doppelte oder wiederverwendete Job-Namen in den Pipeline-Ausführungsschritten haben, stellen Sie sicher, dass das Attribut stageName den Wert azurestageName/jobName enthält, d. h . stageName = azureStageName/jobName. Die Artefaktregistrierungsaufgaben senden sowohl Phasen- als auch Auftragsnamen, um die Artefaktversion der richtigen Aufgabenausführung zuzuordnen.

Generische Serviceverbindung

Die Verwendung der Azure Invoke-REST API erfordert die Erstellung einer generischen Serviceverbindung in Azure DevOps.

YAML-Azure-Pipeline

In Azure DevOpsmuss eine Serveraufgabe mit der Serviceverbindung als Endpunkt für die Change-Steuerung erstellt werden.

Tabelle : 1. Rufen Sie die REST API-Nutzlastanforderungen auf

Azure-Pipeline-Typ	Werte
Bauen	buildNumber istMultiBranch branchName
Release	releaseNummer projectName

Hinweis:

Legen Sie für Release-Pipelines die fest Bedingungen vor der Bereitstellung > Erweitert > Abschlussereignis Feld für Rückruf.

Pipeline erstellen:

- task: InvokeRESTAPI@1
      inputs:
        connectionType: 'connectedServiceName'
        serviceConnection: 'change1'
        method: 'POST'
        body: |
         {
            "buildNumber": "$(build.buildId)",
            "isMultiBranch": "true",
            "branchName": "$(build.sourceBranchName)"
         }
        waitForCompletion: 'true'

Release-Pipeline:

- task: InvokeRESTAPI@1
      inputs:
        connectionType: 'connectedServiceName'
        serviceConnection: 'change1'
        method: 'POST'
        body: |
         {
            "releaseNumber": "$(Release.ReleaseId)",
            "projectName": "$(System.TeamProject)"
         }
        waitForCompletion: 'true'

Klassische Azure-Pipeline

Für eine klassische Azure-Pipeline muss eine Serveraufgabe „REST API aufrufen“ hinzugefügt werden.

Abbildung : 1. Beispiel für eine klassische Azure-Build-Pipeline

Abbildung : 2. Beispiel für eine klassische Azure-Release-Pipeline