Configure manualmente o fluxo de trabalho de CI/CD para executar testes de carga

2025-04-04

Você pode automatizar um teste de carga no Teste de Carga do Azure criando um pipeline de CI/CD. Neste artigo, você aprenderá a configurar manualmente as Ações do GitHub, os Pipelines do Azure ou outras ferramentas de CI para invocar um teste existente no Teste de Carga do Azure. Automatize um teste de carga para validar continuamente o desempenho e a estabilidade do aplicativo sob carga.

Para adicionar um teste de carga existente a um pipeline de CI/CD:

Configure a autenticação de serviço para permitir que a ferramenta de CI se conecte ao seu recurso de teste de carga do Azure.
Adicione arquivos de entrada de teste de carga ao repositório, como o script de teste e a configuração do YAML de teste de carga.
Atualize a definição de pipeline de CI/CD para invocar o Teste de Carga do Azure.

Pré-requisitos

Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.
Um teste de carga do Azure. Crie um teste de carga baseado em URL, use um script JMeter existente ou um script Locust existente para criar um teste de carga.

Uma organização e um projeto do Azure DevOps. Se você não tiver uma organização do Azure DevOps, poderá criar uma gratuitamente. Se precisar de ajuda para começar a usar o Azure Pipelines, consulte Criar seu primeiro pipeline.

Configurar autenticação de serviço

Para executar um teste de carga em seu fluxo de trabalho de CI/CD, você precisa conceder permissão ao fluxo de trabalho de CI/CD para acessar seu recurso de teste de carga. Crie uma entidade de serviço para o fluxo de trabalho de CI/CD e atribua a função RBAC do Azure de Colaborador de Teste de Carga.

Criar uma conexão de serviço no Azure Pipelines

No Azure Pipelines, você cria uma conexão de serviço em seu projeto do Azure DevOps para acessar recursos em sua assinatura do Azure. Quando você cria a conexão de serviço, o Azure DevOps cria um objeto principal de serviço do Microsoft Entra.

