Azure Playwright

Az Azure Playwright egy teljesen menedzselt kezelt Azure szolgáltatás, amely a felhőt használja arra, hogy egyszerre lefuttathass Playwright teszteket sokkal magasabb párhuzamos rendszerrel különböző operációs rendszer-böngésző kombinációk között. Ez gyorsabb tesztfutásokat jelent szélesebb forgatókönyv-lefedettséggel, ami gyorsítja a funkciók megjelenítését anélkül, hogy a minőséget feláldoznánk. A szolgáltatás integrált jelentési képességeket is tartalmaz, amelyek automatikusan feltöltik a teszteredményeket és kapcsolódó artefaktumokat az Azure tárolóba, és megtekintik őket a szolgáltatási portálon, így gyorsabb és könnyebb hibakeresés érhető el. A Playwright Workspaces segítségével gyorsabban és magabiztosabban adhatod ki a funkciókat.

Készen áll az első lépésekre? Merülj be a gyorsindítási útmutatónkba!

Hasznos hivatkozások

• Gyorsindítás: Végponttól végpontig teszteket futtatni nagy léptékben
• Gyorsindítás: Folyamatos, végponttól végpontig tesztelést állítsunk be különböző böngészőkben és operációs rendszereken
• Fedezze fel a funkciókat és előnyöket
• Dokumentáció
• Árazás
• Visszajelzés megosztása

Első lépések

Kövesse ezeket a lépéseket, hogy meglévő Playwright tesztkészletét a szolgáltatással együtt futtatja.

Előfeltételek

• Egy Azure-fiók, aktív előfizetéssel. Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.
• Az Azure fiókodnak a tulajdonost, a hozzájárulót vagy a klasszikus adminisztrátori szerepeket kell beosztani.
• Az Azure CLI-t telepíteni kell arra a gépre, ahonnan Playwright teszteket futtatsz.

Munkaterület létrehozása

1. Jelentkezzen be az Azure Portalra az Azure-fiókjával.

2. Hozd létre a munkaterületet.

   • Válaszd ki a portál bal felső sarkában található menügombot, majd válaszd a Forrás létrehozását.

     

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

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

     

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

     szakterület	Description
     Subscription	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 állhat, és hossza 3 és 64 karakter között lehet.
     Location	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.
     Jelentéskészítés	A kapcsoló alapértelmezés szerint "Engedélyezett" állapotban van, hogy a felhasználók elmentsék és megtekinthessék tesztfutási jelentéseiket a Playwright Workspace-ből. Ha ki akarod kapcsolni a jelentést, kapcsold be a beállítást "Letiltva" (Letiltva).
     tárhelyfiók	Új tárolófiókot hoznak létre és alapértelmezés szerint kiválasztják, hogy tárolják a Playwright Workspaces jelentési artefaktumokat. Ha szeretnél kiválasztani egy meglévő tárfiókot, válaszd a legördülő menüből, vagy kattints a "Új létrehozás" gombra, hogy létrehozz egy új tárolófiókot, amit szeretnél.

     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.

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

   • 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.

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

     

Install Azure Playwright package

1. Futtatd ezt a parancsot a szolgáltatási csomag telepítéséhez

   npm init @azure/playwright@latest
   

A szolgáltatáscsomag telepítése egy szolgáltatáskonfigurációs fájlt hoz létre playwright.service.config.ts

A szolgáltatási konfiguráció a következőket szolgálja:

• Irányítsa és hitelesítse a Playwrightot a Playwright munkaterületeihez.
• Adja hozzá a Playwright Workspaces-t, amely a konfigurációhoz jelent.
• Ha szükséges, felülírják a szolgáltatási műveletek időkorlátait.

Győződjön meg arról, hogy a projekt az 1.47-es vagy újabb verziót használja @playwright/test .

Régió végpont megszerzése

1. Az Azure portálban másold le a parancsot a Régió végpont hozzáadása alá a beállításodban.

   

   A végpont URL-je megfelel a munkaterület régiónak. Az Azure portálban eltérő végpont URL-t is láthatsz, attól függően, hogy melyik régiót választottad a munkaterület létrehozásakor.

