Лазурный драматург

Azure Playwright — это полностью управляемая служба Azure, которая использует облако для одновременного выполнения тестов Playwright с гораздо более высокой степенью распараллеливания в различных комбинациях операционной системы и браузера. Это означает более быстрые тестовые запуски с более широким охватом сценариев, что помогает ускорить доставку функций без ущерба для качества. С помощью рабочих пространств Playwright вы можете выпускать функции быстрее и увереннее.

Готовы приступить к работе? Ознакомьтесь с нашим кратким руководством!

Полезные ссылки

• Краткое руководство: выполнение комплексных тестов в большом масштабе
• Краткое руководство: настройка непрерывного сквозного тестирования в различных браузерах и операционных системах
• Узнайте о функциях и преимуществах
• Документация
• Цены
• Поделиться отзывом

Get Started

Выполните следующие действия, чтобы запустить существующий набор тестов Playwright с помощью службы.

Предпосылки

• Учетная запись Azure с активной подпиской. Если у вас нет подписки Azure, создайте бесплатную учетную запись перед началом работы.
• Вашей учетной записи Azure должна быть назначена роль владельца, участника или одна из классических ролей администратора.
• Azure CLI должен быть установлен на компьютере, с которого вы запускаете тесты Playwright.

Создание рабочего пространства

1. Войдите на портал Azure с помощью своей учетной записи Azure.

2. Создайте рабочую область.

   • Нажмите кнопку меню в левом верхнем углу портала, а затем выберите Создать ресурс.

     

   • Введите Playwright Workspaces в поле поиска.

   • Выберите карточку «Рабочие пространства драматурга », а затем нажмите кнопку «Создать».

     

   • Предоставьте следующие сведения для настройки нового рабочего пространства Playwright:

     Поле	Description
     Subscription	Выберите подписку Azure, которую вы хотите использовать для этой рабочей области Playwright.
     Группа ресурсов	Выберите существующую группу ресурсов. Или выберите Create new и введите уникальное имя для новой группы ресурсов.
     Имя	Введите уникальное имя для идентификации рабочей области. Имя может состоять только из буквенно-цифровых символов и иметь длину от 3 до 64 символов.
     Местоположение	Выберите географическое расположение для размещения рабочей области. Это расположение также определяет, где хранятся результаты выполнения теста.

     Замечание

     По желанию, вы можете настроить дополнительные параметры на вкладке Теги. Теги — это пары имя/значение, которые позволяют вам классифицировать ресурсы и просматривать консолидированный биллинг, применяя один и тот же тег к нескольким ресурсам и группам ресурсов.

   • После того как вы закончите настройку ресурса, выберите Проверить + Создать.

   • Просмотрите все параметры конфигурации и нажмите кнопку Создать , чтобы начать развертывание рабочей области Playwright.

   • По завершении процесса появится сообщение об успешном развертывании.

   • Чтобы просмотреть новую рабочую область, выберите Перейти к ресурсу.

     

Установка пакета Azure Playwright

1. Выполните эту команду для установки пакета услуг

   npm init @azure/playwright
   

При установке пакета услуг будет создан файл конфигурации службы с именем playwright.service.config.ts

Конфигурация сервиса предназначена для:

• Направляйте и аутентифицируйте Playwright в рабочих пространствах Playwright.
• При необходимости переопределите тайм-ауты для операций службы.

Убедитесь, что в вашем проекте используется @playwright/test версия 1.47 или выше.

Получение конечной точки региона

1. На портале Azure скопируйте команду в разделе Добавить конечную точку региона в настройках.

   

   URL-адрес конечной точки соответствует области рабочей области. Вы можете увидеть другой URL-адрес конечной точки на портале Azure в зависимости от региона, выбранного при создании рабочей области.

Настройка среды

Убедитесь, что информация PLAYWRIGHT_SERVICE_URL , полученная на предыдущем шаге, доступна в вашей среде.

Мы рекомендуем использовать dotenv модуль для управления вашей средой. С dotenv помощью вы будете использовать .env файл для определения переменных среды.

Не забудьте добавить .env файл в свой .gitignore файл, чтобы не допустить утечки ваших секретов.

