Вручную настройте рабочий процесс CI/CD для выполнения нагрузочных тестов

• Организация и проект Azure DevOps. Если у вас нет организации Azure DevOps, вы можете создать её бесплатно. Если вам нужна помощь с началом работы в Azure Pipelines, ознакомьтесь с созданием вашего первого конвейера.

• Учетная запись GitHub. Если у вас нет учетной записи GitHub, вы можете создать ее бесплатно.
• Репозиторий GitHub для хранения входных файлов нагрузочного теста и создания рабочего процесса GitHub Actions. Чтобы создать его, см. раздел Создание нового репозитория.

• Разрешение на создание или изменение конвейера CI.
• Репозиторий исходного кода для хранения входных файлов нагрузочного теста.

Создание подключения к службе в Azure Pipelines

В Azure Pipelines вы создадите подключение service в проекте Azure DevOps для доступа к ресурсам в подписке Azure. При создании подключения службы Azure DevOps создает объект субъекта-службы Microsoft Entra.

1. Войдите в организацию Azure DevOps (https://dev.azure.com/<your-organization>) и выберите проект.

   Замените текстовый заполнитель <your-organization> указателем вашего проекта.

2. Выберите параметры Project>Service connections>+ Новое подключение службы.

3. В области Новое подключение службы выберите Azure Resource Manager, затем нажмите Далее.

4. Выберите способ аутентификации "Субъект-служба" (автоматически) и выберите Далее.

5. Введите сведения о подключении службы и нажмите кнопку "Сохранить ", чтобы создать подключение службы.

   Поле	Ценность
   Уровень области	Подписка.
   Подписка	Выберите подписку Azure, в которую размещается ресурс нагрузочного тестирования.
   Группа ресурсов	Выберите группу ресурсов, содержащую ресурс нагрузочного тестирования.
   Имя подключения службы	Введите уникальное имя подключения к службе.
   Предоставление разрешения на доступ ко всем конвейерам	Проверено.

6. В списке подключений служб выберите подключение, которое вы создали ранее, и выберите Управление служебным агентом.

   

   Портал Azure открывается на отдельной вкладке браузера и отображает сведения о учетной записи службы.

7. На портале Azure скопируйте значение Display name.

   Это значение используется на следующем шаге для предоставления разрешений на выполнение нагрузочных тестов субъекту-службе.

Предоставление доступа к Нагрузочное тестирование Azure

Нагрузочное тестирование Azure использует Azure RBAC для предоставления разрешений для выполнения определенных действий в ресурсе нагрузочного тестирования. Чтобы запустить нагрузочный тест из конвейера CI/CD, необходимо предоставить роль участника нагрузочного теста служебному принципалу.

1. На портале Azure/c0 перейдите к ресурсу Нагрузочное тестирование Azure.

2. Выберите элемент управления доступом (IAM)>Добавить>Добавить назначение роли.

3. На вкладке "Роль" выберите участника нагрузочного тестирования в списке ролей функций задания.

   Скриншот, на котором отображен список ролей на странице "Добавление назначения ролей" на портале Azure с выделенной ролью участника нагрузочного теста.

4. На вкладке "Участники" выберите " Выбрать участников", а затем используйте отображаемое имя, скопированное ранее для поиска субъекта-службы.

5. Выберите служебный принципал и нажмите Выбрать.

6. На вкладке Обзор и назначение выберите Обзор и назначение, чтобы добавить назначение роли.

Теперь вы можете использовать подключение к службе в определении рабочего процесса Azure Pipelines для доступа к ресурсу Azure нагрузочного тестирования.

Чтобы получить доступ к ресурсу Нагрузочное тестирование Azure из рабочего процесса GitHub Actions, сначала создайте учетную запись службы Microsoft Entra . Эта учетная запись службы представляет ваш рабочий процесс GitHub Actions в Microsoft Entra ID.

Затем вы предоставляете субъекту-службе разрешения на создание и запуск нагрузочного теста с помощью ресурса Нагрузочное тестирование Azure.

Создайте сервисного принципала

Создайте учетную запись службы в подписке Azure и назначьте роль Load Test Contributor, чтобы GitHub Actions получил доступ к вашему ресурсу нагрузочного тестирования Azure для выполнения тестов нагрузки.

1. Создайте учетную запись службы и назначьте роль Load Test Contributor.

   # 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
   

   Выходные данные — это объект JSON, представляющий субъект-службу. Эти сведения используются для проверки подлинности с помощью Azure в рабочем процессе GitHub Actions.

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

   Замечание

   При выполнении --sdk-auth этой команды может появиться предупреждение о прекращении поддержки. Кроме того, можно использовать проверку подлинности на основе OpenID Connect (OIDC) для проверки подлинности GitHub с помощью Azure. Узнайте, как использовать действие входа Azure с помощью OpenID Connect.

2. Скопируйте выходной объект JSON в буфер обмена.

   На следующем шаге сохраните сведения принципала службы как секрет GitHub Actions.

Хранение учетных данных Azure в секрете GitHub Actions

Создайте секрет GitHub Actions для безопасного хранения учетных данных службы. Этот секрет используется в определении рабочего процесса для подключения к проверке подлинности с помощью Azure и доступа к ресурсу нагрузочного тестирования Azure.

Чтобы создать секрет GitHub Actions:

1. В GitHub перейдите к репозиторию.

2. Выберите «Настройки»>«Секреты и переменные»>«Действия».

3. Выберите "Создать секрет репозитория", введите сведения о секрете и нажмите кнопку "Добавить секрет ", чтобы создать новый секрет.

   Поле	Ценность
   Имя	AZURE_CREDENTIALS
   Секрет	Вставьте выходные данные JSON из команды создания субъекта-службы, скопированной ранее.

Теперь вы можете получить доступ к подписке Azure и ресурсу нагрузочного тестирования из рабочего процесса GitHub Actions с помощью сохраненных учетных данных.

Если вы используете другое средство CI/CD, вы используете Azure CLI для взаимодействия с ресурсами Azure. Выполните следующие действия, чтобы авторизовать доступ средства CI к ресурсу нагрузочного тестирования:

1. Создайте учетную запись службы Microsoft Entra для подключения к подписке Azure и доступа к ресурсу Azure нагрузочного тестирования.
2. Предоставьте субъекту-службе разрешения на создание и запуск нагрузочного теста, назначив роль участника нагрузочного теста.
3. Безопасно храните учетные данные Azure в средстве CI.

Выполните следующие действия, чтобы настроить авторизацию службы для средства CI:

1. Создайте служебный принципал и назначьте роль Load Test Contributor:

   Замените текстовые заполнители <resource-group-name> и <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
   

   Выходные данные — это объект JSON, представляющий субъект-службу.

   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. Скопируйте значения clientId, clientSecret, tenantId и безопасно сохраните их в качестве секретов в средстве CI.

   Эти значения используются для входа в подписку Azure с помощью команды Azure CLI az login.

Установите расширение Нагрузочное тестирование Azure для Azure DevOps

Чтобы создать и запустить нагрузочный тест, определение рабочего процесса Azure Pipelines использует расширение Нагрузочное тестирование Azure из Azure DevOps Marketplace.

1. Откройте расширение задачи Нагрузочное тестирование Azure в Azure DevOps Marketplace и выберите Получить бесплатно.

2. Выберите Azure DevOps организацию, а затем выберите Install, чтобы установить расширение.

   Если у вас нет прав администратора для выбранной организации Azure DevOps, выберите Request, чтобы запросить администратора установить расширение.

Обновление рабочего процесса Azure Pipelines

Обновите рабочий процесс Azure Pipelines, чтобы запустить нагрузочный тест для службы нагрузочного тестирования Azure.

1. Войдите в организацию Azure DevOps (https://dev.azure.com/<your-organization>) и выберите проект.

2. Выберите конвейеры в левой области навигации, выберите конвейер и выберите "Изменить ", чтобы изменить определение рабочего процесса.

   Кроме того, выберите Create Pipeline, чтобы создать новый конвейер в Azure Pipelines.

3. Используйте задачу AzureLoadTest для запуска нагрузочного теста.

   Укажите файл конфигурации нагрузочного теста, экспортируемый ранее в свойстве loadTestConfigFile .

   Замените заполнители текста <load-testing-resource> и <load-testing-resource-group> именем ресурса Azure нагрузочного тестирования и группы ресурсов.

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

   При необходимости можно передать параметры или секреты в нагрузочный тест с помощью env или secrets свойства. Установите значение waitForCompletion: false , если вы хотите продолжить, не ожидая завершения нагрузочного теста.

4. Используйте задачу publish для публикации результатов теста в качестве артефактов в рабочем процессе Azure Pipelines.

       - publish: $(System.DefaultWorkingDirectory)/loadTest
         artifact: loadTestResults
   

Обновление рабочего процесса GitHub Actions

Обновите рабочий процесс GitHub Actions, чтобы запустить нагрузочный тест для ресурса нагрузочного тестирования Azure.

1. В GitHub перейдите к репозиторию.

2. Измените рабочий процесс GitHub Actions или создайте новый рабочий процесс в репозитории GitHub.

3. Используйте действие actions/checkout, чтобы проверить репозиторий с входными файлами нагрузочного теста.

       - name: Checkout
         uses: actions/checkout@v3
   

4. Используйте действие azure/login для проверки подлинности с помощью Azure с помощью сохраненных учетных данных.

   Вставьте следующее содержимое YAML в определение рабочего процесса:

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

5. Используйте действие azure/load-testing для запуска нагрузочного теста.

   Укажите файл конфигурации нагрузочного теста, экспортируемый ранее в свойстве loadTestConfigFile .

   Замените заполнители текста <load-testing-resource> и <load-testing-resource-group> именем ресурса Azure нагрузочного тестирования и группы ресурсов.

       - name: 'Azure Load Testing'
         uses: azure/load-testing@v1
         with:
           loadTestConfigFile: 'config.yaml'
           loadTestResource: <load-testing-resource>
           resourceGroup: <load-testing-resource-group>
   

   При необходимости можно передать параметры или секреты в нагрузочный тест с помощью env или secrets свойства. Установите значение waitForCompletion: false , если вы хотите продолжить, не ожидая завершения нагрузочного теста.

6. Используйте действие actions/upload-artifact для публикации результатов теста в качестве артефактов в рабочем процессе GitHub Actions.

       - uses: actions/upload-artifact@v2
         with:
           name: loadTestResults
           path: ${{ github.workspace }}/loadTest
   

Обновите свой CI рабочий процесс, чтобы запустить тест нагрузки для ресурса тестирования нагрузки Azure с помощью Azure CLI. Используйте особенности средства CI, чтобы добавить следующие команды в рабочий процесс CI:

1. Войдите в подписку Azure с помощью учетной записи службы.

   Используйте ранее сохраненные значения clientId, clientSecret и tenantId.

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

2. Создайте нагрузочный тест, используя файл конфигурации YAML для нагрузочного теста.

   Замените текстовые заполнители <load-testing-resource>, <load-testing-resource-group>, <load-test-config-yaml> именем ресурса для нагрузочного тестирования, именем группы ресурсов и именем файла конфигурации YAML нагрузочного теста, который был ранее добавлен в репозиторий.

   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. Запустите нагрузочный тест.

   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. Извлекает и отображает метрики на стороне клиента для выполнения нагрузочного теста.

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

1. Удалите изменения в Azure Pipelines.

   1. Войдите в организацию Azure DevOps (https://dev.azure.com/<your-organization>) и выберите проект.

      Замените текстовый заполнитель <your-organization> указателем вашего проекта.

   2. Если вы создали новый конвейер":

      1. Выберите конвейеры и выберите конвейер.

      2. Выберите многоточие и нажмите кнопку "Удалить".

         

      3. Введите имя конвейера и нажмите кнопку "Удалить ", чтобы удалить конвейер.

   3. Если вы изменили существующее определение рабочего процесса, отмените изменения для запуска нагрузочного теста и сохраните рабочий процесс.

2. Удалите подключение службы:

   1. Выберите параметры Project>Service connections и выберите подключение к службе.
   2. Выберите "Редактировать" и >, чтобы удалить подключение службы.

1. Удалите изменения GitHub Actions:

   1. В GitHub перейдите к репозиторию.
   2. Если вы создали новое определение рабочего процесса, удалите файл YAML рабочего процесса в папке .github/workflows .
   3. Если вы изменили существующее определение рабочего процесса, отмените изменения для запуска нагрузочного теста и сохраните рабочий процесс.

2. Удалите субъект-службу:

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

1. Отмените изменения в вашем рабочем процессе CI.

2. Удалите субъект-службу:

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