Ręczne konfigurowanie przepływu pracy ciągłej integracji/ciągłego wdrażania na potrzeby uruchamiania testów obciążeniowych

Artykuł
12/15/2023

Test obciążeniowy można zautomatyzować w usłudze Azure Load Testing, tworząc potok ciągłej integracji/ciągłego wdrażania. Z tego artykułu dowiesz się, jak ręcznie skonfigurować funkcję GitHub Actions, usługę Azure Pipelines lub inne narzędzia ciągłej integracji w celu wywołania istniejącego testu w usłudze Azure Load Testing. Zautomatyzuj test obciążeniowy, aby stale weryfikować wydajność i stabilność aplikacji pod obciążeniem.

Aby dodać istniejący test obciążeniowy do potoku ciągłej integracji/ciągłego wdrażania:

Skonfiguruj uwierzytelnianie usługi, aby umożliwić narzędziu ciągłej integracji łączenie się z zasobem testowania obciążenia platformy Azure.
Dodaj pliki wejściowe testu obciążeniowego do repozytorium, takie jak skrypt testowy JMeter i konfiguracja yaML testu obciążeniowego.
Zaktualizuj definicję potoku ciągłej integracji/ciągłego wdrażania, aby wywołać testowanie obciążenia platformy Azure.

Wymagania wstępne

Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
Test testowania obciążenia platformy Azure. Utwórz test obciążeniowy oparty na adresie URL lub użyj istniejącego skryptu JMeter, aby utworzyć test obciążeniowy.

Organizacja i projekt usługi Azure DevOps. Jeśli nie masz organizacji usługi Azure DevOps, możesz go utworzyć bezpłatnie. Jeśli potrzebujesz pomocy dotyczącej rozpoczynania pracy z usługą Azure Pipelines, zobacz Tworzenie pierwszego potoku.

Konfigurowanie uwierzytelniania usługi

Aby uruchomić test obciążeniowy w przepływie pracy ciągłej integracji/ciągłego wdrażania, musisz udzielić uprawnień do przepływu pracy ciągłej integracji/ciągłego wdrażania w celu uzyskania dostępu do zasobu testowania obciążenia. Utwórz jednostkę usługi dla przepływu pracy ciągłej integracji/ciągłego wdrażania i przypisz rolę RBAC współautora testu obciążenia platformy Azure.

Tworzenie połączenia usługi w usłudze Azure Pipelines

W usłudze Azure Pipelines utworzysz połączenie usługi w projekcie usługi Azure DevOps w celu uzyskania dostępu do zasobów w ramach subskrypcji platformy Azure. Podczas tworzenia połączenia z usługą usługa Azure DevOps tworzy obiekt jednostki usługi Microsoft Entra.