Környezet beállítása

Győződj meg róla, hogy az előző lépésben szerzett PLAYWRIGHT_SERVICE_URL anyag elérhető legyen a környezetedben.

Javasoljuk, hogy használd dotenv a modult a környezeted kezelésére. dotenv A .env fájlt fogod használni a környezeti változók meghatározására.

Ne felejts el fájlt hozzáadni .env a fájlodhoz .gitignore , hogy ne szivárogjanak ki a titkaid.

npm i --save-dev dotenv

.env fájl

PLAYWRIGHT_SERVICE_URL=wss://eastus.api.playwright.microsoft.com/playwrightworkspaces/workspace-id/browsers

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

Ahhoz, hogy a Playwright tesztjeit az Azure Playwright munkaterületedben lefuttathasd, hitelesítened kell azt a Playwright klienst, ahol a teszteket futtatod a szolgáltatással. 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 Microsoft Entra ID használatával

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

az login

MEGJEGYZÉS: Ha több Microsoft Entra bérlő tagja vagy, győződj meg róla, hogy bejelentkezz arra a bérlőre, ahol a munkaterületed tartozik. A bérlőazonosítót az Azure portálról szerezheted meg, lásd a Microsoft Entra Tenant megtalálását. 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étrehozhatsz hozzáférési tokent az Azure Playwright munkaterületedből, és felhasználhatod a beállításaidban. 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. Hozzáférési token alapú hitelesítés használatához engedélyezzük hozzáférési token alapú hitelesítést

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

Határozottan javasoljuk, hogy a Microsoft Entra ID-t használja a szolgáltatáshoz való hitelesítéshez. Hozzáférési jogkivonatok használata esetén lásd : Hozzáférési jogkivonatok kezelése

MEGJEGYZÉS: Az Azure Playwright használatához a CI pipeline-okban hitelesítést kell konfigurálni a pipeline szolgáltatásával, lásd a folyamatos végponttól végpontig tesztelést különböző böngészőkön és operációs rendszereken

A tesztek futtatása

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

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

Azure Playwright Reporter

Az Azure Playwright egy egyedi jelentést tartalmaz, amely automatikusan feltölti a Playwright HTML tesztjelentéseket az Azure Storage-ba, így közvetlenül az Azure portálon keresztül elérhetővé válik a hibakeresés és az eredménymegosztás megkönnyítése érdekében.

Features

• Automatikus jelentésfeltöltés: Zökkenőmentesen tölti fel a Playwright HTML jelentéseket Azure Storage fiókodra
• Portal Integration: View test results direct in the Azure Playwright portal
• Fejlesztett hibakeresés: Részletes teszt leletletekhez, nyomokhoz és képernyőképekhez való hozzáférés

Telepítés és konfigurálás

Az Azure Playwright reporter a @azure/playwright csomaghoz tartozik, és a Playwright beépített HTML riporterével együtt működik.

1. Állítsd be a riportereket a Playwright Config-ban

Hozzáadd mind a HTML reportert, mind az Azure Playwright reportert a playwright.service.config.tskövetkezőkhöz:

import { DefaultAzureCredential } from "@azure/identity";
import { defineConfig } from "@playwright/test";
import { createAzurePlaywrightConfig } from "@azure/playwright";

const credential = new DefaultAzureCredential();
const playwrightConfig = defineConfig({});
defineConfig(playwrightConfig, createAzurePlaywrightConfig(playwrightConfig, { credential }), {
  reporter: [
    ["html", { open: "never" }], // HTML reporter must come first
    ["@azure/playwright/reporter"], // Azure reporter uploads HTML report
  ],
});

2. Előfeltételek a jelentéshez

Az Azure Playwright jelentésíró használata előtt győződjön meg róla, hogy a munkaterülete megfelelően be van állítva:

Munkaterület konfigurálása

Engedélyezés jelentése és tárolás konfigurálása:

1. Lépj el a Playwright Workspace-edre az Azure portálon
2. Navigálj a Tárolás konfigurációs fülre
3. Kapcsolja be a jelentésengedélyezésre
4. Új fiók létrehozása vagy meglévő tárfiók kiválasztása
5. Kattintson a Mentés-re

