Azure Playwright

Azure Playwright je plně spravovaná služba Azure, která využívá cloud k tomu, aby vám umožnila spouštět testy Playwright s mnohem vyšší paralelizací napříč různými kombinacemi operačního systému a prohlížeče současně. To znamená rychlejší testovací běhy s širším pokrytím scénářů, což pomáhá urychlit doručování funkcí bez obětování kvality. S pracovními plochami Playwright můžete funkce vydávat rychleji a s větší jistotou.

Jste připravení začít? Skočte do našeho průvodce rychlým startem!

Užitečné odkazy

• Rychlý start: Spouštění komplexních testů ve velkém měřítku
• Rychlý start: Nastavení průběžného komplexního testování v různých prohlížečích a operačních systémech
• Prozkoumejte funkce a výhody
• Dokumentace
• cen
• Sdílet názory

Začínáme

Pomocí těchto kroků spustíte stávající testovací sadu Playwright se službou.

Požadavky

• Účet Azure s aktivním předplatným. Pokud nemáte předplatné Azure, si před zahájením vytvořit bezplatný účet.
• Vašemu účtu Azure musí být přiřazena role vlastníka, přispěvatele nebo jedné z rolí klasického správce.
• Azure CLI musí být nainstalované v počítači, ze kterého spouštíte testy Playwright.

Vytvoření pracovní plochy

1. Přihlaste se k webu Azure Portal pomocí svého účtu Azure.

2. Vytvořte pracovní prostor.

   • Vyberte tlačítko nabídky v levém horním rohu portálu a poté vyberte možnost Vytvořit prostředek.

     

   • Do vyhledávacího pole zadejte Playwright Workspaces .

   • Vyberte kartu Pracovní prostory dramatika a poté vyberte možnost Vytvořit.

     

   • Zadejte následující informace pro konfiguraci nové pracovní plochy Playwright:

     Obor	Description
     Subscription	Vyberte předplatné Azure, které chcete použít pro tento pracovní prostor Playwright.
     Skupina zdrojů	Vyberte existující skupinu prostředků. Nebo vyberte Vytvořit nový a zadejte jedinečný název nové skupiny prostředků.
     název	Zadejte jedinečný název pro identifikaci pracovního prostoru. Název se může skládat pouze z alfanumerických znaků a může mít délku mezi 3 a 64 znaky.
     Location	Vyberte zeměpisné umístění pro hostování vašeho pracovního prostoru. Toto umístění také určuje, kde jsou uloženy výsledky provedení testu.

     Poznámka:

     Volitelně můžete nakonfigurovat další podrobnosti na kartě Značky . Značky jsou páry názvů a hodnot, které umožňují kategorizovat prostředky a zobrazit konsolidovanou fakturaci použitím stejné značky u více prostředků a skupin prostředků.

   • Po dokončení konfigurace prostředku vyberte Zkontrolovat a vytvořit.

   • Zkontrolujte všechna nastavení konfigurace a výběrem možnosti Vytvořit spusťte nasazení pracovní plochy Playwright.

   • Po dokončení procesu se zobrazí zpráva o úspěšném nasazení.

   • Pokud chcete zobrazit nový pracovní prostor, vyberte Přejít k prostředku.

     

Instalace balíčku Azure Playwright

1. Spuštěním tohoto příkazu nainstalujte balíček služby

   npm init @azure/playwright
   

Instalací balíčku služby se vytvoří konfigurační soubor služby s názvem playwright.service.config.ts

Konfigurace služby slouží k:

• Směrovat a ověřovat dramatika na pracovní prostory dramatika.
• V případě potřeby přepište časové limity pro operace služby.

Ujistěte se, že váš projekt používá @playwright/test verzi 1.47 nebo vyšší.

Získání koncového bodu oblasti

1. Na webu Azure Portal zkopírujte příkaz do části Přidat koncový bod oblasti ve svém nastavení.

   

   Adresa URL koncového bodu odpovídá oblasti pracovního prostoru. V Azure Portal se může zobrazit jiná adresa URL koncového bodu v závislosti na oblasti, kterou jste vybrali při vytváření pracovního prostoru.

Nastavení prostředí

Ujistěte se, že to PLAYWRIGHT_SERVICE_URL , co jste získali v předchozím kroku, je dostupné ve vašem prostředí.

