Dramaturgo Azure

O Azure Playwright é um serviço do Azure totalmente gerenciado que usa a nuvem para permitir que você execute testes de Playwright com paralelização muito maior em diferentes combinações de sistema operacional e navegador simultaneamente. Isso significa execuções de teste mais rápidas com uma cobertura de cenário mais ampla, o que ajuda a acelerar a entrega de recursos sem sacrificar a qualidade. O serviço inclui também capacidades integradas de relatórios que carregam automaticamente os resultados dos testes e artefactos relacionados para o armazenamento Azure e visualizam-nos no portal de serviço, permitindo uma resolução de problemas mais rápida e fácil. Com o Playwright Workspaces, pode lançar funcionalidades de forma mais rápida e confiante.

Pronto para começar? Entre no nosso guia de início rápido!

Ligações úteis

Começar

Siga estas etapas para executar seu pacote de teste Playwright existente com o serviço.

Pré-requisitos

Uma conta do Azure com uma assinatura ativa. Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.
Sua conta do Azure deve receber o Proprietário, Colaborador ou uma das funções clássicas de administrador.
A CLI do Azure deve ser instalada na máquina de onde você está executando testes de Playwright.

Criar um espaço de trabalho

Entre no portal do Azure com sua conta do Azure.

Crie o espaço de trabalho.

Selecione o botão de menu no canto superior esquerdo do portal e, em seguida, selecione Criar um recurso.
Insira Playwright Workspaces na caixa de pesquisa.
Selecione o cartão Playwright Workspaces e, em seguida, selecione Criar.

Forneça as seguintes informações para configurar um novo espaço de trabalho Playwright:

Campo	Description
Subscription	Selecione a assinatura do Azure que você deseja usar para este espaço de trabalho Playwright.
Grupo de recursos	Selecione um grupo de recursos existente. Ou selecione Criar novo e insira um nome exclusivo para o novo grupo de recursos.
Nome	Insira um nome exclusivo para identificar seu espaço de trabalho. O nome só pode consistir em caracteres alfanuméricos e ter um comprimento entre 3 e 64 caracteres.
Localização	Selecione uma localização geográfica para hospedar seu espaço de trabalho. Esse local também determina onde os resultados da execução do teste são armazenados.
Elaboração de Relatórios	O Toggle está definido como "Ativado" por defeito para permitir que os utilizadores guardem e visualizem os seus relatórios de testes a partir do Playwright Workspace. Se quiseres desativar a reportagem, alterna a definição para "Desativado".
Conta de armazenamento	Uma nova conta de armazenamento é criada e selecionada por defeito para armazenar os artefactos de reporte Playwright Workspaces. Para selecionar uma conta de armazenamento existente, selecione no menu suspenso ou clique em "Criar nova" para criar uma nova conta de armazenamento à sua escolha.

Observação

Opcionalmente, você pode configurar mais detalhes na guia Tags . As tags são pares nome/valor que permitem categorizar recursos e exibir o faturamento consolidado aplicando a mesma tag a vários recursos e grupos de recursos.

Depois de concluir a configuração do recurso, selecione Revisar + Criar.
Revise todas as definições de configuração e selecione Criar para iniciar a implantação do espaço de trabalho Playwright.
Quando o processo for concluído, uma mensagem de êxito da implantação será exibida.
Para exibir o novo espaço de trabalho, selecione Ir para recurso.

Instalar o pacote do Azure Playwright

Execute este comando para instalar o pacote de serviço
```
npm init @azure/playwright@latest
```

A instalação do pacote de serviço criará um arquivo de configuração de serviço chamado playwright.service.config.ts

A configuração do serviço serve para:

Direcione e autentique o Playwright para os espaços de trabalho do dramaturgo.
Adiciona os Playwright Workspaces a reportar à tua configuração.
Substitua os tempos limite para operações de serviço, se necessário.

Certifique-se de que o seu projeto utiliza @playwright/test a versão 1.47 ou superior.

Obter ponto de extremidade de região

No portal do Azure, copie o comando em Adicionar ponto de extremidade de região em sua configuração.

