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

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 1 minute de lecture
  • 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 Invoke.

    Pour plus d’informations sur l’API REST d’invocation Azure, consultez le site de documentation Microsoft et recherchez la tâche Invoquer l’API REST HTTP : pipelines Azure.

    Important :

    Si vous avez des noms de tâches en double ou réutilisés dans vos étapes d’exécution de pipeline, assurez-vous que l’attribut stageName contient azurestageName/jobName dans sa valeur, c’est-à-dire stageName = azureStageName/jobName. Les tâches d’enregistrement de l’artefact envoient à la fois les 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.

    Connexion de contrôle des changements de l’API REST YAML Azure

    Pipeline Azure YAML

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

    Tableau 1. Invoquer les besoins de charge utile de l’API REST
    Type de pipeline Azure Valeurs
    Version
    • buildNumber
    • isMultiBranch (en anglais seulement)
    • branchName
    Version
    • releaseNumber
    • projectName
    Remarque :
    Pour les pipelines de mise en production, définissez l’attribut 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 de serveur d’invocation de l’API REST doit être ajoutée.

    Figure 1. Exemple de pipeline de version Azure classique
    Azure Pipeline : appeler le contrôle de changement de l’API REST
    Figure 2. Exemple de pipeline de version Azure classique
    DevOps Azure : pipeline de mise en production classique