Zaloguj się do organizacji usługi Azure DevOps (https://dev.azure.com/<your-organization>) i wybierz projekt.

Zastąp <your-organization> symbol zastępczy tekst identyfikatorem projektu.
Wybierz pozycję Połączenia usługi> Ustawienia projektu>+ Nowe połączenie z usługą.
W okienku Nowe połączenie z usługą wybierz usługę Azure Resource Manager, a następnie wybierz pozycję Dalej.
Wybierz metodę uwierzytelniania jednostka usługi (automatyczna), a następnie wybierz przycisk Dalej.

Wprowadź szczegóły połączenia z usługą, a następnie wybierz pozycję Zapisz , aby utworzyć połączenie z usługą.

Pole	Wartość
Poziom zakresu	Subskrypcja.
Subskrypcja	Wybierz subskrypcję platformy Azure, która hostuje zasób testowania obciążenia.
Grupa zasobów:	Wybierz grupę zasobów zawierającą zasób testowania obciążenia.
Nazwa połączenia z usługą	Wprowadź unikatową nazwę połączenia z usługą.
Udzielanie uprawnień dostępu do wszystkich potoków	Zaznaczono.

Z listy połączeń usług wybierz utworzoną wcześniej, a następnie wybierz pozycję Zarządzaj jednostką usługi.

Witryna Azure Portal zostanie otwarta na osobnej karcie przeglądarki i wyświetli szczegóły jednostki usługi.
W witrynie Azure Portal skopiuj wartość Nazwa wyświetlana.

Ta wartość jest używana w następnym kroku, aby udzielić uprawnień do uruchamiania testów obciążeniowych do jednostki usługi.

Udzielanie dostępu do testowania obciążenia platformy Azure

Testowanie obciążenia platformy Azure używa kontroli dostępu opartej na rolach platformy Azure, aby udzielić uprawnień do wykonywania określonych działań na zasobie testowania obciążenia. Aby uruchomić test obciążeniowy z potoku ciągłej integracji/ciągłego wdrażania, należy udzielić roli Współautor testu obciążeniowego do jednostki usługi.

W witrynie Azure Portal przejdź do zasobu testowania obciążenia platformy Azure.
Wybierz pozycję Kontrola dostępu (IAM)>Dodaj>przypisanie roli.
Na karcie Rola wybierz pozycję Współautor testu obciążeniowego na liście ról funkcji zadania.
Na karcie Członkowie wybierz pozycję Wybierz elementy członkowskie, a następnie użyj nazwy wyświetlanej skopiowaną wcześniej, aby przeszukać jednostkę usługi.
Wybierz jednostkę usługi, a następnie wybierz pozycję Wybierz.
Na karcie Przeglądanie i przypisywanie wybierz pozycję Przejrzyj i przypisz, aby dodać przypisanie roli.

Teraz możesz użyć połączenia usługi w definicji przepływu pracy usługi Azure Pipelines, aby uzyskać dostęp do zasobu testowania obciążenia platformy Azure.

Aby uzyskać dostęp do zasobu testowania obciążenia platformy Azure z przepływu pracy funkcji GitHub Actions, najpierw utwórz jednostkę usługi Microsoft Entra. Ta jednostka usługi reprezentuje przepływ pracy funkcji GitHub Actions w identyfikatorze Entra firmy Microsoft.

Następnie przyznasz jednostce usługi uprawnienia do tworzenia i uruchamiania testu obciążeniowego przy użyciu zasobu testowania obciążenia platformy Azure.

Tworzenie jednostki usługi

Utwórz jednostkę usługi w subskrypcji platformy Azure i przypisz rolę Współautor testu obciążeniowego, aby przepływ pracy funkcji GitHub Actions miał dostęp do zasobu testowania obciążenia platformy Azure w celu uruchamiania testów obciążeniowych.

Utwórz jednostkę usługi i przypisz Load Test Contributor rolę:

# 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

Dane wyjściowe to obiekt JSON reprezentujący jednostkę usługi. Te informacje służą do uwierzytelniania za pomocą platformy Azure w przepływie pracy funkcji 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/"    
}

Uwaga

Po uruchomieniu --sdk-auth tego polecenia może zostać wyświetlone ostrzeżenie o wycofaniu. Alternatywnie możesz użyć uwierzytelniania opartego na technologii OpenID Połączenie (OIDC) do uwierzytelniania usługi GitHub za pomocą platformy Azure. Dowiedz się, jak używać akcji logowania platformy Azure z Połączenie OpenID.

Skopiuj wyjściowy obiekt JSON do schowka.

W następnym kroku informacje o jednostce usługi są przechowywane jako wpis tajny funkcji GitHub Actions.

Przechowywanie poświadczeń platformy Azure w wpisie tajnym funkcji GitHub Actions

Utwórz wpis tajny funkcji GitHub Actions, aby bezpiecznie przechowywać informacje o jednostce usługi. Ten wpis tajny jest używany w definicji przepływu pracy, aby nawiązać połączenie z platformą Azure i uzyskać dostęp do zasobu testowania obciążenia platformy Azure.

Uwaga

Jeśli używasz Połączenie OpenID do uwierzytelniania na platformie Azure, nie musisz przekazywać obiektu jednostki usługi w akcji logowania platformy Azure. Dowiedz się, jak używać akcji logowania platformy Azure z Połączenie OpenID.

Aby utworzyć wpis tajny funkcji GitHub Actions:

W usłudze GitHub przejdź do repozytorium.
Wybierz pozycję Ustawienia> Sekrets i zmienne>Akcje.
Wybierz pozycję Nowy wpis tajny repozytorium, wprowadź informacje o wpisie tajnym, a następnie wybierz pozycję Dodaj wpis tajny , aby utworzyć nowy wpis tajny.

Pole Wartość

Nazwa/nazwisko AZURE_CREDENTIALS

