Ci/CD-munkafolyamat manuális konfigurálása terheléstesztek futtatásához

Ci/CD-folyamat létrehozásával automatizálhatja a terheléstesztelést az Azure Load Testingben. Ebből a cikkből megtudhatja, hogyan konfigurálhatja manuálisan a GitHub Actionst, az Azure Pipelinest vagy más CI-eszközöket egy meglévő teszt meghívásához az Azure Load Testingben. Terhelésteszt automatizálása az alkalmazás teljesítményének és stabilitásának folyamatos ellenőrzéséhez terhelés alatt.

Meglévő terhelési teszt hozzáadása CI/CD-folyamathoz:

• Konfigurálja a szolgáltatáshitelesítést, hogy a CI-eszköz csatlakozzon az Azure terheléstesztelési erőforrásához.
• Adjon hozzá terhelésteszt bemeneti fájlokat az adattárhoz, például a JMeter tesztszkriptet és a terhelésteszt YAML-konfigurációját.
• Frissítse a CI/CD-folyamatdefiníciót az Azure Load Testing meghívásához.

Előfeltételek

• An Azure account with an active subscription. Fiók ingyenes létrehozása.
• Azure Load Testing-teszt. Hozzon létre egy URL-alapú terheléstesztet , vagy használjon egy meglévő JMeter-szkriptet a terhelési teszt létrehozásához.

Azure Pipelines

• Egy Azure DevOps-szervezet és -projekt. Ha nem rendelkezik Azure DevOps-szervezettel, ingyenesen létrehozhat egyet. Ha segítségre van szüksége az Azure Pipelines használatának megkezdéséhez, olvassa el az első folyamat létrehozása című témakört.

GitHub Actions

• Egy GitHub-fiók. Ha nincs GitHub-fiókja, ingyenesen létrehozhat egyet.
• Egy GitHub-adattár a terhelésteszt bemeneti fájljainak tárolására és egy GitHub Actions-munkafolyamat létrehozására. A létrehozásról az Új adattár létrehozása című témakörben olvashat.

Egyéb

• Ci-folyamat létrehozásához vagy módosításához szükséges engedély.
• Forráskódtár a terhelésteszt bemeneti fájljainak tárolására.

Szolgáltatáshitelesítés konfigurálása

Ha terheléstesztet szeretne futtatni a CI/CD-munkafolyamatban, engedélyt kell adnia a CI/CD munkafolyamatnak a terheléstesztelési erőforrás eléréséhez. Hozzon létre egy egyszerű szolgáltatást a CI/CD-munkafolyamathoz, és rendelje hozzá a Terhelésteszt közreműködője Azure RBAC-szerepkört.

Azure Pipelines

Szolgáltatáskapcsolat létrehozása az Azure Pipelinesban

Az Azure Pipelinesban szolgáltatáskapcsolatot hoz létre az Azure DevOps-projektben az Azure-előfizetés erőforrásainak eléréséhez. A szolgáltatáskapcsolat létrehozásakor az Azure DevOps létrehoz egy Microsoft Entra szolgáltatásnév objektumot.

