Configuração do controle de mudanças usando a REST API de invocação do Azure

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura
  • Você pode usar a REST API de invocação do Azure no pipeline do YAML ou do Azure clássico para configurar o controle de mudanças para DevOps.

    Você deve habilitar a propriedade This property decides whether to create a Generic Connection on configure operation for Azure DevOps para usar a API REST de invocação.

    Para obter detalhes da API REST de invocação do Azure, visite o site de documentação da Microsoft e pesquise a tarefa Invocar API REST HTTP - Pipelines do Azure.

    Importante:

    Se você tiver nomes de trabalho duplicados ou reutilizados nas etapas de execução do pipeline, certifique-se de que o atributo stageName contenha azurestageName/jobName em seu valor, ou seja, stageName = azureStageName/jobName. As tarefas de registro de artefatos enviam nomes de fase e trabalho para associar a versão do artefato à execução de tarefa correta.

    Conexão de serviço genérica

    O uso da REST API de invocação do Azure requer a criação de uma conexão de serviço genérica em Azure DevOps.

    Conexão de controle de mudança da REST API do YAML do Azure

    Pipeline do YAML do Azure

    Em Azure DevOps, uma tarefa do servidor deve ser criada com a conexão de serviço como o endpoint de controle de mudança.

    Tabela 1. Invocar requisitos de carga da REST API
    Tipo de pipeline do Azure Valores
    Compilação
    • buildNumber
    • éMultiBranch
    • Nome da ramificação
    Versão
    • número da versão
    • projectName
    Nota:
    Para pipelines de versão, defina o Condições de pré-implantação > Avançado > Evento de conclusão campo para Retorno de chamada.
    Criar pipeline:
    
    - task: InvokeRESTAPI@1
          inputs:
            connectionType: 'connectedServiceName'
            serviceConnection: 'change1'
            method: 'POST'
            body: |
             {
                "buildNumber": "$(build.buildId)",
                "isMultiBranch": "true",
                "branchName": "$(build.sourceBranchName)"
             }
            waitForCompletion: 'true'
    Pipeline de versão:
    
    - task: InvokeRESTAPI@1
          inputs:
            connectionType: 'connectedServiceName'
            serviceConnection: 'change1'
            method: 'POST'
            body: |
             {
                "releaseNumber": "$(Release.ReleaseId)",
                "projectName": "$(System.TeamProject)"
             }
            waitForCompletion: 'true'

    Pipeline do Azure clássico

    Para um pipeline do Azure clássico, uma tarefa do servidor Invocar REST API deve ser adicionada.

    Figura 1. Exemplo de pipeline de compilação do Azure clássico
    Controle de mudança da API REST de invocação do pipeline do Azure
    Figura 2. Exemplo de pipeline de versão do Azure clássico
    Pipeline de versão clássica do DevOps Azure