Rövid útmutató: Végpontok közötti tesztek futtatása nagy méretekben a Playwright-munkaterületekkel

Ebben a rövid útmutatóban megtudhatja, hogyan futtathatja a Playwright-teszteket magas párhuzamos felhőbeli böngészőkkel a Playwright-munkaterületek használatával. A felhőinfrastruktúra használatával ellenőrizheti az alkalmazást több böngészőben, eszközön és operációs rendszeren.

A rövid útmutató elvégzése után rendelkezik egy Playwright-munkaterülettel, amely nagy léptékben futtatja a Playwright-teszteket.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Ha nincs Azure-előfizetésed, hozz létre egy ingyenes fiókot mielőtt elkezdenéd.
• Az Azure-fiókhoz tulajdonosi, közreműködői vagy klasszikus rendszergazdai szerepkörre van szükség.
• Egy drámaíró projekt. Ha nincs projektje, hozzon létre egyet a Playwright első lépések dokumentációjának használatával, vagy használja a Playwright Workspaces mintaprojektet.
• Azure parancssori felület (CLI). Ha nem rendelkezik Azure CLI-vel, tekintse meg az Azure CLI telepítését.

Munkaterület létrehozása

Ahhoz, hogy a Playwright-teszteket felhőböngészőkben futtathassa, először létre kell hoznia egy Playwright-munkaterületet.

1. Jelentkezzen be a Azure portalra.

2. Válassza a menügombot a portál bal felső sarkában, majd válassza az Erőforrás létrehozása erőforrás létrehozása lehetőséget.

   

3. Írja be a Drámaíró munkaterületek kifejezést a keresőmezőbe.

4. Válassza a Dramawright Workspaces kártyát , majd válassza a Létrehozás lehetőséget.

   

5. Adja meg a következő információkat egy új Playwright-munkaterület konfigurálásához:

   szakterület	Leírás
   Előfizetés	Válassza ki a Playwright-munkaterülethez használni kívánt Azure-előfizetést.
   Erőforráscsoport	Válasszon ki egy meglévő erőforráscsoportot. Vagy válassza az Új létrehozása lehetőséget, majd adjon meg egy egyedi nevet az új erőforráscsoportnak.
   Név	Adjon meg egy egyedi nevet a munkaterület azonosításához. A név csak alfanumerikus karakterekből és kötőjelekből állhat, és hossza 3 és 24 karakter között lehet.
   Helyszín	Válasszon ki egy földrajzi helyet a munkaterület üzemeltetéséhez. Ez a hely határozza meg a teszt végrehajtási eredményeinek tárolási helyét is.

   Megjegyzés:

   Igény szerint további részleteket is konfigurálhat a Címkék lapon. A címkék név-érték párok, amelyek lehetővé teszik az erőforrások kategorizálását és az összevont számlázás megtekintését úgy, hogy ugyanazt a címkét több erőforrásra és erőforráscsoportra alkalmazza.

6. Miután befejezte az erőforrás konfigurálását, válassza a Véleményezés + Létrehozás lehetőséget.

7. Tekintse át az összes konfigurációs beállítást, és válassza a Létrehozás lehetőséget a Playwright-munkaterület üzembe helyezésének megkezdéséhez.

   Ha a folyamat befejeződött, megjelenik egy üzembe helyezési sikeres üzenet.

8. Az új munkaterület megtekintéséhez válassza az Ugrás az erőforráshoz lehetőséget.

   

Playwright-munkaterületek csomag telepítése

A szolgáltatás használatához telepítse a Playwright Workspaces csomagot.

npm init @azure/playwright@latest

Ez létrehoz egy playwright.service.config.ts fájlt, amely a Playwright-munkaterületekre irányítja és hitelesíti a Playwright-munkaterületeket.

Ha már rendelkezik ezzel a fájllal, a csomag megkéri, hogy írja felül.

A szolgáltatás használatához telepítse a Playwright Workspaces csomagot.

dotnet add package Azure.Developer.Playwright.NUnit

A böngészővégpont konfigurálása

A beállítás során meg kell adnia a régióspecifikus böngészővégpontot. A végpont a munkaterület létrehozásakor kiválasztott Azure-régiótól függ.

A böngészővégpont URL-címének lekéréséhez hajtsa végre a következő lépéseket:

1. Jelentkezzen be az Azure Portalra az Azure-fiókjával, és lépjen a munkaterületre.

2. Válassza az Első lépések lapot.

   

3. A böngészővégpont hozzáadása a beállításhoz másolja a végpont URL-címét.

   Győződjön meg arról, hogy ez az URL-cím elérhető a környezeti változóban PLAYWRIGHT_SERVICE_URL .

   

Saját környezet beállítása

A környezet beállításához konfigurálnia kell a PLAYWRIGHT_SERVICE_URL környezeti változót az előző lépésekben kapott értékkel.

Javasoljuk, hogy a dotenv modullal kezelje a környezetet. Ezzel dotenvdefiniálja a környezeti változókat a .env fájlban.

1. Adja hozzá a modult dotenv a projekthez:

   npm i --save-dev dotenv
   

2. Adja hozzá a következő kódrészletet a playwright.service.config.ts:

   require('dotenv').config();
   

3. Hozzon létre egy .env fájlt a playwright.config.ts fájl mellett a Playwright-projektben:

   PLAYWRIGHT_SERVICE_URL={MY-REGION-ENDPOINT}
   

   Ügyeljen arra, hogy a {MY-REGION-ENDPOINT} szöveghelyőrzőt cserélje le a korábban másolt értékre.

Szolgáltatáskonfiguráció beállítása

Hozzon létre egy fájlt PlaywrightServiceSetup.cs a projektben az alábbi tartalommal.

using Azure.Developer.Playwright.NUnit;
using Azure.Identity;

namespace PlaywrightTests; // Remember to change this as per your project namespace

[SetUpFixture]
public class PlaywrightServiceNUnitSetup  : PlaywrightServiceBrowserNUnit
{
    public PlaywrightServiceNUnitSetup() : base(
        credential: new DefaultAzureCredential()
    ) 
    {}
}

Megjegyzés:

Győződjön meg arról, hogy a projekt az 1.50-es vagy újabb verziót használja Microsoft.Playwright.NUnit .

Hitelesítés beállítása

Ha a Playwright-teszteket a Playwright-munkaterületen szeretné futtatni, hitelesítenie kell a Playwright-ügyfelet, ahol a teszteket a szolgáltatással futtatja. Ez lehet a helyi fejlesztői gép vagy a CI-gép.

A szolgáltatás két hitelesítési módszert kínál: a Microsoft Entra-azonosítót és az Access-jogkivonatokat.

A Microsoft Entra ID az Azure-beli hitelesítő adatait használja, és bejelentkezést igényel az Azure-fiókjába a biztonságos hozzáférés érdekében. Másik lehetőségként létrehozhat egy hozzáférési jogkivonatot a Playwright-munkaterületről, és használhatja azt a beállításban.

Hitelesítés beállítása a Microsoft Entra-azonosítóval

A szolgáltatás alapértelmezett és ajánlott hitelesítése a Microsoft Entra ID. A helyi fejlesztői gépről Azure CLI- használatával jelentkezhet be

az login

Megjegyzés:

Ha több Microsoft Entra-bérlő tagja, mindenképpen jelentkezzen be arra a bérlőre, amelyhez a munkaterület tartozik. A bérlőazonosítót az Azure Portalról szerezheti be. Lásd: A Microsoft Entra-bérlő megkeresése. Miután megkapta az azonosítót, jelentkezzen be a paranccsal az login --tenant <TenantID>

Hitelesítés beállítása hozzáférési jogkivonatokkal

Létrehozhat egy hozzáférési jogkivonatot a Playwright-munkaterületről, és használhatja azt a beállításban. A fokozott biztonság miatt azonban erősen ajánljuk a Microsoft Entra ID-t a hitelesítéshez. A hozzáférési jogkivonatok, bár kényelmesek, úgy működnek, mint a hosszú élettartamú jelszavak, és fokozottabban kitettek a kompromittálódás veszélyének.

1. A hozzáférési jogkivonatokat használó hitelesítés alapértelmezés szerint le van tiltva. A használathoz engedélyezze a hozzáférési jogkivonaton alapuló hitelesítést.

2. Hitelesítés beállítása hozzáférési jogkivonatokkal.

Figyelmeztetés