A URL do ponto de extremidade corresponde à região do espaço de trabalho. Você pode ver uma URL de ponto de extremidade diferente no portal do Azure, dependendo da região selecionada ao criar o espaço de trabalho.

Configurar ambiente

Certifique-se de que o PLAYWRIGHT_SERVICE_URL que você obteve na etapa anterior está disponível em seu ambiente.

Recomendamos o uso do dotenv módulo para gerenciar seu ambiente. Com dotenv você estará usando o .env arquivo para definir suas variáveis de ambiente.

Não se esqueça de adicionar .env arquivo ao seu .gitignore arquivo para não vazar seus segredos.

npm i --save-dev dotenv

arquivo .env

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

Configurar autenticação

Para executar seus testes de Playwright em seu espaço de trabalho do Azure Playwright, você precisa autenticar o cliente Playwright onde você está executando os testes com o serviço. Esta pode ser a sua máquina de desenvolvimento local ou máquina de CI.

O serviço oferece dois métodos de autenticação: ID do Microsoft Entra e Tokens de Acesso.

O Microsoft Entra ID usa suas credenciais do Azure, exigindo uma entrada em sua conta do Azure para acesso seguro. Como alternativa, você pode gerar um token de acesso a partir do seu espaço de trabalho Playwright e usá-lo em sua configuração.

Configurar a autenticação usando o Microsoft Entra ID

Microsoft Entra ID é a autenticação padrão e recomendada para o serviço. Em sua máquina de desenvolvimento local, você pode usar da CLI do Azure para entrar

az login

NOTA: Se fizer parte de vários inquilinos do Microsoft Entra, certifique-se de que inicia sessão no inquilino a que pertence a sua área de trabalho. Você pode obter a ID do locatário no portal do Azure, consulte Localizar seu locatário do Microsoft Entra. Depois de obter o ID, inicie sessão utilizando o comando az login --tenant <TenantID>

Configurar a autenticação usando tokens de acesso

Você pode gerar um token de acesso do seu espaço de trabalho do Azure Playwright e usá-lo em sua configuração. No entanto, recomendamos vivamente o Microsoft Entra ID para autenticação devido à sua segurança melhorada. Os tokens de acesso, embora convenientes, funcionam como senhas de longa duração e são mais suscetíveis a serem comprometidos.

Para usar a autenticação baseada em token de acesso, habilite a autenticação baseada em token de acesso
Configurar a autenticação usando tokens de acesso

É altamente recomendável usar o Microsoft Entra ID para autenticação no serviço. Se você estiver usando tokens de acesso, consulte Como gerenciar tokens de acesso

OBSERVAÇÃO: Para usar o Azure Playwright em pipelines de CI, você precisa configurar a autenticação com o serviço do pipeline, consulte configurar testes contínuos de ponta a ponta em diferentes navegadores e sistemas operacionais

Executar os testes

Execute testes de Playwright em navegadores gerenciados pelo serviço usando a configuração que você criou acima.

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

Azure Playwright Reporter

O Azure Playwright inclui um repórter personalizado que carrega automaticamente os seus relatórios de teste HTML do Playwright para o Azure Storage, tornando-os acessíveis diretamente através do portal Azure para facilitar a depuração e partilha de resultados.

Caraterísticas

Carregamento Automático de Relatórios: Carrega de forma fluida os relatórios HTML do Playwright para a sua conta Azure Storage
Integração com o Portal: Veja os resultados dos testes diretamente no portal Azure Playwright
Depuração Melhorada: Aceder a artefactos de teste detalhados, vestígios e capturas de ecrã

Configuração e Configuração

O repórter Azure Playwright está incluído no @azure/playwright pacote e funciona em conjunto com o repórter HTML incorporado da Playwright.

1. Configurar repórteres na Playwright Config

Adicione tanto o repórter HTML como o repórter Azure Playwright ao seu playwright.service.config.ts:

import { getServiceConfig, PlaywrightReporter } from "@azure/playwright";
import { defineConfig } from "@playwright/test";
import { DefaultAzureCredential } from "@azure/identity";

