Konfigurera CI/CD-arbetsflödet manuellt för att köra belastningstester

• En Azure DevOps organisation och projekt. Om du inte har en Azure DevOps organisation kan du skapa en kostnadsfri. Om du behöver hjälp med att komma igång med Azure-pipelines kan du läsa Skapa din första pipeline.

• Ett GitHub konto. Om du inte har ett GitHub konto kan du skapa ett kostnadsfritt.
• En GitHub lagringsplats för att lagra indatafilerna för belastningstestet och skapa ett GitHub Actions arbetsflöde. Information om hur du skapar en finns i Skapa en ny lagringsplats.

• Behörighet att skapa eller ändra en CI-pipeline.
• En källkodslagringsplats för att lagra indatafilerna för belastningstestet.

Skapa en tjänstanslutning i Azure-pipelines

I Azure-pipelines skapar du en tjänstanslutning i ditt Azure DevOps projekt för att få åtkomst till resurser i din Azure-prenumeration. När du skapar tjänstanslutningen skapar Azure DevOps ett Microsoft Entra tjänsthuvudnamnsobjekt.

1. Logga in på din Azure DevOps organisation (https://dev.azure.com/<your-organization>) och välj ditt projekt.

   <your-organization> Ersätt textplatshållaren med projektidentifieraren.

2. Välj inställningar för Project>Service>+ Ny tjänstanslutning.

3. I fönstret Ny tjänstanslutning väljer du fönstret Azure Resource Manager och väljer sedan Nästa.

4. Välj autentiseringsmetoden Tjänsthuvudnamn (automatisk) och välj sedan Nästa.

5. Ange information om tjänstanslutningen och välj sedan Spara för att skapa tjänstanslutningen.

   Fält	Värde
   Omfångsnivå	Prenumeration.
   Prenumeration	Välj den Azure prenumeration som är värd för din belastningstestningsresurs.
   resursgrupp	Välj den resursgrupp som innehåller din belastningstestningsresurs.
   Namn på tjänstanslutning	Ange ett unikt namn för tjänstanslutningen.
   Bevilja åtkomstbehörighet till alla pipelines	Markerad.

6. I listan över tjänstanslutningar väljer du den som du skapade tidigare och väljer sedan Hantera tjänstens huvudnamn.

   

   Azure-portalen öppnas på en separat webbläsarflik och visar information om tjänstens huvudnamn.

7. I Azure-portalen kopierar du värdet displaynamn.

   Du använder det här värdet i nästa steg för att bevilja behörigheter för körning av belastningstester till tjänstens huvudprincip.

Bevilja åtkomst till Azure Load Testing

Azure Load Testing använder Azure RBAC för att bevilja behörigheter för att utföra specifika aktiviteter på din belastningstestningsresurs. Om du vill köra ett belastningstest från CI/CD-pipelinen beviljar du rollen Load Test Contributor till service principal.

1. I Azure-portalen går du till din Azure Load Testing resurs.

2. Välj Åtkomstkontroll (IAM)>Lägg till>Lägg till rolltilldelning.

3. På fliken Roll väljer du Läs in testdeltagare i listan över jobbfunktionsroller.

   

4. På fliken Medlemmar väljer du Välj medlemmar och använder sedan visningsnamnet som du kopierade tidigare för att söka i tjänstens huvudnamn.

5. Välj tjänstens huvudnamn och välj sedan Välj.

6. På fliken Granska + tilldela väljer du Granska + tilldela för att lägga till rolltilldelningen.

Nu kan du använda tjänstanslutningen i din Azure-pipelines arbetsflödesdefinition för att få åtkomst till din Azure belastningstestningsresurs.

Om du vill komma åt din Azure Load Testing resurs från GitHub Actions arbetsflödet skapar du först ett Microsoft Entra serviceobjekt. Tjänstens huvudnamn representerar ditt GitHub Actions arbetsflöde i Microsoft Entra ID.

Därefter beviljar du tjänstens principal behörighet för att skapa och köra ett lasttest med din Azure Load Testing-resurs.

Skapa ett huvudnamn för tjänsten

Skapa ett huvudnamn för tjänsten i Azure-prenumerationen och tilldela rollen Load Test Contributor så att ditt GitHub Actions arbetsflöde har åtkomst till din Azure belastningstestresurs för att köra belastningstester.

1. Skapa ett huvudnamn för tjänsten och tilldela Load Test Contributor rollen:

   # 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
   

   Utdata är ett JSON-objekt som representerar tjänstens huvudnamn. Du använder den här informationen för att autentisera med Azure i GitHub Actions arbetsflödet.

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

   Anmärkning

   Du kan få en --sdk-auth utfasningsvarning när du kör det här kommandot. Du kan också använda OIDC-baserad autentisering (OpenID Connect) för att autentisera GitHub med Azure. Lär dig hur du använd Azure inloggningsåtgärd med OpenID Connect.

2. Kopiera JSON-utdataobjektet till Urklipp.

   I nästa steg lagrar du informationen om tjänsthuvudnamnet som ett GitHub Actions-hemlighet.

Lagra Azure autentiseringsuppgifter i GitHub Actions hemlighet

** Skapa en hemlig nyckel i GitHub Actions för att säkert lagra service principal-informationen. Du använder den här hemligheten i arbetsflödesdefinitionen för att ansluta för att autentisera med Azure och komma åt din Azure belastningstestningsresurs.

Så här skapar du en GitHub Actions hemlighet:

1. I GitHub bläddrar du till lagringsplatsen.

2. Välj Inställningar Hemligheter>och variabler>Åtgärder.

3. Välj Ny lagringsplatshemlighet, ange hemlig information och välj sedan Lägg till hemlighet för att skapa en ny hemlighet.

   Fält	Värde
   Namn	AZURE_CREDENTIALS
   Hemlighet	Klistra in JSON-utdata från kommandot för att skapa ett tjänsthuvudkonto som du kopierade tidigare.

Nu kan du komma åt din Azure-prenumeration och läsa in testresursen från ditt GitHub Actions arbetsflöde med hjälp av de lagrade autentiseringsuppgifterna.

Om du använder ett annat CI/CD-verktyg använder du Azure CLI för att interagera med dina Azure resurser. Utför följande steg för att auktorisera CI-verktygets åtkomst till din belastningstestningsresurs:

1. Skapa ett Microsoft Entra serviceobjekt för att ansluta till din Azure-prenumeration och få åtkomst till din Azure belastningstestningsresurs.
2. Ge tjänstens huvudkonto behörighet att skapa och köra ett belastningstest genom att tilldela rollen Belastningstestbidragsgivare.
3. Lagra Azure autentiseringsuppgifterna på ett säkert sätt i CI-verktyget.

Utför följande steg för att konfigurera tjänstauktorisering för ditt CI-verktyg:

1. Skapa ett huvudnamn för tjänsten och tilldela rollen Load Test-deltagare:

   Ersätt platshållarna <resource-group-name> och <load-testing-resource-name> text.

   # 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
   

   Utdata är ett JSON-objekt som representerar tjänstens huvudnamn.

   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. clientIdKopiera värdena , clientSecretoch tenantId och lagra dem på ett säkert sätt som hemligheter i ditt CI-verktyg.

   Du använder dessa värden för att logga in på din Azure-prenumeration med kommandot Azure CLI az login.

Installera Azure Load Testing-tillägget för Azure DevOps

För att skapa och köra ett belastningstest använder Azure-pipelines arbetsflödesdefinitionen Azure Load Testing uppgift-tillägget från Azure DevOps Marketplace.

1. Öppna aktivitetstillägget Azure Load Testing på Azure DevOps Marketplace och välj Hämta det kostnadsfritt.

2. Välj din Azure DevOps organisation och välj sedan Installera för att installera tillägget.

   Om du inte har administratörsbehörighet för den valda Azure DevOps organisation väljer du Request för att begära att en administratör installerar tillägget.

Uppdatera arbetsflödet för Azure-pipelines

Uppdatera ditt Azure-pipelines arbetsflöde för att köra ett belastningstest för din Azure belastningstestningsresurs.

1. Logga in på din Azure DevOps organisation (https://dev.azure.com/<your-organization>) och välj ditt projekt.

2. Välj Pipelines i det vänstra navigeringsfältet, välj din pipeline och välj sedan Redigera för att redigera arbetsflödesdefinitionen.

   Alternativt väljer du Skapa pipeline för att skapa en ny pipeline i Azure-pipelines.

3. Använd uppgiften AzureLoadTest för att köra belastningstestet.

   Ange konfigurationsfilen för belastningstestet som du exporterade tidigare i egenskapen loadTestConfigFile .

   Ersätt platshållarna <load-testing-resource> och <load-testing-resource-group> med namnet på din Azure belastningstestningsresurs och resursgruppen.

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

   Du kan valfritt skicka parametrar eller hemligheter till belastningstestet med hjälp av egenskapen env eller secrets. Ange waitForCompletion: false om du vill fortsätta utan att vänta på att belastningstestkörningen ska slutföras.

4. Använd uppgiften publish för att publicera testresultaten som artefakter i din Azure-pipelines arbetsflödeskörning.

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

Uppdatera arbetsflödet för GitHub Actions

Uppdatera ditt GitHub Actions arbetsflöde för att köra ett belastningstest för din Azure belastningstestningsresurs.

1. I GitHub bläddrar du till lagringsplatsen.

2. Redigera ditt GitHub Actions arbetsflöde eller skapa ett nytt arbetsflöde på din GitHub lagringsplats.

3. Använd åtgärden actions/checkout för att checka ut lagringsplatsen med indatafilerna för belastningstestet.

       - name: Checkout
         uses: actions/checkout@v3
   

4. Använd åtgärden azure/login för att autentisera med Azure med hjälp av de lagrade autentiseringsuppgifterna.

   Klistra in följande YAML-innehåll i arbetsflödesdefinitionen:

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

5. Använd åtgärden azure/load-testing för att köra belastningstestet.

   Ange konfigurationsfilen för belastningstestet som du exporterade tidigare i egenskapen loadTestConfigFile .

   Ersätt platshållarna <load-testing-resource> och <load-testing-resource-group> med namnet på din Azure belastningstestningsresurs och resursgruppen.

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

   Du kan valfritt skicka parametrar eller hemligheter till belastningstestet med hjälp av egenskapen env eller secrets. Ange waitForCompletion: false om du vill fortsätta utan att vänta på att belastningstestkörningen ska slutföras.

6. Använd åtgärden actions/upload-artifact för att publicera testresultaten som artefakter i din GitHub Actions-arbetsflödeskörning.

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

Uppdatera ditt CI-arbetsflöde för att köra ett belastningstest för din Azure belastningstestningsresurs med hjälp av Azure CLI. Använd detaljerna i ditt CI-verktyg för att lägga till följande kommandon i ditt CI-arbetsflöde:

1. Logga in på Azure-prenumerationen med hjälp av tjänstens huvudkonto.

   Använd värdena clientId, clientSecret och tenantId som du lagrade tidigare.

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

2. Skapa ett belastningstest med yaml-filen för belastningstestkonfiguration.

   <load-testing-resource>Ersätt platshållarna , <load-testing-resource-group>och <load-test-config-yaml> text med namnet på belastningstestningsresursen, resursgruppens namn och filnamnet för yaml-filen för belastningstestkonfigurationen som du lade till på lagringsplatsen tidigare.

   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. Kör belastningstestet.

   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. Hämta och visa mått på klientsidan för belastningstestkörningen.

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

1. Ta bort Azure-pipelines ändringar:

   1. Logga in på din Azure DevOps organisation (https://dev.azure.com/<your-organization>) och välj ditt projekt.

      <your-organization> Ersätt textplatshållaren med projektidentifieraren.

   2. Om du har skapat en ny pipeline":

      1. Välj Pipelinesoch välj sedan din pipeline.

      2. Välj ellipsen och välj sedan Ta bort.

         

      3. Ange pipelinenamnet och välj sedan Ta bort för att ta bort pipelinen.

   3. Om du har ändrat en befintlig arbetsflödesdefinition kan du ångra ändringarna för att köra belastningstestet och spara arbetsflödet.

2. Ta bort tjänstanslutningen:

   1. Välj Project inställningar>Service-anslutningar och välj sedan tjänstanslutningen.
   2. Välj Redigera>ta bort för att ta bort tjänstanslutningen.

1. Ta bort GitHub Actions ändringar:

   1. I GitHub bläddrar du till lagringsplatsen.
   2. Om du har skapat en ny arbetsflödesdefinition tar du bort YAML-filen för arbetsflödet .github/workflows i mappen.
   3. Om du har ändrat en befintlig arbetsflödesdefinition kan du ångra ändringarna för att köra belastningstestet och spara arbetsflödet.

2. Ta bort tjänstens huvudnamn:

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

1. Ångra ändringarna i ditt CI-arbetsflöde.

2. Ta bort tjänstens huvudnamn:

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