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

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

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

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

Создание сервисного подключения в Azure Pipelines

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

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

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

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

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

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

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

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

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

   

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

7. Скопируйте значение отображаемого имени в портал Azure.

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

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

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

1. В портале Azure перейдите к вашему ресурсу Azure Load Testing.

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

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

   

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

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

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

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

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

Затем вы предоставляете служебному принципалу разрешения на создание и запуск нагрузочного теста на ресурсе Azure Load Testing.

Создание субъекта-службы

Создайте учетную запись службы в подписке Azure и назначьте роль участника тестирования нагрузок, чтобы рабочий процесс 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 Load Testing для Azure DevOps

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

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

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

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

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

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

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

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

   Кроме того, выберите "Создать конвейер", чтобы создать новый конвейер в 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 свойства.

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 свойства.

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