Configuration du contrôle des changements à l’aide de l’API REST Azure Invoke

Vous pouvez utiliser l’API REST Azure Invoke dans votre pipeline YAML ou Azure classique pour configurer le contrôle des changements pour DevOps.

Vous devez activer la propriété pour utiliser l’API This property decides whether to create a Generic Connection on configure operation for Azure DevOps REST.

Pour obtenir des détails sur l’invocation de l’API REST Azure, visitez le site de documentation Microsoft et recherchez la tâche Appeler l’API REST HTTP : Azure Pipelines.

Important :

Si vous avez des noms de tâches en double ou réutilisés dans les étapes d’exécution de votre pipeline, assurez-vous que l’attribut stageName contient azurestageName/jobName dans sa valeur, c’est-à-dire stageName = azureStageName/jobName. Les tâches d’enregistrement d’artefact envoient des noms d’étape et de tâche pour associer la version de l’artefact à l’exécution correcte de la tâche.

Connexion de service générique

L’utilisation de l’API REST Azure Invoke nécessite la création d’une connexion de service générique dans Azure DevOps.

Pipeline Azure YAML

Dans Azure DevOps, une tâche serveur doit être créée avec la connexion de service comme point de terminaison de contrôle des changements.

Tableau 1. Appeler les besoins de charge utile de l’API REST

Type de pipeline Azure	Valeurs
Version	buildNumber isMultiBranch Nom de branche
Mise en production	numéro de mise en production projectName

Remarque :

Pour les pipelines de mise en production, définissez les Conditions de pré-déploiement > Avancés > Événement d’achèvement champ à rappeler.

Pipeline de version :

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

Pipeline de mise en production :

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

Pipeline Azure classique

Pour un pipeline Azure classique, une tâche serveur Appeler l’API REST doit être ajoutée.

Figure 1. Exemple de pipeline de version Azure classique

Figure 2. Exemple de pipeline de mise en production Azure classique