Konfiguráld az RBAC-ot a tároló hozzáféréshez:

1. Nyisd meg a kapcsolt tárolófiókot
2. Lépj a Access Control (IAM) fülre
3. Kattints Szerep hozzárendelés hozzáadása
4. Keresd meg és válaszd a Storage Blob Data Contributor szerepet, majd kattints a Next gombra
5. Válassz és add fel az összes tesztet futtató tagot
6. Kattints Review + assign

A CORS beállítása a Trace Viewerhez:

1. Nyisd meg a kapcsolt tárolófiókot
2. Menj a Beállítások → Erőforrásmegosztás (CORS) menübe.
3. A Blob service alatt adj hozzá egy új rekordot:
   • Engedélyezett források: https://trace.playwright.dev
   • Engedélyezett módszerek: GET, OPTIONS
   • Maximális életkor: Írj be egy értéket 0 és 2147483647 között
4. Kattintson a Mentés-re

Ügyfélkövetelmények

• Hitelesítés: Microsoft Entra ID hitelesítés szükséges (hozzáférési tokenek nem támogatottak a jelentéshez)
• Drámaíró verzió: Drámaíró 1.57-es vagy újabb verzió szükséges.
• Szolgáltatás konfiguráció: A szolgáltatáskonfigurációt kell használni (playwright.service.config.ts)
• Munkaterület beállítások: A jelentést engedélyezni kell az Azure Playwright munkaterületedben

Hogyan működik?

1. Test Execution: A tesztek normál módon futnak Azure Playwright service browsers használatával
2. HTML jelentésgenerálás: A Playwright HTML jelentése generálja a szabványos tesztjelentést
3. Automatikus feltöltés: Azure reporter feltölti a HTML jelentés mappát a munkaterületed Azure Storage-jába
4. Portál hozzáférés: Eredmények megtekintése az Azure portálon a megadott URL-en keresztül

Következő lépések

• Teszteket futtatj egy CI/CD pipeline-ban.

• Tanulja meg, hogyan kezelheti a létrehozott munkaterülethez való hozzáférést .

• Kísérletezz különböző számú dolgozóval, hogy meghatározd a tesztkészlet optimális konfigurációját.

Közreműködés

Ez a projekt üdvözli a hozzájárulásokat és javaslatokat. A legtöbb hozzájárulás megköveteli, hogy elfogadja a közreműködői licencszerződést (CLA), amely kimondja, hogy önnek joga van a hozzájárulás használatára, és valóban meg kell adnia nekünk a jogosultságokat a hozzájárulás használatára. A részletekért látogasson el ide https://cla.opensource.microsoft.com.

Amikor beküldöd a pull requestet, egy CLA bot automatikusan eldönti, hogy szükséges-e CLA-t megadni és megfelelően díszíteni a PR-t (pl. status ellenőrzés, komment). Egyszerűen kövesse a robot utasításait. Ezt csak egyszer kell elvégeznie az összes adattárban a CLA használatával.

Ez a projekt a Microsoft nyílt forráskóddal kapcsolatos viselkedési szabályzata alapján működik. További információkért lásd a magatartási kódexével kapcsolatos gyakori kérdéseket, vagy további kérdésekkel vagy megjegyzésekkel forduljon opencode@microsoft.com.

Védjegyek

Ez a projekt tartalmazhat védjegyeket vagy logókat projektekhez, termékekhez vagy szolgáltatásokhoz. A Microsoft védjegyeinek vagy emblémáinak engedélyezett használatára a Microsoft védjegyekre és emblémákra vonatkozó irányelvei vonatkoznak, és meg kell felelniük a Microsoft védjegyekre és védjegyekre vonatkozó irányelveinek. A Microsoft védjegyeinek vagy emblémáinak használata a projekt módosított verzióiban nem okozhat zavart, és nem utalhat a Microsoft szponzorálására. Harmadik fél védjegyeinek vagy logóinak bármilyen használata ezeknek a harmadik féleknek a szabályzatai alá kerül.