Határozottan javasoljuk, hogy a Microsoft Entra ID-t használja a szolgáltatáshoz való hitelesítéshez. Ha hozzáférési jogkivonatokat használ, olvassa el a Hozzáférési jogkivonatok kezelése című témakört.

A tesztek nagy léptékű futtatása a Playwright-munkaterületekkel

Most már előkészítette a playwright-tesztek felhőben való futtatásának konfigurációját a Playwright-munkaterületekkel. A playwright parancssori felülettel futtathatja a teszteket, vagy használhatja a Playwright Test Visual Studio Code bővítményt.

Egyetlen teszt futtatása a szolgáltatással

A Playwright-munkaterületek esetén a teljes tesztpercek száma alapján kell fizetnie. Ha Ön első felhasználó, vagy elsőként kezdi meg az ingyenes próbaverziót, a teljes tesztcsomag helyett egyetlen teszt futtatásával kezdheti, hogy elkerülje az ingyenes próbaidőszak korlátainak kimerítését.

Miután ellenőrzi, hogy a teszt sikeresen lefut-e, fokozatosan növelheti a tesztterhelést, ha további teszteket futtat a szolgáltatással.

Hajtsa végre az alábbi lépéseket egyetlen playwright-teszt futtatásához a Playwright-munkaterületekkel:

Drámaíró parancssori felülete

Ha a Playwright CLI használatával szeretné futtatni a teszteket a Playwright-munkaterületekkel, adja át a szolgáltatás konfigurációs fájlját parancssori paraméterként.

1. Nyisson meg egy terminálablakot.

2. Írja be a következő parancsot a Playwright-teszt távoli böngészőkben való futtatásához a munkaterületen:

   Cserélje le a {name-of-file.spec.ts} szöveges helyőrzőt a tesztspecifikációs fájl nevére.

   npx playwright test {name-of-file.spec.ts} --config=playwright.service.config.ts
   

   A teszt befejezése után megtekintheti a teszt állapotát a terminálban.

   Running 1 test using 1 worker
       1 passed (2.2s)
   
   To open last HTML report run:
   
   npx playwright show-report
   

Visual Studio Code

Ha egyetlen Playwright-tesztet szeretne futtatni a Visual Studio Code-ban Playwright-munkaterületekkel, válassza ki a szolgáltatáskonfigurációs fájlt a Test Explorer nézetben. Ezután válassza ki és futtassa a tesztet a tesztek listájából.

1. Telepítse a Playwright Test Visual Studio Code bővítményt.

2. Nyissa meg a Test Explorer nézetet a tevékenységsávon.

   A tesztkezelő automatikusan észleli a Playwright-teszteket és a projekt szolgáltatáskonfigurációját.

   

3. Válassza az Alapértelmezett profil kiválasztása lehetőséget, majd válassza ki az alapértelmezett projekteket a szolgáltatáskonfigurációs fájlból.

   Figyelje meg, hogy a szolgáltatásfuttatási profilok a playwright.service.config.ts korábban hozzáadott fájlból származnak.

   Az alapértelmezett profil beállításával automatikusan futtathatja a teszteket a szolgáltatással, vagy egyszerre több Playwright-projektet is futtathat.

   

4. A tesztek listájában válassza a teszt melletti Teszt futtatása gombot a futtatáshoz.

   A teszt az alapértelmezett profilban kiválasztott projekteken fut. Ha egy vagy több projektet választott ki a szolgáltatáskonfigurációból, a teszt távoli böngészőkben fut a munkaterületen.

   

   Jótanács

   A tesztkód hibakeresése akkor is lehetséges, ha távoli böngészőkben futtatja a teszteket a Hibakeresés teszt gomb használatával.

5. A teszteredményeket közvetlenül a Visual Studio Code-ban tekintheti meg.

   

Mostantól több tesztet is futtathat a szolgáltatással, vagy futtathatja a teljes tesztcsomagot távoli böngészőkben.

Figyelmeztetés

A tesztcsomag méretétől függően további költségek merülhetnek fel a tesztpercekért és a teszteredményekért a kiszámolt ingyenes tesztperceken és az ingyenes teszteredményeken túl.

Teljes tesztcsomag futtatása a szolgáltatással

