Drammaturgo azzurro

Azure Playwright è un servizio di Azure completamente gestito che usa il cloud per consentire l'esecuzione di test di Playwright con una parallelizzazione molto più elevata tra diverse combinazioni di sistema operativo e browser contemporaneamente. Ciò significa esecuzioni di test più rapide con una copertura dello scenario più ampia, che aiuta a velocizzare la distribuzione delle funzionalità senza sacrificare la qualità. Con le aree di lavoro di Playwright, è possibile rilasciare le funzionalità in modo più rapido e sicuro.

Sei pronto per iniziare? Passa alla nostra guida rapida!

Link utili

• Guida introduttiva: Eseguire test end-to-end su larga scala
• Guida introduttiva: Configurare test end-to-end continui in diversi browser e sistemi operativi
• Esplora le caratteristiche e i vantaggi
• Documentazione
• Prezzi
• Condividi commenti

Get Started

Segui questi passaggi per eseguire la tua suite di test Playwright esistente con il servizio.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Se non si ha un abbonamento Azure, creare un account gratuito prima di iniziare.
• All'account Azure deve essere assegnato il ruolo di proprietario, collaboratore o uno dei ruoli di amministratore classico.
• L'interfaccia della riga di comando di Azure deve essere installata nel computer da cui si eseguono i test di Playwright.

Creare un'area di lavoro

1. Accedere al portale di Azure con l'account Azure.

2. Creare l'area di lavoro.

   • Selezionare il pulsante di menu nell'angolo superiore sinistro del portale e quindi selezionare Crea una risorsa.

     

   • Immettere Aree di lavoro Playwright nella casella di ricerca.

   • Selezionare la scheda Aree di lavoro Playwright, quindi selezionare Crea.

     

   • Fornire le informazioni seguenti per configurare una nuova area di lavoro Playwright:

     Campo	Description
     Subscription	Selezionare la sottoscrizione di Azure che si desidera utilizzare per questa area di lavoro di Playwright.
     Gruppo di risorse	Selezionare un gruppo di risorse esistente. In alternativa, selezionare Crea nuovo, quindi immettere un nome univoco per il nuovo gruppo di risorse.
     Nome	Immettere un nome univoco per identificare l'area di lavoro. Il nome può essere costituito solo da caratteri alfanumerici e deve essere di lunghezza compresa tra 3 e 64 caratteri.
     Ubicazione	Selezionare una posizione geografica per ospitare l'area di lavoro. Questa posizione determina anche la posizione in cui vengono archiviati i risultati dell'esecuzione dei test.

     Annotazioni

     Facoltativamente, è possibile configurare altri dettagli nella scheda Tag. I tag sono coppie nome-valore che consentono di classificare le risorse e visualizzare dati di fatturazione consolidati tramite l'applicazione dello stesso tag a più risorse e gruppi di risorse.

   • Dopo aver completato la configurazione della risorsa, selezionare Rivedi e crea.

   • Esaminare tutte le impostazioni di configurazione e selezionare Crea per avviare la distribuzione dell’area di lavoro Playwright.

   • Al termine del processo, viene visualizzato un messaggio di esito positivo della distribuzione.

   • Per visualizzare la nuova area di lavoro, selezionare Vai alla risorsa.

     

Installare il pacchetto Azure Playwright

1. Eseguire questo comando per installare il pacchetto del servizio

   npm init @azure/playwright
   

L'installazione del pacchetto del servizio creerà un file di configurazione del servizio denominato playwright.service.config.ts

La configurazione del servizio serve a:

• Indirizzare e autenticare il drammaturgo nelle aree di lavoro del drammaturgo.
• Eseguire l'override dei timeout per le operazioni del servizio, se necessario.

Assicurati che il tuo progetto utilizzi @playwright/test la versione 1.47 o successiva.

Ottenere l'endpoint dell'area

1. Nel portale di Azure copiare il comando in Aggiungi endpoint area nella configurazione.

   

   L'URL dell'endpoint corrisponde all'area dell'area di lavoro. È possibile che venga visualizzato un URL dell'endpoint diverso nel portale di Azure, a seconda dell'area selezionata durante la creazione dell'area di lavoro.

