Configure manualmente o fluxo de trabalho de CI/CD para executar testes 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.

• Uma conta GitHub. Se você não tiver uma conta no GitHub, poderá criar uma gratuitamente.
• Um repositório GitHub para armazenar os arquivos de entrada de teste de carga e criar um fluxo de trabalho de Ações do GitHub. Para criar um, consulte Criando um novo repositório.

• Permissão para criar ou modificar um pipeline de CI.
• Um repositório de código-fonte para armazenar os arquivos de entrada 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.

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

   Substitua o espaço reservado de <your-organization> texto pelo identificador do projeto.

2. Selecione Configurações do>projeto Conexões> de serviço+ Nova conexão de serviço.

3. No painel Nova conexão de serviço, selecione o Gerenciador de Recursos do Azure e selecione Avançar.

4. Selecione o método de autenticação da entidade de serviço (automática) e, em seguida, selecione Avançar.

5. 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	Selecionado.

6. Na lista de conexões de serviço, selecione a que você criou anteriormente e, em seguida, selecione Gerenciar entidade de serviço.

   

   O portal do Azure é aberto em uma guia separada do navegador e mostra os detalhes da entidade de serviço.

7. No portal do Azure, copie o valor Nome para exibição .

   Use esse valor na próxima etapa para conceder permissões para executar testes de carga para a 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 à entidade de serviço.

1. No portal do Azure, vá para seu recurso de Teste de Carga do Azure.

2. Selecione Controle de acesso (IAM)>Adicionar>Adicionar atribuição de função.

3. Na guia Função, selecione Colaborador de Teste de Carga na lista de funções de função.

   

4. Na guia Membros, selecione Selecionar membros e use o nome para exibição copiado anteriormente para pesquisar a entidade de serviço.

5. Selecione a entidade de serviço e, em seguida, selecione Selecionar.

6. 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 acessar seu recurso de Teste de Carga do Azure a partir do fluxo de trabalho de Ações do GitHub, primeiro crie uma entidade de serviço do Microsoft Entra. Esta entidade de serviço representa seu fluxo de trabalho de Ações do GitHub na ID do Microsoft Entra.

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.

1. 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 substituiçã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.

2. 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 de Ações do GitHub

Crie um segredo de Ações do GitHub para armazenar com segurança as informações da entidade de 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.

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

1. No GitHub, navegue até o repositório.

2. Selecione Configurações>Segredos & variáveis>Ações.

3. 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 da entidade 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:

1. Crie uma entidade de serviço do Microsoft Entra para se conectar à sua assinatura do Azure e acessar seu recurso de teste de carga do Azure.
2. 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.
3. 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:

1. Crie uma entidade de serviço e atribua a função de Colaborador de Teste de Carga:

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

   # 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/"    
   }
   

2. Copie os valores , clientSecrete tenantId e armazene-os clientIdcom 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 .

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.

1. Abra a extensão de tarefa Teste de Carga do Azure no Azure DevOps Marketplace e selecione Obter gratuitamente.

2. 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.

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

2. 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.

3. Use a AzureLoadTest tarefa para executar o teste de carga.

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

   Substitua os espaços reservados e de <load-testing-resource> texto pelo nome do seu recurso de teste de carga do Azure e <load-testing-resource-group> do grupo de recursos.

       - task: AzureLoadTest@1
         inputs:
           azureSubscription: $(serviceConnection)
           loadTestConfigFile: 'config.yaml'
           loadTestResource: <load-testing-resource>
           resourceGroup: <load-testing-resource-group>
   

   Opcionalmente, você pode passar parâmetros ou segredos para o teste de carga usando a env propriedade or secrets .

4. Use a publish tarefa para publicar os resultados do teste como artefatos em sua execução de 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.

1. No GitHub, navegue até o repositório.

2. Edite seu fluxo de trabalho de Ações do GitHub ou crie um novo fluxo de trabalho no repositório do GitHub.

3. Use a actions/checkout ação para fazer check-out do repositório com os arquivos de entrada de teste de carga.

       - name: Checkout
         uses: actions/checkout@v3
   

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

   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 }}
   

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

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

   Substitua os espaços reservados e de <load-testing-resource> texto pelo nome do seu recurso de teste de carga do Azure e <load-testing-resource-group> 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, você pode passar parâmetros ou segredos para o teste de carga usando a env propriedade or secrets .

6. Use a ação para publicar os resultados do teste como artefatos na execução do actions/upload-artifact fluxo de trabalho Ações do GitHub.

       - 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:

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

   Use o , clientSecrete tenandId os clientIdvalores armazenados anteriormente.

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

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

   Substitua os <load-testing-resource>espaços reservados , <load-testing-resource-group>e texto pelo nome do recurso de teste de carga, o nome do grupo de recursos e <load-test-config-yaml> o nome do arquivo YAML de configuração de teste de carga que você adicionou 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>
   

3. 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"
   

4. 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
   

1. 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 espaço reservado de <your-organization> texto pelo identificador do 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 Excluir.

         

      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.

2. 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>exclusão para remover a conexão de serviço.

1. Remova as alterações do GitHub Actions:

   1. No GitHub, navegue até o 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.

2. Remova a entidade de serviço:

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

1. Desfaça as alterações no fluxo de trabalho de CI.

2. Remova a entidade de serviço:

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