Wpis tajny Wklej dane wyjściowe JSON z skopiowanego wcześniej polecenia tworzenia jednostki usługi.

Pole	Wartość
Nazwa/nazwisko	AZURE_CREDENTIALS
Wpis tajny	Wklej dane wyjściowe JSON z skopiowanego wcześniej polecenia tworzenia jednostki usługi.

Teraz możesz uzyskać dostęp do subskrypcji platformy Azure i zasobu testowania obciążenia z przepływu pracy funkcji GitHub Actions przy użyciu przechowywanych poświadczeń.

Jeśli używasz innego narzędzia ciągłej integracji/ciągłego wdrażania, użyj interfejsu wiersza polecenia platformy Azure do interakcji z zasobami platformy Azure. Wykonaj następujące kroki, aby autoryzować dostęp narzędzia ciągłej integracji do zasobu testowania obciążenia:

Utwórz jednostkę usługi Microsoft Entra, aby nawiązać połączenie z subskrypcją platformy Azure i uzyskać dostęp do zasobu testowania obciążenia platformy Azure.
Przyznaj jednostce usługi uprawnienia do tworzenia i uruchamiania testu obciążeniowego, przypisując rolę Współautor testu obciążeniowego.
Bezpieczne przechowywanie poświadczeń platformy Azure w narzędziu ciągłej integracji.

Wykonaj następujące kroki, aby skonfigurować autoryzację usługi dla narzędzia ciągłej integracji:

Utwórz jednostkę usługi i przypisz rolę Współautor testu obciążeniowego:

Zastąp <resource-group-name> symbole zastępcze i <load-testing-resource-name> tekstowe.

# 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

Dane wyjściowe to obiekt JSON reprezentujący jednostkę usługi.

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

Skopiuj wartości , clientSecreti i tenantId bezpiecznie zapisz je jako wpisy tajne w narzędziu clientIdciągłej integracji.

Te wartości służą do logowania się do subskrypcji platformy Azure za pomocą polecenia interfejsu wiersza polecenia az login platformy Azure.

Dodawanie plików testów obciążeniowych w repozytorium

Aby uruchomić test obciążeniowy za pomocą usługi Azure Load Testing w przepływie pracy ciągłej integracji/ciągłego wdrażania, należy dodać wszystkie pliki wejściowe testów obciążeniowych w repozytorium kontroli źródła.

Jeśli nie masz istniejącego testu obciążeniowego, dodaj następujące pliki do repozytorium kodu źródłowego:

Plik YAML konfiguracji testu obciążeniowego. Dowiedz się, jak utworzyć plik YAML konfiguracji testu obciążeniowego.
Plik planu testu. W przypadku testów opartych na JMeter dodaj skrypt testowy JMeter (JMX plik). W przypadku testów opartych na adresach URL dodaj plik JSON żądań.
Wszystkie pliki właściwości użytkownika JMeter.
Wszystkie pliki danych wejściowych używanych przez plan testowy. Na przykład pliki danych CSV.

Jeśli masz istniejący test obciążeniowy, możesz pobrać ustawienia konfiguracji i wszystkie pliki wejściowe bezpośrednio z witryny Azure Portal. Wykonaj następujące kroki, aby pobrać pliki wejściowe na potrzeby istniejącego testowania obciążenia w witrynie Azure Portal:

W witrynie Azure Portal przejdź do zasobu testowania obciążenia platformy Azure.
W okienku po lewej stronie wybierz pozycję Testy , aby wyświetlić listę testów obciążeniowych, a następnie wybierz test.
Wybranie wielokropka (...) obok przebiegu testu, z którym pracujesz, a następnie wybierz pozycję Pobierz plik wejściowy.

Przeglądarka pobiera spakowany folder zawierający pliki wejściowe testu obciążeniowego.
Wyodrębnianie plików wejściowych za pomocą dowolnego narzędzia zip.

Folder zawiera następujące pliki:
- config.yaml: plik konfiguracji testu obciążeniowego YAML. Odwołujesz się do tego pliku w definicji przepływu pracy ciągłej integracji/ciągłego wdrażania.
- .jmx: skrypt testowy JMeter
- Wszelkie dodatkowe pliki wejściowe, takie jak pliki CSV lub pliki właściwości użytkownika potrzebne do uruchomienia testu obciążeniowego.
Zatwierdź wszystkie wyodrębnione pliki wejściowe do repozytorium kontroli źródła.