// <snippet_configure_reporters>
import { getServiceConfig, PlaywrightReporter } from "@azure/playwright";
import { defineConfig } from "@playwright/test";
import { DefaultAzureCredential } from "@azure/identity";
export default defineConfig(
  getServiceConfig({
    // Your existing configuration
    credential: new DefaultAzureCredential(),
  }),
  {
    reporter: [
      ["html", { open: "never" }], // HTML reporter must come first
      ["@azure/playwright/reporter"], // Azure reporter uploads HTML report
    ],
  },
);

2. Pré-requisitos para o Relatório

Antes de usar o Azure Playwright Reporter, certifique-se de que o seu espaço de trabalho está devidamente configurado:

Configuração de Área de Trabalho

Ativar Relatórios e Configurar Armazenamento:

Vai ao teu Playwright Workspace no portal Azure
Navegue até ao separador de configuração de armazenamento
Alternar o Relatório para Ativado
Criar uma nova conta de armazenamento ou selecionar uma conta de armazenamento existente
Clique em Salvar

Configure RBAC para Acesso ao Armazenamento:

Abra a conta de armazenamento ligada
Ir ao separador de Controlo de Acesso (IAM)
Clique em Adicionar atribuição de função
Procure e selecione o papel de Contribuidor de Dados de Blob de Armazenamento , depois clique em Seguinte
Selecione e adicione todos os membros que irão realizar testes
Clique em Rever + atribuir

Configure o CORS para o Trace Viewer:

Abra a conta de armazenamento ligada
Ir a Definições → Partilha de Recursos (CORS)
Em serviço Blob, adicione um novo registo:
- Origens permitidas: https://trace.playwright.dev
- Métodos permitidos: GET, OPTIONS
- Idade máxima: Introduza um valor entre 0 e 2147483647
Clique em Salvar

Requisitos do Cliente

Autenticação: É necessária a autenticação Microsoft Entra ID (tokens de acesso não são suportados para relatórios)
Versão de Dramaturgo: Requer a versão de Dramaturgo 1.57 ou superior
Configuração do Serviço: Deve usar a configuração do serviço (playwright.service.config.ts)
Definições do Espaço de Trabalho: O relatório deve estar ativado no seu espaço de trabalho Azure Playwright

Como funciona

Execução de Testes: Os testes correm normalmente usando navegadores de serviços Azure Playwright
Geração de Relatórios HTML: O repórter HTML do Playwright gera o relatório de teste padrão
Upload Automático: O Azure Reporter carrega a pasta do relatório HTML para o Azure Storage do seu espaço de trabalho
Acesso ao Portal: Consulte os resultados no portal Azure através do URL fornecido

Próximos passos

Execute testes em um pipeline de CI/CD.
Saiba como gerenciar o acesso ao espaço de trabalho criado.
Experimente com diferentes números de trabalhadores para determinar a configuração ideal do seu conjunto de testes.

Contributing

Este projeto acolhe contribuições e sugestões. A maioria das contribuições exige que você concorde com um Contrato de Licença de Colaborador (CLA) declarando que você tem o direito de, e realmente concede, os direitos de usar sua contribuição. Para mais detalhes, visite https://cla.opensource.microsoft.com.

Quando você envia uma solicitação pull, um bot CLA determinará automaticamente se você precisa fornecer um CLA e decorar o PR adequadamente (por exemplo, verificação de status, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios usando nosso CLA.

Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para obter mais informações, consulte as Perguntas frequentes sobre o Código de Conduta ou entre em contato opencode@microsoft.com com quaisquer perguntas ou comentários adicionais.

Marcas comerciais

Este projeto pode conter marcas comerciais ou logotipos para projetos, produtos ou serviços. O uso autorizado de marcas comerciais ou logotipos da Microsoft está sujeito e deve seguir as Diretrizes de Marcas Comerciais e Marcas da Microsoft. O uso de marcas comerciais ou logotipos da Microsoft em versões modificadas deste projeto não deve causar confusão ou implicar patrocínio da Microsoft. Qualquer uso de marcas comerciais ou logotipos de terceiros está sujeito às políticas desses terceiros.

Feedback

Esta página foi útil?

Last updated on 2026-01-28