Most, hogy ellenőrizte, hogy egyetlen tesztet futtathat-e a Playwright-munkaterületekkel, nagy léptékben futtathat egy teljes Playwright-tesztcsomagot.

Hajtsa végre a következő lépéseket egy teljes Playwright-tesztcsomag playwright-munkaterületekkel való futtatásához:

Drámaíró parancssori felülete

Ha több Playwright-tesztet vagy teljes tesztcsomagot futtat Playwright-munkaterületekkel, parancssori paraméterként megadhatja a párhuzamos feldolgozók számát.

1. Nyisson meg egy terminálablakot.

2. Írja be a következő parancsot a Playwright tesztcsomag távoli böngészőkben való futtatásához a munkaterületen:

   npx playwright test --config=playwright.service.config.ts --workers=20
   

   A tesztcsomag méretétől függően ez a parancs legfeljebb 20 párhuzamos feldolgozón futtatja a teszteket.

   A teszt befejezése után megtekintheti a teszt állapotát a terminálban.

   Running 6 tests using 6 workers
       6 passed (18.2s)
   

Visual Studio Code

A Playwright tesztcsomag futtatása a Visual Studio Code-ban Playwright-munkaterületekkel:

1. Nyissa meg a Test Explorer nézetet a tevékenységsávon.

2. A Teszt futtatása gombra kattintva az összes teszt lefuttatható a Playwright-munkaterületekkel.

   Az összes teszt futtatásakor a rendszer az alapértelmezett profilt használja. Az előző lépésben úgy konfigurálta az alapértelmezett profilt, hogy a szolgáltatáskonfigurációból származó projekteket használjon.

   

   Jótanács

   A tesztkód hibakeresése akkor is lehetséges, ha távoli böngészőkben futtatja a teszteket a Hibakeresési tesztek gombbal.

3. Másik lehetőségként kiválaszthat egy adott szolgáltatáskonfigurációt a listából, hogy csak egy adott böngészőkonfiguráció tesztjeit futtassa.

   

4. Az összes teszteredményt megtekintheti a Teszteredmények lapon.

Playwright-teszteket futtathat a szolgáltatás által felügyelt böngészőken a fent létrehozott konfigurációval.

dotnet test -- NUnit.NumberOfTestWorkers=20

A tesztfuttatás befejezése után megtekintheti a teszt állapotát a terminálban.

Starting test execution, please wait...

A total of 100 test files matched the specified pattern.

Passed!  - Failed:     0, Passed:     100, Skipped:     0, Total:     100, Duration: 59 s - PlaywrightTestsNUnit.dll (net7.0)

Workload updates are available. Run `dotnet workload list` for more information.

Párhuzamos feldolgozó konfigurációjának optimalizálása

Ha a tesztek zökkenőmentesen futnak a szolgáltatással, kísérletezzen a párhuzamos feldolgozók számának módosításával annak az optimális konfigurációnak a meghatározásához, amely minimálisra csökkenti a tesztelési befejezési időt.

A Forgatókönyv-munkaterületek használatával akár 50 párhuzamos feldolgozóval is futtatható. Számos tényező befolyásolja a projekt legjobb konfigurációját, például az ügyfélgép processzorát, memóriáját és hálózati erőforrásait, a célalkalmazás terheléskezelési kapacitását és a tesztekben végrehajtott műveletek típusát.

Megadhatja a párhuzamos feldolgozók számát a Playwright PARANCSSOR parancssorán, vagy konfigurálhatja a workers tulajdonságot a Playwright szolgáltatás konfigurációs fájljában.

Megadhatja a párhuzamos feldolgozók számát a Playwright PARANCSSOR parancssorán, vagy konfigurálhatja a NumberOfTestWorkers tulajdonságot a .runsettings fájlban.

További információ a tesztcsomagok befejezésének optimalizálásához szükséges optimális konfiguráció meghatározásáról.

Következő lépés

Sikeresen létrehozott egy Playwright-munkaterületet az Azure Portalon, és futtatta a Playwright-teszteket a felhőböngészőkben.

Folytassa a következő rövid útmutatóval, a folyamatos, végpontok közötti tesztelés beállításához futtassa a Playwright-teszteket a CI-/CD-munkafolyamatban.

Folyamatos, végpontok közötti tesztelés beállítása CI/CD-ben