1. Jelentkezzen be az Azure DevOps-szervezetbe (https://dev.azure.com/<your-organization>), és válassza ki a projektet.

   Cserélje le a <your-organization> szöveges helyőrzőt a projektazonosítóra.

2. Válassza a Projektbeállítások>Szolgáltatáskapcsolatok>+ Új szolgáltatáskapcsolat lehetőséget.

3. Az Új szolgáltatáskapcsolat panelen válassza az Azure Resource Managert, majd a Tovább lehetőséget.

4. Válassza ki a Szolgáltatásnév (automatikus) hitelesítési módszert, majd válassza a Tovább gombot.

5. Adja meg a szolgáltatáskapcsolat részleteit, majd válassza a Mentés lehetőséget a szolgáltatáskapcsolat létrehozásához.

   Mező	Value
   Hatókör szintje	Előfizetés.
   Előfizetés	Válassza ki a terheléstesztelési erőforrást üzemeltető Azure-előfizetést.
   Erőforráscsoport	Válassza ki a terheléstesztelési erőforrást tartalmazó erőforráscsoportot.
   Szolgáltatáskapcsolat neve	Adja meg a szolgáltatáskapcsolat egyedi nevét.
   Hozzáférési engedély megadása az összes folyamathoz	Ellenőrizni.

6. A szolgáltatáskapcsolatok listájában válassza ki a korábban létrehozottat, majd válassza a Szolgáltatásnév kezelése lehetőséget.

   

   Az Azure Portal egy külön böngészőlapon nyílik meg, és megjeleníti a szolgáltatásnév részleteit.

7. Az Azure Portalon másolja ki a Megjelenítendő név értékét.

   Ezt az értéket használja a következő lépésben, hogy engedélyeket adjon a terheléstesztek futtatásához a szolgáltatásnévnek.

Hozzáférés biztosítása az Azure Load Testinghez

Az Azure Load Testing az Azure RBAC használatával biztosít engedélyeket adott tevékenységek végrehajtásához a terheléstesztelési erőforráson. A CI/CD-folyamat terheléstesztjének futtatásához adja meg a terhelésteszt közreműködői szerepkörét a szolgáltatásnévnek.

1. Az Azure Portalon nyissa meg az Azure Load Testing-erőforrást.

2. Válassza a Hozzáférés-vezérlés (IAM)>Szerepkör-hozzárendelés hozzáadása>lehetőséget.

3. A Szerepkör lapon válassza a Feladatfüggvény-szerepkörök listájában a Közreműködő betöltése teszt lehetőséget.

   

4. A Tagok lapon válassza a Tagok kijelölése lehetőséget, majd használja a korábban másolt megjelenítendő nevet a szolgáltatásnévben való kereséshez.

5. Válassza ki a szolgáltatásnevet, majd válassza a Kiválasztás lehetőséget.

6. A Véleményezés + hozzárendelés lapon válassza a Véleményezés + hozzárendelés lehetőséget a szerepkör-hozzárendelés hozzáadásához.

Most már használhatja a szolgáltatáskapcsolatot az Azure Pipelines munkafolyamat-definíciójában az Azure terheléstesztelési erőforrás eléréséhez.

GitHub Actions

Az Azure Load Testing-erőforrás GitHub Actions-munkafolyamatból való eléréséhez először létre kell hoznia egy Microsoft Entra szolgáltatásnevet. Ez a szolgáltatásnév képviseli a GitHub Actions-munkafolyamatot a Microsoft Entra ID-ban.

Ezután engedélyt ad a szolgáltatásnévnek egy terhelésteszt létrehozásához és futtatásához az Azure Load Testing-erőforrással.

Egyszerű szolgáltatás létrehozása

Hozzon létre egy szolgáltatásnevet az Azure-előfizetésben, és rendelje hozzá a Terhelésteszt közreműködői szerepkört, hogy a GitHub Actions-munkafolyamat hozzáférhessen az Azure-beli terheléstesztelési erőforráshoz a terheléstesztek futtatásához.

1. Hozzon létre egy szolgáltatásnevet, és rendelje hozzá a szerepkört 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
   

   A kimenet egy JSON-objektum, amely a szolgáltatásnevet jelöli. Ezekkel az információkkal hitelesítheti magát az Azure-ral a GitHub Actions munkafolyamatában.

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

   Megjegyzés:

   A parancs futtatásakor elavulási figyelmeztetés jelenhet --sdk-auth meg. Az OpenID Csatlakozás (OIDC) alapú hitelesítéssel is hitelesítheti a GitHubot az Azure-ral. Megtudhatja, hogyan használhatja az Azure bejelentkezési műveletet az OpenID Csatlakozás.

2. Másolja a kimeneti JSON-objektumot a vágólapra.

   A következő lépésben a szolgáltatásnév adatait GitHub Actions-titkos kódként tárolja.

Azure-beli hitelesítő adatok tárolása a GitHub Actions titkos kulcsában

Hozzon létre egy GitHub Actions-titkos kulcsot a szolgáltatásnév adatainak biztonságos tárolásához. Ezzel a titkos kóddal csatlakozhat a munkafolyamat-definícióban az Azure-ral való hitelesítéshez és az Azure terheléstesztelési erőforrásához való hozzáféréshez.

Megjegyzés:

Ha OpenID Csatlakozás használ az Azure-ral való hitelesítéshez, nem kell átadnia a szolgáltatásnév objektumot az Azure bejelentkezési műveletében. Megtudhatja, hogyan használhatja az Azure bejelentkezési műveletet az OpenID Csatlakozás.

GitHub Actions-titkos kód létrehozása:

1. A GitHubon keresse meg az adattárat.

2. Válassza a Gépház> Secrets &változók>műveletek lehetőséget.

3. Válassza az Új tárház titkos kód lehetőséget, írja be a titkos adatokat, majd válassza a Titkos kód hozzáadása lehetőséget egy új titkos kód létrehozásához.

   Mező	Value
   Név	AZURE_CREDENTIALS
   Titkos kód	Illessze be a JSON-kimenetet a korábban másolt szolgáltatásnév létrehozási parancsából.

Mostantól hozzáférhet az Azure-előfizetéséhez és betöltheti a tesztelési erőforrást a GitHub Actions munkafolyamatából a tárolt hitelesítő adatok használatával.

Egyéb

Ha egy másik CI/CD-eszközt használ, az Azure CLI használatával használhatja az Azure-erőforrásokat. A CI-eszköz terheléstesztelési erőforráshoz való hozzáférésének engedélyezéséhez hajtsa végre az alábbi lépéseket:

1. Hozzon létre egy Microsoft Entra-szolgáltatásnevet az Azure-előfizetéshez való csatlakozáshoz és az Azure-terheléstesztelési erőforrás eléréséhez.
2. Adjon engedélyt a szolgáltatásnévnek a terhelési teszt létrehozásához és futtatásához a Terhelésteszt közreműködői szerepkör hozzárendelésével.
3. Az Azure hitelesítő adatainak biztonságos tárolása a CI-eszközben.

Hajtsa végre az alábbi lépéseket a CI-eszköz szolgáltatásengedélyezési eszközének konfigurálásához:

1. Hozzon létre egy szolgáltatásnevet, és rendelje hozzá a Terhelésteszt közreműködői szerepkört:

   Cserélje le a és <load-testing-resource-name> a <resource-group-name> szöveg helyőrzőit.

   # 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 kimenet egy JSON-objektum, amely a szolgáltatásnevet jelöli.

   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. Másolja ki a clientId, clientSecretés tenantId az értékeket, és biztonságosan tárolja őket titkos kulcsként a CI-eszközben.

   Ezekkel az értékekkel az Azure CLI-paranccsal az login jelentkezhet be az Azure-előfizetésébe.

Betöltési tesztfájlok hozzáadása az adattárban

Ha egy CI/CD-munkafolyamatban szeretne terheléstesztet futtatni az Azure Load Testing használatával, hozzá kell adnia az összes betöltési teszt bemeneti fájlját a forrásvezérlő tárházához.

Ha nem rendelkezik meglévő terhelési teszttel, adja hozzá a következő fájlokat a forráskódtárhoz:

• Terhelésteszt konfigurációs YAML-fájl. Megtudhatja, hogyan hozhat létre terhelésteszt-konfigurációs YAML-fájlt.
• Teszttervfájl. JMeter-alapú tesztekhez adjon hozzá egy JMeter-tesztszkriptet (JMX fájlt). URL-alapú tesztekhez adjon hozzá egy kérelem JSON-fájlt.
• Bármely JMeter-felhasználó tulajdonságfájlja.
• A tesztterv által használt bemeneti adatfájlok. Például CSV-adatfájlok.

Ha már rendelkezik terheléses teszttel, a konfigurációs beállításokat és az összes bemeneti fájlt közvetlenül az Azure Portalról töltheti le. Az alábbi lépéseket követve töltse le a bemeneti fájlokat egy meglévő terhelésteszteléshez az Azure Portalon:

1. Az Azure Portalon nyissa meg az Azure Load Testing-erőforrást.

2. A bal oldali panelen válassza a Tesztek lehetőséget a terheléses tesztek listájának megtekintéséhez, majd válassza ki a tesztet.

   

3. Válassza ki a tesztfuttatás melletti három pontot (...), majd válassza a Bemeneti fájl letöltése lehetőséget.

   A böngésző letölt egy tömörített mappát, amely tartalmazza a terhelésteszt bemeneti fájljait.

   

4. A bemeneti fájlok kinyeréséhez használjon bármilyen zip-eszközt.

   A mappa a következő fájlokat tartalmazza:

   • config.yaml: a terhelésteszt YAML konfigurációs fájlja. Erre a fájlra a CI/CD munkafolyamat-definíciójában hivatkozhat.
   • .jmx: a JMeter tesztszkript
   • A terhelési teszt futtatásához szükséges további bemeneti fájlok, például CSV-fájlok vagy felhasználói tulajdonságok fájljai.

5. Véglegesítse az összes kinyert bemeneti fájlt a forrásvezérlő adattárba.

   Használja azt a forráskódtárat, amelyben a CI/CD-folyamatot konfigurálja.

A CI/CD munkafolyamat-definíciójának frissítése

Az Azure Load Testing a GitHub Actionst és az Azure Pipelinest is támogatja a terheléstesztek futtatásához.

Azure Pipelines

Az Azure DevOps Azure Load Testing bővítményének telepítése

Terhelési teszt létrehozásához és futtatásához az Azure Pipelines munkafolyamat-definíciója az Azure DevOps Marketplace Azure Load Testing feladatbővítményét használja.

1. Nyissa meg az Azure Load Testing feladatbővítményt az Azure DevOps Marketplace-en, és válassza az Ingyenes lekérés lehetőséget.

2. Válassza ki az Azure DevOps-szervezetet, majd válassza az Install (Telepítés) lehetőséget a bővítmény telepítéséhez.

   Ha nem rendelkezik rendszergazdai jogosultságokkal a kijelölt Azure DevOps-szervezethez, válassza a Kérés lehetőséget, amely rendszergazda segítségét kéri a bővítmény telepítéséhez.

Az Azure Pipelines munkafolyamatának frissítése

Frissítse az Azure Pipelines-munkafolyamatot, hogy lefuttasson egy terheléstesztet az Azure-beli terheléstesztelési erőforráshoz.

1. Jelentkezzen be az Azure DevOps-szervezetbe (https://dev.azure.com/<your-organization>), és válassza ki a projektet.

2. Válassza ki a folyamatok lehetőséget a bal oldali navigációs sávon, válassza ki a folyamatot, majd válassza a Szerkesztés lehetőséget a munkafolyamat-definíció szerkesztéséhez.

   Másik lehetőségként válassza a Folyamat létrehozása lehetőséget egy új folyamat létrehozásához az Azure Pipelinesban.

3. AzureLoadTest A feladat használatával futtassa a terhelési tesztet.

   Adja meg a tulajdonságban korábban exportált terhelésteszt konfigurációs fájlját loadTestConfigFile .

   Cserélje le a és <load-testing-resource-group> szöveges <load-testing-resource> helyőrzőket az Azure terheléstesztelési erőforrásának és az erőforráscsoportnak a nevére.

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

   Opcionálisan paramétereket vagy titkos kulcsokat is átadhat a terhelési tesztnek a tulajdonság vagy secrets a env tulajdonság használatával.

4. publish A feladat használatával a teszteredményeket összetevőkként teheti közzé az Azure Pipelines-munkafolyamat-futtatásban.

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

GitHub Actions

A GitHub Actions munkafolyamatának frissítése

Frissítse a GitHub Actions-munkafolyamatot egy terhelésteszt futtatásához az Azure terheléstesztelési erőforrásához.

1. A GitHubon keresse meg az adattárat.

2. Szerkessze a GitHub Actions-munkafolyamatot, vagy hozzon létre egy új munkafolyamatot a GitHub-adattárban.

3. actions/checkout A művelettel megtekintheti az adattárat a terhelésteszt bemeneti fájljaival.

       - name: Checkout
         uses: actions/checkout@v3
   

4. azure/login A művelettel hitelesíthető az Azure-ral a tárolt hitelesítő adatokkal.

   Illessze be a következő YAML-tartalmat a munkafolyamat-definícióba:

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

5. A művelet használatával azure/load-testing futtassa a terhelési tesztet.

   Adja meg a tulajdonságban korábban exportált terhelésteszt konfigurációs fájlját loadTestConfigFile .

   Cserélje le a és <load-testing-resource-group> szöveges <load-testing-resource> helyőrzőket az Azure terheléstesztelési erőforrásának és az erőforráscsoportnak a nevére.

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

   Opcionálisan paramétereket vagy titkos kulcsokat is átadhat a terhelési tesztnek a tulajdonság vagy secrets a env tulajdonság használatával.

6. actions/upload-artifact A művelet használatával a teszteredményeket összetevőkként teheti közzé a GitHub Actions-munkafolyamat-futtatásban.

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

Egyéb

Frissítse a CI-munkafolyamatot egy terhelésteszt futtatásához az Azure-beli terheléstesztelési erőforráshoz az Azure CLI használatával. A CI-eszköz jellemzőinek használatával adja hozzá a következő parancsokat a CI-munkafolyamathoz:

1. Jelentkezzen be az Azure-előfizetésbe a szolgáltatásnév használatával.

   Használja a clientIdkorábban tárolt , clientSecretés tenandId értékeket.

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

2. Hozzon létre egy terheléstesztet a terhelésteszt konfigurációs YAML-fájljának használatával.

   Cserélje le a <load-testing-resource>, <load-testing-resource-group>és <load-test-config-yaml> a szöveges helyőrzőket a terheléstesztelési erőforrás nevére, az erőforráscsoport nevére és az adattárhoz korábban hozzáadott terheléstesztelési konfigurációs YAML-fájl fájlnevére.

   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. Futtassa a terhelési tesztet.

   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. A terhelésteszt futtatásához szükséges ügyféloldali metrikák lekérése és megjelenítése.

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

Terhelésteszt eredményeinek megtekintése

Amikor betöltési tesztet futtat a CI/CD-folyamatból, az összefoglaló eredményeket közvetlenül a CI/CD kimeneti naplójában tekintheti meg. Ha a teszteredményeket folyamatösszetevőként tette közzé, egy CSV-fájlt is letölthet a további jelentéskészítéshez.

Clean up resources

Ha nem tervezi használni a létrehozott erőforrásokat, törölje őket, hogy ne járjon további költségekkel.

Azure Pipelines

1. Az Azure Pipelines módosításainak eltávolítása:

   1. Jelentkezzen be az Azure DevOps-szervezetbe (https://dev.azure.com/<your-organization>), és válassza ki a projektet.

      Cserélje le a <your-organization> szöveges helyőrzőt a projektazonosítóra.

   2. Ha új folyamatot hozott létre":

      1. Válassza a Folyamatok lehetőséget, majd válassza ki a folyamatot.

      2. Jelölje ki a három pontot, majd válassza a Törlés lehetőséget.

         

      3. Adja meg a folyamat nevét, majd válassza a Törlés lehetőséget a folyamat törléséhez.

   3. Ha módosított egy meglévő munkafolyamat-definíciót, vonja vissza a terhelési teszt futtatásához szükséges módosításokat, és mentse a munkafolyamatot.

2. Távolítsa el a szolgáltatáskapcsolatot:

   1. Válassza a Projektbeállítások>szolgáltatáskapcsolatok lehetőséget, majd válassza ki a szolgáltatáskapcsolatot.
   2. Válassza a Törlés szerkesztése lehetőséget>a szolgáltatáskapcsolat eltávolításához.

GitHub Actions

1. GitHub Actions-módosítások eltávolítása:

   1. A GitHubon keresse meg az adattárat.
   2. Ha létrehozott egy új munkafolyamat-definíciót, törölje a munkafolyamat YAML-fájlját a .github/workflows mappából.
   3. Ha módosított egy meglévő munkafolyamat-definíciót, vonja vissza a terhelési teszt futtatásához szükséges módosításokat, és mentse a munkafolyamatot.

2. Távolítsa el a szolgáltatásnevet:

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

Egyéb

1. Visszavonhatja a CI-munkafolyamat módosításait.

2. Távolítsa el a szolgáltatásnevet:

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

További lépések

A következő cikkből megtudhatja, hogyan azonosíthatja a teljesítményregressziókat a teszt sikertelenségére vonatkozó feltételek meghatározásával és a tesztfuttatások összehasonlításával.

• Oktatóanyag: Regressziós tesztek automatizálása
• Teszthibák feltételeinek meghatározása
• Teljesítménybeli trendek megtekintése az idő függvényében