Pro správu prostředí doporučujeme použít dotenv modul. S dotenv budete používat soubor .env k definování proměnných prostředí.

Nezapomeňte přidat .env soubor do svého .gitignore souboru, aby nedošlo k úniku vašich tajemství.

npm i --save-dev dotenv

Soubor .env

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

Nastavení ověřování

Chcete-li spustit testy Playwright v pracovním prostoru Azure Playwright, musíte ověřit klienta Playwright, ve kterém testy se službou spouštíte. Může to být místní vývojový počítač nebo počítač CI.

Služba nabízí dva způsoby ověřování: Microsoft Entra ID a Access Tokens.

Microsoft Entra ID používá vaše přihlašovací údaje Azure, které vyžadují přihlášení k vašemu účtu Azure pro zabezpečený přístup. Případně můžete vygenerovat přístupový token z pracovního prostoru Playwright a použít ho v nastavení.

Nastavení autentizace pomocí Microsoft Entra ID

Id Microsoft Entra je výchozí a doporučené ověřování pro službu. Z místního vývojového počítače můžete k přihlášení použít Azure CLI.

az login

POZNÁMKA: Pokud jste součástí více klientů Microsoft Entra, ujistěte se, že se přihlašujete k klientovi, do kterého patří váš pracovní prostor. ID tenanta můžete získat z Azure Portal, viz Vyhledání tenanta Microsoft Entra. Jakmile získáte ID, přihlaste se pomocí příkazu. az login --tenant <TenantID>

Nastavení ověřování pomocí přístupových tokenů

Přístupový token můžete vygenerovat z pracovního prostoru Azure Playwright a použít ho v nastavení. Důrazně však doporučujeme Microsoft Entra ID pro ověřování kvůli jeho vylepšenému zabezpečení. Přístupové tokeny, i když jsou pohodlné, fungují jako dlouhodobá hesla a jsou náchylnější ke kompromitaci.

1. Chcete-li použít ověřování na základě přístupového tokenu, povolte ověřování na základě přístupových tokenů.

2. Nastavení ověřování pomocí přístupových tokenů

Důrazně doporučujeme použít Microsoft Entra ID pro ověření ke službě. Pokud používáte přístupové tokeny, přečtěte si článek Správa přístupových tokenů

POZNÁMKA: Pokud chcete používat Azure Playwright v kanálech CI, musíte nakonfigurovat ověřování pomocí služby z kanálu, viz Nastavení průběžného kompletního testování v různých prohlížečích a operačních systémech.

Spuštění testů

Spusťte testy Playwright v prohlížečích spravovaných službou pomocí konfigurace, kterou jste vytvořili výše.

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

Další kroky

• Spusťte testy v kanálu CI/CD.

• Naučte se spravovat přístup k vytvořenému pracovnímu prostoru.

• Experimentujte s různým počtem pracovních procesů, abyste určili optimální konfiguraci testovací sady.

Contributing

Tento projekt vítá příspěvky a podněty. Většina příspěvků vyžaduje, abyste souhlasili s licenční smlouvou pro přispěvatele (CLA), která prohlašuje, že máte právo nám udělit práva k použití vašeho příspěvku a skutečně je udělujete. Podrobnosti najdete na adrese https://cla.opensource.microsoft.com.

Když odešlete žádost o přijetí změn, robot CLA automaticky určí, zda je třeba poskytnout smlouvu CLA, a vhodně ozdobí žádost o přijetí změn (např. kontrola stavu, komentář). Jednoduše postupujte podle pokynů robota. Budete to muset udělat pouze jednou ve všech úložištích pomocí našeho programu CLA.

Tento projekt přijal Kodex chování Microsoft Open Source. Další informace naleznete v nejčastějších dotazech ke kodexu chování nebo nás kontaktujte opencode@microsoft.com s dalšími dotazy či připomínkami.

Ochranné známky

Tento projekt může obsahovat ochranné známky nebo loga pro projekty, produkty nebo služby. Autorizované použití ochranných známek nebo log společnosti Microsoft podléhá Pravidlům společnosti Microsoft pro ochranné známky a značky a musí se jimi řídit. Použití ochranných známek nebo log společnosti Microsoft v upravených verzích tohoto projektu nesmí způsobovat záměnu ani naznačovat sponzorství společnosti Microsoft. Jakékoli použití ochranných známek nebo log třetích stran podléhá zásadám těchto třetích stran.