Użyj repozytorium kodu źródłowego, w którym konfigurujesz potok ciągłej integracji/ciągłego wdrażania.

Aktualizowanie definicji przepływu pracy ciągłej integracji/ciągłego wdrażania

Testowanie obciążenia platformy Azure obsługuje zarówno akcje GitHub Actions, jak i usługę Azure Pipelines na potrzeby uruchamiania testów obciążeniowych.

Instalowanie rozszerzenia Azure Load Testing dla usługi Azure DevOps

Aby utworzyć i uruchomić test obciążeniowy, definicja przepływu pracy usługi Azure Pipelines używa rozszerzenia zadania Testowania obciążenia platformy Azure z witryny Azure DevOps Marketplace.

Otwórz rozszerzenie zadania Azure Load Testing w witrynie Azure DevOps Marketplace i wybierz pozycję Pobierz bezpłatnie.
Wybierz organizację usługi Azure DevOps, a następnie wybierz pozycję Zainstaluj , aby zainstalować rozszerzenie.

Jeśli nie masz uprawnień administratora dla wybranej organizacji usługi Azure DevOps, wybierz pozycję Zażądaj , aby poprosić administratora o zainstalowanie rozszerzenia.

Aktualizowanie przepływu pracy usługi Azure Pipelines

Zaktualizuj przepływ pracy usługi Azure Pipelines, aby uruchomić test obciążeniowy dla zasobu testowania obciążenia platformy Azure.