Entre em sua organização do Azure DevOps (https://dev.azure.com/<your-organization>) e selecione seu projeto.

Substitua o espaço reservado de texto <your-organization> pelo seu identificador de projeto.
Selecione Configurações do projeto>Conexões de serviço>+ Nova conexão de serviço.
No painel Nova conexão de serviço, selecione o Gerenciador de Recursos do Azure e selecione Avançar.
Selecione o método de autenticação da entidade de serviço (automática) e, em seguida, selecione Avançar.

Insira os detalhes da conexão de serviço e selecione Salvar para criar a conexão de serviço.

Campo	Valor
Nível de âmbito	Subscrição.
Subscrição	Selecione a assinatura do Azure que hospeda seu recurso de teste de carga.
Grupo de recursos	Selecione o grupo de recursos que contém o recurso de teste de carga.
Nome da conexão de serviço	Insira um nome exclusivo para a conexão de serviço.
Conceder permissão de acesso a todos os pipelines	Verificado.

Na lista de conexões de serviço, selecione a conexão que criou anteriormente e, em seguida, selecione Gerir Service Principal.

O portal do Azure é aberto num separador separado do navegador e mostra os detalhes do principal de serviço.
No portal do Azure, copie o valor Nome de exibição.

Use esse valor na próxima etapa para conceder permissões para a execução de testes de carga na entidade de serviço.

Conceder acesso ao Teste de Carga do Azure

O Teste de Carga do Azure usa o RBAC do Azure para conceder permissões para executar atividades específicas em seu recurso de teste de carga. Para executar um teste de carga a partir do pipeline de CI/CD, conceda a função de Colaborador de Teste de Carga ao principal de serviço.

No Azure portal, vá ao seu recurso de Teste de Carga do Azure.
Selecione Controle de acesso (IAM)>Adicionar>Adicionar atribuição de função.
Na guia Função, selecione Colaborador de Teste de Carga na lista de funções.
Na guia Membros, selecione Selecionar membros e use o nome de exibição copiado anteriormente para pesquisar a entidade de serviço.
Selecione a entidade de serviço e, em seguida, selecione Selecionar.
No separador Rever + atribuir, selecione Rever + atribuir para adicionar a atribuição de função.

Agora você pode usar a conexão de serviço em sua definição de fluxo de trabalho do Azure Pipelines para acessar seu recurso de teste de carga do Azure.

Para aceder ao seu recurso do Azure Load Testing no fluxo de trabalho do GitHub Actions, primeiro crie uma entidade de serviço do Microsoft Entra. Esta entidade de serviço representa o seu fluxo de trabalho do GitHub Actions no Microsoft Entra ID.

Em seguida, você concede permissões à entidade de serviço para criar e executar um teste de carga com seu recurso de Teste de Carga do Azure.

Criar um principal de serviço

Crie uma entidade de serviço na assinatura do Azure e atribua a função de Colaborador de Teste de Carga para que seu fluxo de trabalho de Ações do GitHub tenha acesso ao seu recurso de teste de carga do Azure para executar testes de carga.

Crie uma entidade de serviço e atribua a Load Test Contributor função:

# Get the resource ID for the load testing resource - replace the text place holders.
loadtest=$(az resource show -g <resource-group-name> -n <load-testing-resource-name> --resource-type "Microsoft.LoadTestService/loadtests" --query "id" -o tsv)
echo $loadtest

# Create a service principal and assign the Load Test Contributor role - the scope is limited to the load testing resource.
az ad sp create-for-rbac --name "my-load-test-cicd" --role "Load Test Contributor" \
                         --scopes $loadtest \
                         --json-auth

A saída é um objeto JSON que representa a entidade de serviço. Você usa essas informações para autenticar com o Azure no fluxo de trabalho de Ações do GitHub.

Creating 'Load Test Contributor' role assignment under scope
{
  "clientId": "00000000-0000-0000-0000-000000000000",
  "clientSecret": "00000000-0000-0000-0000-000000000000",
  "subscriptionId": "00000000-0000-0000-0000-000000000000",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
  "resourceManagerEndpointUrl": "https://management.azure.com/",
  "activeDirectoryGraphResourceId": "https://graph.windows.net/",
  "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
  "galleryEndpointUrl": "https://gallery.azure.com/",
  "managementEndpointUrl": "https://management.core.windows.net/"    
}

Nota

Poderá receber um --sdk-auth aviso de desativação quando executar este comando. Como alternativa, você pode usar a autenticação baseada em OpenID Connect (OIDC) para autenticar o GitHub com o Azure. Saiba como usar a ação de logon do Azure com o OpenID Connect.

Copie o objeto JSON de saída para a área de transferência.

Na próxima etapa, você armazena as informações da entidade de serviço como um segredo de Ações do GitHub.

Armazenar credenciais do Azure no segredo do GitHub Actions

Crie um segredo nas GitHub Actions para armazenar com segurança as informações do principal do serviço. Você usa esse segredo em sua definição de fluxo de trabalho para se conectar para autenticar com o Azure e acessar seu recurso de teste de carga do Azure.

Nota

Se você estiver usando o OpenID Connect para autenticar com o Azure, não precisará passar o objeto principal de serviço na ação de logon do Azure. Saiba como usar a ação de logon do Azure com o OpenID Connect.

Para criar um segredo de Ações do GitHub:

No GitHub, navegue até ao repositório.
Selecione Configurações>>Ações.
Selecione Novo segredo do repositório, insira as informações secretas e selecione Adicionar segredo para criar um novo segredo.

Campo Valor

Nome AZURE_CREDENTIALS

Segredo Cole a saída JSON do comando de criação do principal de serviço copiado anteriormente.

Campo	Valor
Nome	AZURE_CREDENTIALS
Segredo	Cole a saída JSON do comando de criação do principal de serviço copiado anteriormente.

Agora você pode acessar sua assinatura do Azure e o recurso de teste de carga do seu fluxo de trabalho de Ações do GitHub usando as credenciais armazenadas.

Se estiver usando outra ferramenta de CI/CD, use a CLI do Azure para interagir com seus recursos do Azure. Execute as seguintes etapas para autorizar o acesso da ferramenta CI ao seu recurso de teste de carga:

Crie uma entidade de serviço do Microsoft Entra para se conectar à sua subscrição do Azure e aceder ao seu recurso de teste de carga do Azure.
Conceda à entidade de serviço permissões para criar e executar um teste de carga atribuindo a função de Colaborador de Teste de Carga.
Armazene as credenciais do Azure com segurança na ferramenta CI.

Execute as seguintes etapas para configurar a autorização de serviço para sua ferramenta de CI:

Crie um principal de serviço e atribua a função de Colaborador de Teste de Carga:

Substitua os espaços reservados de texto <resource-group-name> e <load-testing-resource-name>.

# Get the resource ID for the load testing resource - replace the text place holders.
loadtest=$(az resource show -g <resource-group-name> -n <load-testing-resource-name> --resource-type "Microsoft.LoadTestService/loadtests" --query "id" -o tsv)
echo $loadtest

# Create a service principal and assign the Load Test Contributor role - the scope is limited to the load testing resource.
az ad sp create-for-rbac --name "my-load-test-cicd" --role "Load Test Contributor" \
                         --scopes $loadtest \
                         --json-auth

A saída é um objeto JSON que representa a entidade de serviço.

Creating 'Load Test Contributor' role assignment under scope
{
  "clientId": "00000000-0000-0000-0000-000000000000",
  "clientSecret": "00000000-0000-0000-0000-000000000000",
  "subscriptionId": "00000000-0000-0000-0000-000000000000",
  "tenantId": "00000000-0000-0000-0000-000000000000",
  "activeDirectoryEndpointUrl": "https://login.microsoftonline.com",
  "resourceManagerEndpointUrl": "https://management.azure.com/",
  "activeDirectoryGraphResourceId": "https://graph.windows.net/",
  "sqlManagementEndpointUrl": "https://management.core.windows.net:8443/",
  "galleryEndpointUrl": "https://gallery.azure.com/",
  "managementEndpointUrl": "https://management.core.windows.net/"    
}

Copie os clientIdvalores , clientSecrete tenantId e armazene-os com segurança como segredos em sua ferramenta de CI.

Você usa esses valores para entrar em sua assinatura do Azure com o comando Azure CLI az login .

Adicionar arquivos de teste de carga em seu repositório

Para executar um teste de carga com o Teste de Carga do Azure em um fluxo de trabalho de CI/CD, você precisa adicionar todos os arquivos de entrada de teste de carga em seu repositório de controle do código-fonte.

Se você não tiver um teste de carga existente, adicione os seguintes arquivos ao repositório de código-fonte:

Teste de carga do arquivo YAML de configuração. Saiba como pode criar um ficheiro YAML de configuração de teste de carga.
Arquivo de plano de teste. Para testes baseados em JMeter, adicione um script de teste JMeter (JMX arquivo). Para testes baseados em gafanhotos, adicione um script de teste de gafanhotos (.py arquivo). Para testes baseados em URL, adicione um arquivo JSON de solicitações.
Quaisquer ficheiros de propriedades de utilizador JMeter.
Todos os arquivos de dados de entrada que seu plano de teste usa. Por exemplo, arquivos de dados CSV.

Se você tiver um teste de carga existente, poderá baixar as definições de configuração e todos os arquivos de entrada diretamente do portal do Azure. Execute as seguintes etapas para baixar os arquivos de entrada para um teste de carga existente no portal do Azure:

No portal do Azure, vá para o seu recurso de Teste de Carga do Azure.
No painel esquerdo, selecione Testes para exibir a lista de testes de carga e, em seguida, selecione seu teste.
Selecione as reticências (...) ao lado da execução de teste com a qual está a trabalhar e, em seguida, selecione Descarregar o ficheiro de entrada.

O navegador faz o download de um arquivo zip que contém os ficheiros de entrada do teste de carga.
Use qualquer ferramenta zip para extrair os arquivos de entrada.

A pasta contém os seguintes ficheiros:
- config.yaml: o arquivo de configuração YAML de teste de carga. Você faz referência a esse arquivo na definição de fluxo de trabalho CI/CD.
- .jmx ou .py: O script de teste JMeter ou Locust
- Quaisquer arquivos de entrada adicionais, como arquivos CSV ou arquivos de propriedades do usuário que são necessários para executar o teste de carga.
Confirme todos os arquivos de entrada extraídos em seu repositório de controle do código-fonte.

Use o repositório de código-fonte no qual você configura o pipeline de CI/CD.

Atualizar a definição do fluxo de trabalho de CI/CD

O Teste de Carga do Azure dá suporte às Ações do GitHub e aos Pipelines do Azure para executar testes de carga.

Instalar a extensão de Teste de Carga do Azure para Azure DevOps

Para criar e executar um teste de carga, a definição de fluxo de trabalho do Azure Pipelines usa a extensão de tarefa Teste de Carga do Azure do Azure DevOps Marketplace.

Abra a extensão de tarefa de Teste de Carga do Azure no Azure DevOps Marketplace e selecione Obter gratuitamente.
Selecione sua organização do Azure DevOps e selecione Instalar para instalar a extensão.

Se você não tiver privilégios de administrador para a organização de DevOps do Azure selecionada, selecione Solicitar para solicitar que um administrador instale a extensão.

Atualizar o fluxo de trabalho do Azure Pipelines

Atualize seu fluxo de trabalho do Azure Pipelines para executar um teste de carga para seu recurso de teste de carga do Azure.

Entre em sua organização do Azure DevOps (https://dev.azure.com/<your-organization>) e selecione seu projeto.
Selecione Pipelines na navegação à esquerda, selecione seu pipeline e selecione Editar para editar sua definição de fluxo de trabalho.

Como alternativa, selecione Criar Pipeline para criar um novo pipeline no Azure Pipelines.
Use a AzureLoadTest tarefa para executar o teste de carga.

Especifique o ficheiro de configuração do teste de carga exportado anteriormente na propriedade loadTestConfigFile.

Substitua os <load-testing-resource> e <load-testing-resource-group> espaços reservados pelos nomes do seu recurso de teste de carga do Azure e do grupo de recursos.
```
    - task: AzureLoadTest@1
      inputs:
        azureSubscription: $(serviceConnection)
        loadTestConfigFile: 'config.yaml'
        loadTestResource: <load-testing-resource>
        resourceGroup: <load-testing-resource-group>
```
Opcionalmente, pode passar parâmetros ou segredos para o teste de carga usando a propriedade env ou secrets.
Use a publish tarefa para publicar os resultados do teste como artefatos na sua execução do fluxo de trabalho do Azure Pipelines.
```
    - publish: $(System.DefaultWorkingDirectory)/loadTest
      artifact: loadTestResults
```

Atualizar o fluxo de trabalho de Ações do GitHub

Atualize seu fluxo de trabalho de Ações do GitHub para executar um teste de carga para seu recurso de teste de carga do Azure.

No GitHub, navegue para o seu repositório.
Edite seu fluxo de trabalho de Ações do GitHub ou crie um novo fluxo de trabalho no repositório do GitHub.
Use a ação actions/checkout para aceder ao repositório com os arquivos de entrada de teste de carga.
```
    - name: Checkout
      uses: actions/checkout@v3
```

Use a ação azure/login para autenticar com o Azure usando as credenciais guardadas.

Cole o seguinte conteúdo YAML na definição do fluxo de trabalho:

    - name: Login to Azure
      uses: azure/login@v1
      continue-on-error: false
      with:
        creds: ${{ secrets.AZURE_CREDENTIALS }}

Use a azure/load-testing ação para executar o teste de carga.

Especifique o ficheiro de configuração de teste de carga que exportou anteriormente na propriedade loadTestConfigFile.

Substitua os espaços reservados de texto <load-testing-resource> e <load-testing-resource-group> pelo nome do seu recurso de teste de carga do Azure e do grupo de recursos.
```
    - name: 'Azure Load Testing'
      uses: azure/load-testing@v1
      with:
        loadTestConfigFile: 'config.yaml'
        loadTestResource: <load-testing-resource>
        resourceGroup: <load-testing-resource-group>
```
Opcionalmente, pode passar parâmetros ou segredos para o teste de carga utilizando a propriedade env ou secrets.
Use a ação actions/upload-artifact para publicar os resultados do teste como artefatos na execução do fluxo de trabalho do GitHub Actions.
```
    - uses: actions/upload-artifact@v2
      with:
        name: loadTestResults
        path: ${{ github.workspace }}/loadTest
```

Atualize seu fluxo de trabalho de CI para executar um teste de carga para seu recurso de teste de carga do Azure usando a CLI do Azure. Use as especificidades da sua ferramenta de CI para adicionar os seguintes comandos ao seu fluxo de trabalho de CI:

Entre na assinatura do Azure usando a entidade de serviço.

Utilize os valores clientId, clientSecret e tenantId que armazenou anteriormente.

az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
az account set -s $AZURE_SUBSCRIPTION_ID

Crie um teste de carga usando o arquivo YAML de configuração de teste de carga.

Substitua os espaços reservados de texto <load-testing-resource>, <load-testing-resource-group> e <load-test-config-yaml> pelo nome do recurso de teste de carga, o nome do grupo de recursos e o nome do ficheiro YAML de configuração de teste de carga que foi adicionado ao repositório anteriormente.
```
az load test create --load-test-resource <load-testing-resource> --resource-group <load-testing-resource-group> --test-id sample-test-id --load-test-config-file <load-test-config-yaml>
```

Execute o teste de carga.

testRunId="run_"`date +"%Y%m%d%_H%M%S"`
displayName="Run"`date +"%Y/%m/%d_%H:%M:%S"`

az load test-run create --load-test-resource <load-testing-resource> --test-id sample-test-id --test-run-id $testRunId --display-name $displayName --description "Test run from CLI"

Recupere e exiba as métricas do lado do cliente para a execução do teste de carga.

az load test-run metrics list --load-test-resource <load-testing-resource> --test-run-id $testRunId --metric-namespace LoadTestRunMetrics

Ver resultados do teste de carga

Ao executar um teste de carga a partir do pipeline de CI/CD, pode visualizar os resultados resumidos diretamente no log de saída de CI/CD. Se você publicou os resultados do teste como um artefato de pipeline, também poderá baixar um arquivo CSV para relatórios adicionais.

Captura de ecrã que mostra as informações de registo do fluxo de trabalho.

Limpar recursos

Se você não planeja usar nenhum dos recursos que criou, exclua-os para não incorrer em mais cobranças.

Remova as alterações do Azure Pipelines:
1. Entre em sua organização do Azure DevOps (https://dev.azure.com/<your-organization>) e selecione seu projeto.
  
  Substitua o marcador de posição <your-organization> pelo identificador do seu projeto.
2. Se você criou um novo pipeline":
  1. Selecione Pipelines e, em seguida, selecione seu pipeline.
  2. Selecione as reticências e, em seguida, selecione Eliminar.
  3. Insira o nome do pipeline e selecione Excluir para excluir o pipeline.
3. Se você modificou uma definição de fluxo de trabalho existente, desfaça as modificações para executar o teste de carga e salve o fluxo de trabalho.
Remova a conexão de serviço:
1. Selecione Configurações do>projeto Conexões de serviço e, em seguida, selecione sua conexão de serviço.
2. Selecione Editar>Eliminar para remover a conexão de serviço.

Remova as alterações do GitHub Actions:
1. No GitHub, aceda ao seu repositório.
2. Se você criou uma nova definição de fluxo de trabalho, exclua o arquivo YAML do fluxo de trabalho na .github/workflows pasta.
3. Se você modificou uma definição de fluxo de trabalho existente, desfaça as modificações para executar o teste de carga e salve o fluxo de trabalho.

Remova o principal de serviço:

az ad sp delete --id $(az ad sp show --display-name "my-load-test-cicd" -o tsv)

Próximos passos

Avance para o próximo artigo para saber como identificar regressões de desempenho definindo critérios de reprovação de teste e comparando execuções de teste.

Partilhar via