npm i --save-dev dotenv

Файл .env

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

Настройка проверки подлинности

Чтобы выполнить тесты Playwright в рабочей области Azure Playwright, необходимо пройти проверку подлинности клиента Playwright, в котором вы проводите тесты, с помощью службы. Это может быть локальный компьютер разработки или компьютер CI.

Служба предлагает два метода проверки подлинности: идентификатор Microsoft Entra и маркеры доступа.

Идентификатор Microsoft Entra использует учетные данные Azure, требуя входа в учетную запись Azure для безопасного доступа. Кроме того, вы можете создать маркер доступа из рабочей области Playwright и использовать его в настройке.

Настройка авторизации с помощью Microsoft Entra ID

Идентификатор Microsoft Entra — это идентификатор по умолчанию и рекомендуемая проверка подлинности для службы. На локальном компьютере разработки можно использовать Azure CLI для входа.

az login

ПРИМЕЧАНИЕ: Если вы являетесь участником нескольких клиентов Microsoft Entra, убедитесь, что вы вошли в клиент, к которому принадлежит ваша рабочая область. Идентификатор клиента можно получить на портале Azure, см. статью Поиск клиента Microsoft Entra. После получения идентификатора выполните вход с помощью команды az login --tenant <TenantID>

Настройка проверки подлинности с помощью токенов доступа

Вы можете создать маркер доступа из рабочей области Azure Playwright и использовать его в настройке. Однако настоятельно рекомендуется использовать идентификатор Microsoft Entra для проверки подлинности из-за повышенной безопасности. Маркеры доступа, хотя и удобны, действуют как долговременные пароли и более подвержены компрометации.

1. Чтобы использовать проверку подлинности на основе маркера доступа, включите проверку подлинности на основе маркера доступа

2. Настройка аутентификации с помощью токенов доступа

Настоятельно рекомендуется использовать идентификатор Microsoft Entra для проверки подлинности в службе. Если вы используете маркеры доступа, см. раздел Управление маркерами доступа

ЗАМЕТКА: Чтобы использовать Azure Playwright в конвейерах CI, необходимо настроить проверку подлинности с помощью службы из конвейера, см. раздел Настройка непрерывного сквозного тестирования в разных браузерах и операционных системах

Запуск тестов

Запустите тесты Playwright для браузеров, управляемых службой, с помощью конфигурации, созданной выше.

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

Дальнейшие шаги

• Выполняйте тесты в конвейере CI/CD.

• Узнайте, как управлять доступом к созданному рабочему пространству.

• Экспериментируйте с разным количеством рабочих процессов, чтобы определить оптимальную конфигурацию вашего набора тестов.

Contributing

Этот проект приветствует вклады и предложения. Для большинства вкладов требуется согласие с Лицензионным соглашением для авторов (CLA), в котором говорится, что вы имеете право предоставлять нам права на использование вашего вклада и фактически предоставляете их. Для получения подробных сведений посетите веб-страницу https://cla.opensource.microsoft.com.

Когда вы отправляете запрос на вытягивание, бот CLA автоматически определяет, нужно ли вам предоставлять CLA и соответствующим образом оформлять PR (например, проверять статус, комментировать). Просто следуйте инструкциям, предоставленным ботом. Вам нужно будет сделать это только один раз во всех репозиториях с помощью нашего CLA.

В рамках этого проекта был принят Кодекс поведения Microsoft с открытым исходным кодом. Для получения дополнительной информации ознакомьтесь с часто задаваемыми вопросами о Кодексе поведения или свяжитесь с opencode@microsoft.com любыми дополнительными вопросами или комментариями.

Товарные знаки

Этот проект может содержать товарные знаки или логотипы для проектов, продуктов или услуг. Разрешенное использование товарных знаков или логотипов Microsoft регулируется Рекомендациями по товарным знакам и фирменной символике Microsoft и должно соответствовать им. Использование товарных знаков или логотипов Microsoft в модифицированных версиях этого проекта не должно вызывать путаницу или подразумевать спонсорство Microsoft. Любое использование товарных знаков или логотипов третьих лиц регулируется политикой этих третьих сторон.