Zaloguj się do organizacji usługi Azure DevOps (https://dev.azure.com/<your-organization>) i wybierz projekt.
Wybierz pozycję Potoki w obszarze nawigacji po lewej stronie, wybierz potok, a następnie wybierz pozycję Edytuj , aby edytować definicję przepływu pracy.

Alternatywnie wybierz pozycję Utwórz potok , aby utworzyć nowy potok w usłudze Azure Pipelines.
AzureLoadTest Użyj zadania , aby uruchomić test obciążeniowy.

Określ wyeksportowany wcześniej plik konfiguracji testu obciążeniowego loadTestConfigFile we właściwości .

<load-testing-resource> Zastąp symbole zastępcze i <load-testing-resource-group> nazwą zasobu testowania obciążenia platformy Azure i grupą zasobów.
```
    - task: AzureLoadTest@1
      inputs:
        azureSubscription: $(serviceConnection)
        loadTestConfigFile: 'config.yaml'
        loadTestResource: <load-testing-resource>
        resourceGroup: <load-testing-resource-group>
```
Opcjonalnie możesz przekazać parametry lub wpisy tajne do testu obciążeniowego przy użyciu env właściwości lub secrets .
publish Użyj zadania , aby opublikować wyniki testu jako artefakty w przebiegu przepływu pracy usługi Azure Pipelines.
```
    - publish: $(System.DefaultWorkingDirectory)/loadTest
      artifact: loadTestResults
```

Aktualizowanie przepływu pracy funkcji GitHub Actions

Zaktualizuj przepływ pracy funkcji GitHub Actions, aby uruchomić test obciążeniowy dla zasobu testowania obciążenia platformy Azure.

W usłudze GitHub przejdź do repozytorium.
Edytuj przepływ pracy funkcji GitHub Actions lub utwórz nowy przepływ pracy w repozytorium GitHub.
actions/checkout Użyj akcji , aby wyewidencjonować repozytorium z plikami wejściowymi testu obciążeniowego.
```
    - name: Checkout
      uses: actions/checkout@v3
```
azure/login Użyj akcji , aby uwierzytelnić się na platformie Azure przy użyciu przechowywanych poświadczeń.

Wklej następującą zawartość YAML w definicji przepływu pracy:
```
    - name: Login to Azure
      uses: azure/login@v1
      continue-on-error: false
      with:
        creds: ${{ secrets.AZURE_CREDENTIALS }}
```
azure/load-testing Użyj akcji , aby uruchomić test obciążeniowy.

Określ wyeksportowany wcześniej plik konfiguracji testu obciążeniowego loadTestConfigFile we właściwości .

<load-testing-resource> Zastąp symbole zastępcze i <load-testing-resource-group> nazwą zasobu testowania obciążenia platformy Azure i grupą zasobów.
```
    - name: 'Azure Load Testing'
      uses: azure/load-testing@v1
      with:
        loadTestConfigFile: 'config.yaml'
        loadTestResource: <load-testing-resource>
        resourceGroup: <load-testing-resource-group>
```
Opcjonalnie możesz przekazać parametry lub wpisy tajne do testu obciążeniowego przy użyciu env właściwości lub secrets .
actions/upload-artifact Użyj akcji , aby opublikować wyniki testu jako artefakty w przebiegu przepływu pracy funkcji GitHub Actions.
```
    - uses: actions/upload-artifact@v2
      with:
        name: loadTestResults
        path: ${{ github.workspace }}/loadTest
```

Zaktualizuj przepływ pracy ciągłej integracji, aby uruchomić test obciążeniowy dla zasobu testowania obciążenia platformy Azure przy użyciu interfejsu wiersza polecenia platformy Azure. Użyj specyfiki narzędzia ciągłej integracji, aby dodać następujące polecenia do przepływu pracy ciągłej integracji:

Zaloguj się do subskrypcji platformy Azure przy użyciu jednostki usługi.

Użyj wcześniej przechowywanych clientIdwartości , clientSecreti tenandId .
```
az login --service-principal -u $AZURE_CLIENT_ID -p $AZURE_CLIENT_SECRET -t $AZURE_TENANT_ID
az account set -s $AZURE_SUBSCRIPTION_ID
```
Utwórz test obciążeniowy przy użyciu pliku YAML konfiguracji testu obciążeniowego.

<load-testing-resource>Zastąp symbole zastępcze , <load-testing-resource-group>i <load-test-config-yaml> tekstami nazwą zasobu testowania obciążenia, nazwą grupy zasobów i nazwą pliku konfiguracji testu obciążeniowego YAML, który został wcześniej dodany do repozytorium.
```
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>
```

Uruchom test obciążeniowy.

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"

Pobierz i wyświetl metryki po stronie klienta dla przebiegu testu obciążeniowego.

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

Wyświetlanie wyników testu obciążeniowego

Po uruchomieniu testu obciążeniowego z potoku ciągłej integracji/ciągłego wdrażania można wyświetlić wyniki podsumowania bezpośrednio w dzienniku danych wyjściowych ciągłej integracji/ciągłego wdrażania. Jeśli wyniki testu zostały opublikowane jako artefakt potoku, możesz również pobrać plik CSV w celu dalszego raportowania.

Screenshot that shows the workflow logging information.

Czyszczenie zasobów

Jeśli nie planujesz korzystać z żadnych utworzonych zasobów, usuń je, aby nie ponosić żadnych dodatkowych opłat.

Usuń zmiany usługi Azure Pipelines:
1. Zaloguj się do organizacji usługi Azure DevOps (https://dev.azure.com/<your-organization>) i wybierz projekt.
  
  Zastąp <your-organization> symbol zastępczy tekst identyfikatorem projektu.
2. Jeśli utworzono nowy potok":
  1. Wybierz pozycję Potoki, a następnie wybierz potok.
  2. Wybierz wielokropek, a następnie wybierz pozycję Usuń.
  3. Wprowadź nazwę potoku, a następnie wybierz pozycję Usuń , aby usunąć potok.
3. Jeśli zmodyfikowano istniejącą definicję przepływu pracy, cofnij modyfikacje uruchamiania testu obciążeniowego i zapisz przepływ pracy.
Usuń połączenie z usługą:
1. Wybierz pozycję Połączenia usługi Ustawienia>projektu, a następnie wybierz połączenie z usługą.
2. Wybierz pozycję Edytuj>usuń, aby usunąć połączenie z usługą.

Usuń zmiany funkcji GitHub Actions:
1. W usłudze GitHub przejdź do repozytorium.
2. Jeśli utworzono nową definicję przepływu pracy, usuń plik YAML przepływu pracy w folderze .github/workflows .
3. Jeśli zmodyfikowano istniejącą definicję przepływu pracy, cofnij modyfikacje uruchamiania testu obciążeniowego i zapisz przepływ pracy.

Usuń jednostkę usługi:

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

Następne kroki

Przejdź do następnego artykułu, aby dowiedzieć się, jak identyfikować regresje wydajności, definiując kryteria testu niepowodzenia i porównując przebiegi testów.