ALM, DevOps

Git Pull Request no Azure DevOps via PowerShell

Durante o um processo de Contínuos Deploy, em muitos momentos precisamos desenvolver automações via script (Ex: PowerShell) para atendermos necessidades internas deste processo.

Uma necessidade comum é ao final de um processo de deploy para uma aplicação, após claro todas as aprovações necessários é de enviarmos todo o código produzido, homologado e publicado em produção da branch de Release, para a sua branch principal (master). Com esta necessidade em mãos desenvolvi um script em Powershell básico para fazermos um pull request utilizando para isso as APIs do Azure DevOps. Vamos a código:

Criando um Pull Request

Primeiro passo é criarmos o pull request em sim, passo que podemos ver abaixo:

function New-AzureDevOpsPullRequest {

    [CmdletBinding()]
    param([Parameter(Mandatory=$true)][System.String]$token,
          [Parameter(Mandatory=$true)][System.String]$vstsAccount,
          [Parameter(Mandatory=$true)][System.String]$projectName,
          [Parameter(Mandatory=$true)][System.String]$repositoryId,
          [Parameter(Mandatory=$true)][System.String]$BranchSourceRefName,
          [Parameter(Mandatory=$true)][System.String]$BranchTargetRefName,
          [Parameter(Mandatory=$true)][System.String]$Title,
          [Parameter(Mandatory=$true)][System.String]$Description,
          [Parameter(Mandatory=$true)][System.String]$reviewersId,
          [Parameter(Mandatory=$false)][System.Int32]$pullRequestId=$null)

        #Base64-encodes the Personal Access Token (PAT) appropriately
        $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f "",$token)))

        #API do Azure DevOps para criarmos o pull request. Documentação: https://docs.microsoft.com/pt-br/rest/api/azure/devops/git/pull%20requests?view=azure-devops-rest-5.1
        $uri = "https://dev.azure.com/$($vstsAccount)/$($projectName)/_apis/git/repositories/$($repositoryId)/pullrequests?api-version=5.1"

        #Informações básicas para criarmos um pull request. Enviaremos as informações no corpo da chamada da API.
        $body = @"
                {
                    "sourceRefName": "$BranchSourceRefName",
                    "targetRefName": "$BranchTargetRefName",
                    "title": "$Title",
                    "description": "$Description",
                    "status": "completed",
                    "reviewers": [
                                    {
                                        "id": "$reviewersId"
                                    }
                                ]
                }
"@

        #Chamada da API, criando o pull request
        $result = Invoke-RestMethod -Uri $uri -Method 'POST' -ContentType "application/json" -Body $body -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)}
        
        return $result.pullRequestId;
}

Esta função permite criarmos um pull request entre duas branchs dentro do repositório indicado no Azure DevOps. Percebam que podemos durante a criação de pull request podemos informar uma lista de revisores, que no caso serão responsáveis por aprovar esta requisição.

Com uma solicitação de pull request feita podemos partir para aprovação da mesma também claro de maneira automática.

Aprovando um pull request

Para aprovarmos um pull request via programação, primeiramente precisamos saber quais são os “reviewers” associados ao mesmo. Para isso a Microsoft nos oferece a seguinte API: Pull Request Reviewers – List

Baseado neste documentação podemos criar uma nova função como o exemplo abaixo:

 

function Get-AzureDevOpsPullRequestReviewer {

    [CmdletBinding()]
    param([Parameter(Mandatory=$true)][System.String]$token,
          [Parameter(Mandatory=$true)][System.String]$vstsAccount,
          [Parameter(Mandatory=$true)][System.String]$projectName,
          [Parameter(Mandatory=$true)][System.String]$repositoryId,
          [Parameter(Mandatory=$true)][System.String]$pullRequestId,
          [Parameter(Mandatory=$false)][System.String]$reviewerId=$null)

    $uri = "https://dev.azure.com/$vstsAccount/$projectName/_apis/git/repositories/$repositoryId/pullrequests/$pullrequestId/reviewers";

    if ($reviewerId) { $uri = "$uri/$reviewerId" }

    $uri = "$uri`?api-version=5.0";

    #Base64-encodes the Personal Access Token (PAT) appropriately
    $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f "",$token)))


    #Busca revisores
    $result = Invoke-RestMethod -Uri $uri -Method 'GET' -ContentType "application/json" -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)}
    
    return $result.value[0]
}

A função acima consulta os revisores do pull request retornando todas as informações do objeto para que possamos usar na aprovação abaixo:

function Approve-AzureDevOpsPullRequest {

    [CmdletBinding()]
    param([Parameter(Mandatory=$true)][System.String]$token,
          [Parameter(Mandatory=$true)][System.String]$vstsAccount,
          [Parameter(Mandatory=$true)][System.String]$projectName,
          [Parameter(Mandatory=$true)][System.String]$repositoryId,
          [Parameter(Mandatory=$true)][System.String]$pullRequestId,
          [Parameter(Mandatory=$true)]$reviewer)

    $uri = "https://dev.azure.com/$vstsAccount/$projectName/_apis/git/repositories/$repositoryId/pullrequests/$pullRequestId/reviewers/$($reviewer.id)`?api-version=5.0"

    #Base64-encodes the Personal Access Token (PAT) appropriately
    $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f "",$token)))

    $body = ConvertTo-Json($reviewer);

    $result = Invoke-RestMethod -Uri $uri -Method 'PUT' -ContentType "application/json" -Body $body -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)}
    
    return $result;
}

Completando um pull request

Com as informações necessárias em mãos podemos partir para a aprovação do pull request usando mais uma API fornecida pela Microsoft: https://docs.microsoft.com/pt-br/rest/api/azure/devops/git/pull%20requests/update?view=azure-devops-rest-5.1

function Complete-AzureDevOpsPullRequest {

    [CmdletBinding()]
    param([Parameter(Mandatory=$true)][System.String]$token,
          [Parameter(Mandatory=$true)][System.String]$vstsAccount,
          [Parameter(Mandatory=$true)][System.String]$projectName,
          [Parameter(Mandatory=$true)][System.String]$repositoryId,
          [Parameter(Mandatory=$true)][System.String]$autoCompleteSetBy,
          [Parameter(Mandatory=$true)][System.String]$deleteSourceBranch,
          [Parameter(Mandatory=$true)][System.String]$mergeCommitMessage,
          [Parameter(Mandatory=$true)][System.String]$squashMerge,
          [Parameter(Mandatory=$true)][System.Int32]$pullRequestId)

        #Base64-encodes the Personal Access Token (PAT) appropriately
        $base64AuthInfo = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes(("{0}:{1}" -f "",$token)))

        $uri = "https://dev.azure.com/$($vstsAccount)/$($projectName)/_apis/git/repositories/$($repositoryId)/pullrequests/$($pullRequestId)?api-version=5.0"
        
        $body = @"
        {
            "autoCompleteSetBy": {
              "id": "$autoCompleteSetBy"
            },
            "completionOptions": {
              "deleteSourceBranch": "$deleteSourceBranch",
              "mergeCommitMessage": "$mergeCommitMessage",
              "squashMerge": "$squashMerge"
            }
          }
"@

        $result = Invoke-RestMethod -Uri $uri -Method PATCH -ContentType "application/json" -Body $body -Headers @{Authorization=("Basic {0}" -f $base64AuthInfo)}

        return $result
}

Utilizando o script completo

Agora com as funções criadas temos um script completo (veja o script completo no Github), bastando apenas fazermos as chamadas das funções:

$vstsAccount = "konia";
$projectName = "Demo_Git";
$repositoryId = "7f7a7a24-4afc-4632-830a-czcdfs343cssda";
$token = "sadaklfgnjaslk87ad879af8890987asdfas89798a";
$reviewerId = "558f88c1-e5ba-46bb-8481-asddsfksdfgj9990ds";


$pullRequestId = New-AzureDevOpsPullRequest -token $token -vstsAccount $vstsAccount -projectName $projectName -repositoryId $repositoryId -BranchSourceRefName "refs/heads/master" -BranchTargetRefName "refs/heads/stage" -Title "Titulo do Pull Request" -Description "Descricao do pull request" -reviewersId $reviewerId

$reviewer = Get-AzureDevopsPullRequestReviewer -token $token -vstsAccount $vstsAccount -projectName $projectName -repositoryId $repositoryId -pullRequestId $reviewerId

$reviewer.vote = 10; #aprovado

Approve-AzureDevOpsPullRequest -token $token -vstsAccount $vstsAccount -projectName $projectName -repositoryId $repositoryId -pullRequestId $pullRequestId -reviewer $reviewer;

Complete-AzureDevOpsPullRequest -token $token -vstsAccount $vstsAccount -projectName $projectName -repositoryId $repositoryId -pullRequestId $pullRequestId -autoCompleteSetBy $reviewerId -deleteSourceBranch "false" -mergeCommitMessage "Commit do pull request" -squashMerge "false"

[su_divider]

Não quer perder mas nenhuma informação sobre ALM, DevOps e Cloud, então não esqueça de me acompanhar nas redes sociais

[su_table]

Facebook Youtube Twitter Github
[su_qrcode data=”https://www.facebook.com/adrianobertucciMVP/” title=”Facebook” size=”50″ align=”center” link=”https://www.facebook.com/adrianobertucciMVP/”] [su_qrcode data=”https://www.youtube.com/c/ALMBrasil?sub_confirmation=1″ title=”Youtube” size=”50″ align=”center” link=”https://www.youtube.com/c/ALMBrasil?sub_confirmation=1″] [su_qrcode data=”https://www.twitter.com/adrianobertucci” title=”Twitter” size=”50″ align=”center” link=”https://www.twitter.com/adrianobertucci”]

[/su_table]

[su_divider]

Deixe uma resposta