Set up environment (Configurare l'ambiente)

Assicurarsi che l'opzione PLAYWRIGHT_SERVICE_URL ottenuta nel passaggio precedente sia disponibile nell'ambiente in uso.

Si consiglia di utilizzare dotenv il modulo per gestire l'ambiente. Con dotenv utilizzerai il .env file per definire le tue variabili d'ambiente.

Non dimenticare di aggiungere .env file al tuo .gitignore file per non far trapelare i tuoi segreti.

npm i --save-dev dotenv

File .env

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

Configurare l'autenticazione

Per eseguire i test di Playwright nell'area di lavoro di Azure Playwright, è necessario autenticare il client di Playwright in cui si eseguono i test con il servizio. Potrebbe trattarsi del computer di sviluppo locale o del computer CI.

Il servizio offre due metodi di autenticazione: Microsoft Entra ID e token di accesso.

Microsoft Entra ID usa le credenziali di Azure, richiedendo il log-in all'account Azure per l'accesso sicuro. In alternativa, è possibile generare un token di accesso dall'area di lavoro Playwright e usarlo nella configurazione.

Configurare l'autenticazione utilizzando l'ID Microsoft Entra

Microsoft Entra ID è l'autenticazione predefinita e consigliata per il servizio. Dal computer di sviluppo locale è possibile usare l'interfaccia della riga di comando di Azure per accedere

az login

NOTA: se si fa parte di più tenant di Microsoft Entra, assicurarsi di accedere al tenant a cui appartiene l'area di lavoro. È possibile ottenere l'ID tenant dal portale di Azure, vedere Trovare il tenant di Microsoft Entra. Dopo aver visualizzato l'ID, accedere usando il comando az login --tenant <TenantID>

Configurare l'autenticazione tramite token di accesso

È possibile generare un token di accesso dall'area di lavoro di Azure Playwright e usarlo nella configurazione. Tuttavia, è consigliabile usare Microsoft Entra ID per l'autenticazione per la sua sicurezza avanzata. I token di accesso, sebbene siano pratici, funzionano come password di lunga durata e sono più soggetti a essere compromessi.

1. Per utilizzare l'autenticazione basata su token di accesso, abilitare l'autenticazione basata su token di accesso

2. Configurare l'autenticazione utilizzando i token di accesso

È consigliabile usare Microsoft Entra ID per l'autenticazione al servizio. Se si utilizzano token di accesso, vedere Come gestire i token di accesso

NOTA: Per usare Azure Playwright nelle pipeline CI, è necessario configurare l'autenticazione con il servizio dalla pipeline, vedere Configurare test end-to-end continui in diversi browser e sistemi operativi

Esegui i test

Eseguire test Playwright su browser gestiti dal servizio usando la configurazione creata in precedenza.

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

Passaggi successivi

• Eseguire test in una pipeline CI/CD.

• Scopri come gestire l'accesso all'area di lavoro creata.

• Sperimenta con un numero diverso di ruoli di lavoro per determinare la configurazione ottimale della tua suite di test.

Contributing

Questo progetto accoglie contributi e suggerimenti. La maggior parte dei contributi richiede l'accettazione di un Contratto di licenza per autori (CLA) che dichiari di avere il diritto di concederci i diritti di utilizzare il tuo contributo, e di fatto lo fa. Per informazioni dettagliate, vedere https://cla.opensource.microsoft.com.

Quando invii una richiesta pull, un bot CLA determinerà automaticamente se devi fornire un CLA e decorare la PR in modo appropriato (ad esempio, controllo dello stato, commento). Segui semplicemente le istruzioni fornite dal bot. Dovrai farlo una sola volta in tutti i repository utilizzando il nostro CLA.

Questo progetto ha adottato il Codice di condotta Microsoft Open Source. Per ulteriori informazioni, consultare le FAQ del Codice di condotta o contattare opencode@microsoft.com per ulteriori domande o commenti.

Marchi

Questo progetto può contenere marchi o loghi per progetti, prodotti o servizi. L'uso autorizzato dei marchi o dei loghi Microsoft è soggetto e deve seguire le Linee guida per i marchi e il marchio di Microsoft. L'uso di marchi o loghi Microsoft nelle versioni modificate di questo progetto non deve causare confusione o implicare la sponsorizzazione di Microsoft. Qualsiasi utilizzo di marchi o loghi di terze parti è soggetto alle politiche di tali terze parti.