Compartilhar via

Dramaturgo Azure

O Azure Playwright é um serviço do Azure totalmente gerenciado que usa a nuvem para permitir que você execute testes do 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 cobertura de cenário mais ampla, o que ajuda a acelerar a entrega de recursos sem sacrificar a qualidade. Com os espaços de trabalho do Dramaturgo, você pode liberar recursos com mais rapidez e confiança.

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

Introdução

Siga estas etapas para executar seu conjunto de testes Playwright existente com o serviço.

Pré-requisitos

Criar um espaço de trabalho

  1. Entre no portal do Azure com sua conta do Azure.

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

      Criar um recurso no portal do Azure

    • Insira Workspaces do Playwright na caixa de pesquisa.

    • Selecione o cartão Workspaces do Playwright e, em seguida, selecione Criar.

      Pesquisar espaços de trabalho do dramaturgo no Azure Marketplace

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

      Campo Description
      Subscription Selecione a assinatura do Azure que você deseja usar para este espaço de trabalho do Playwright.
      Grupo de recursos Selecione um grupo de recursos existente. Ou selecione Criar 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.
      Localidade Selecione um local geográfico para hospedar seu espaço de trabalho.
      Esse local também determina onde os resultados da execução do teste são armazenados.

      Observação

      Você também pode configurar mais detalhes na guia Marcas. As marcas são pares nome/valor que permitem categorizar recursos e exibir a cobrança consolidada por meio da aplicação da mesma marca a vários recursos e grupos de recursos.

    • Depois de concluir a configuração do recurso, clique em Examinar + Criar.

    • Revise todas as definições de configuração e selecione Criar para iniciar a implantação do espaço de trabalho do Playwright.

    • Quando o processo for finalizado, será exibida uma mensagem de êxito da implantação.

    • Para ver o novo ambiente de trabalho, selecione Ir para o recurso.

      Implantação concluída – Ir para o recurso

Instalar o pacote do Azure Playwright

  1. Execute este comando para instalar o pacote de serviço

    npm init @azure/playwright

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 dramaturgo para os espaços de trabalho do dramaturgo.
  • Substitua os tempos limite para operações de serviço, se necessário.

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

Obter ponto de extremidade da região

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

    Definir ponto de extremidade do workspace

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

Configurar o ambiente

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

Recomendamos o uso dotenv do módulo para gerenciar seu ambiente. Com dotenv você usará 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 a autenticação

Para executar os testes do Dramaturgo no workspace do Dramaturgo do Azure, você precisa autenticar o cliente do Dramaturgo em que está executando os testes com o serviço. Pode ser seu computador de desenvolvimento local ou computador de CI.

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

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

Configurar a autenticação usando a ID do Microsoft Entra

O Microsoft Entra ID é a autenticação padrão e recomendada para o serviço. Em seu computador de desenvolvimento local, você pode usar a CLI do Azure para entrar

az login

OBSERVAÇÃO: se você fizer parte de vários locatários do Microsoft Entra, certifique-se de entrar no locatário ao qual seu workspace pertence. Você pode obter a ID do locatário no portal do Azure, consulte Localizar seu locatário do Microsoft Entra. Depois de obter a ID, entre usando o comando az login --tenant <TenantID>

Configure a autenticação usando tokens de acesso

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

  1. Para usar a autenticação baseada em token de acesso, ative a autenticação baseada em token de acesso

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

NOTA: 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

Execute os testes

Execute testes do 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

Próximas etapas

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 nos concede, os direitos de usar sua contribuição. Para obter detalhes, visite https://cla.opensource.microsoft.com.

Quando você envia uma solicitação de pull, um bot CLA determinará automaticamente se você precisa fornecer um CLA e decorar a 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 Software Livre 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 registradas 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 Marca Registrada e Marca 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 registradas ou logotipos de terceiros está sujeito às políticas desses terceiros.

  • Last updated on