다음을 통해 공유


Microsoft Playwright Testing 미리 보기

Microsoft Playwright Testing은 클라우드를 사용하여 여러 운영 체제 브라우저 조합에서 훨씬 더 높은 병렬 처리로 Playwright 테스트를 동시에 실행할 수 있도록 하는 완전히 관리되는 Azure 서비스입니다. 즉, 더 광범위한 시나리오 검사로 더 빠른 테스트가 실행되므로 품질을 저하시키지 않고 기능 배달 속도를 높일 수 있습니다. 또한 이 서비스를 사용하면 테스트 결과 및 관련 아티팩트도 서비스에 게시하고 서비스 포털에서 볼 수 있으므로 더 빠르고 쉽게 문제를 해결할 수 있습니다. Microsoft Playwright Testing 서비스를 사용하면 기능을 더 빠르고 자신 있게 릴리스할 수 있습니다.

시작할 준비가 되셨나요? 빠른 시작 가이드로 이동합니다.

시작

서비스를 사용하여 기존 Playwright 테스트 제품군을 실행하려면 다음 단계를 수행합니다.

필수 구성 요소

  • 활성 구독이 있는 Azure 계정입니다. Azure 구독이 없는 경우 시작하기 전에 무료 계정 만들 있습니다.
  • Azure 계정에는 소유자, 기여자또는클래식 관리자 역할 중 하나가 할당되어야 합니다.
  • Azure CLI Playwright 테스트를 실행하는 컴퓨터에 설치해야 합니다.

작업 영역 만들기

  1. Azure 계정으로 Playwright 포털 로그인합니다.

  2. 작업 영역을 만듭니다.

    새 작업 영역 만들기

    묘사
    작업 영역 이름 작업 영역을 식별하는 고유한 이름입니다.
    이름에 특수 문자 또는 공백을 포함할 수 없습니다.
    Azure 구독 작업 영역을 만들 Azure 구독을 선택합니다.
    지역 여기서 테스트 실행 데이터는 작업 영역에 대해 저장됩니다.

이 화면이 표시되지 않으면 기존 작업 영역을 선택하고 다음 섹션으로 이동합니다.

Microsoft Playwright 테스트 패키지 설치

  1. 이 명령을 실행하여 서비스 패키지 설치

    npm init @azure/microsoft-playwright-testing
    

서비스 패키지를 설치하면 playwright.service.config.ts이라는 서비스 구성 파일이 생성됩니다.

서비스 구성은 다음을 수행합니다.

  • Microsoft Playwright Testing 서비스에 대한 직접 및 인증 극작가.
  • 구성에 Microsoft Playwright Testing 보고를 추가합니다.
  • 필요한 경우 서비스 작업에 대한 시간 제한을 재정의합니다.

프로젝트에서 @playwright/test 버전 1.47 이상을 사용하는지 확인합니다.

지역 엔드포인트 가져오기

  1. Playwright 포털설정지역 엔드포인트 추가에서 명령을 복사합니다.

    작업 영역 엔드포인트 설정

    엔드포인트 URL은 작업 영역 지역에 해당합니다. 작업 영역을 만들 때 선택한 지역에 따라 Playwright 포털에 다른 엔드포인트 URL이 표시될 수 있습니다.

환경 설정

이전 단계에서 얻은 PLAYWRIGHT_SERVICE_URL 사용자 환경에서 사용할 수 있는지 확인합니다.

dotenv 모듈을 사용하여 환경을 관리하는 것이 좋습니다. dotenv .env 파일을 사용하여 환경 변수를 정의합니다.

비밀을 유출하지 않으려면 .env 파일을 .gitignore 파일에 추가하는 것을 잊지 마세요.

npm i --save-dev dotenv

.env 파일

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

인증 설정

Microsoft Playwright Testing 작업 영역에서 Playwright 테스트를 실행하려면 서비스를 사용하여 테스트를 실행하는 경우 Playwright 클라이언트를 인증해야 합니다. 로컬 개발 머신 또는 CI 머신일 수 있습니다.

이 서비스는 두 가지 인증 방법인 Microsoft Entra ID 및 액세스 토큰을 제공합니다.

Microsoft Entra ID는 Azure 자격 증명을 사용하여 보안 액세스를 위해 Azure 계정에 로그인해야 합니다. 또는 Playwright 작업 영역에서 액세스 토큰을 생성하고 설정에서 사용할 수 있습니다.

Microsoft Entra ID를 사용하여 인증 설정

Microsoft Entra ID는 서비스에 대한 기본 및 권장 인증입니다. 로컬 개발 머신에서 Azure CLI 사용하여 로그인할 수 있습니다.

az login

참고: 여러 Microsoft Entra 테넌트에 속한 경우 작업 영역이 속한 테넌트에 로그인해야 합니다. Azure Portal에서 테넌트 ID를 가져올 수 있습니다. Microsoft Entra 테넌트찾기를 참조하세요. ID를 가져오면 명령 az login --tenant <TenantID> 사용하여 로그인합니다.

액세스 토큰을 사용하여 인증 설정

Playwright Testing 작업 영역에서 액세스 토큰을 생성하고 설정에서 사용할 수 있습니다. 그러나 향상된 보안으로 인해 인증에 Microsoft Entra ID를 사용하는 것이 좋습니다. 액세스 토큰은 편리하지만 수명이 긴 암호처럼 작동하며 손상되기 쉽습니다.

  1. 액세스 토큰 기반 인증을 사용하려면 액세스 토큰 기반 인증 사용하도록 .

  2. 액세스 토큰을 사용하여 인증 설정

서비스에 대한 인증에 Microsoft Entra ID를 사용하는 것이 좋습니다. 액세스 토큰을 사용하는 경우 액세스 토큰을 관리하는 방법 참조하세요.

참고: CI 파이프라인에서 Microsoft Playwright Testing을 사용하려면 파이프라인에서 서비스로 인증을 구성해야 합니다. 여러 브라우저 및 운영 체제에서 연속 엔드 투 엔드 테스트 설정

테스트 실행

위에서 만든 구성을 사용하여 서비스에서 관리하는 브라우저에 대해 Playwright 테스트를 실행합니다.

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

다음 단계

기여

이 프로젝트는 기여와 제안을 환영합니다. 대부분의 기여는 귀하가 귀하의 기여를 사용할 권리를 부여할 권리가 있음을 선언하는 CLA(기여자 사용권 계약)에 동의해야 합니다. 자세한 내용은 https://cla.opensource.microsoft.com방문하세요.

끌어오기 요청을 제출하면 CLA 봇이 CLA를 제공하고 PR을 적절하게 데코레이팅해야 하는지 여부를 자동으로 결정합니다(예: 상태 확인, 주석). 봇에서 제공하는 지침을 따르기만 하면 됩니다. CLA를 사용하여 모든 리포지토리에서 한 번만 이 작업을 수행해야 합니다.

이 프로젝트는 Microsoft 오픈 소스 행동 강령채택했습니다. 자세한 내용은 행동 강령 FAQ 참조하거나 추가 질문이나 의견을 opencode@microsoft.com 문의하세요.

상표

이 프로젝트에는 프로젝트, 제품 또는 서비스에 대한 상표 또는 로고가 포함될 수 있습니다. Microsoft 상표 또는 로고의 권한 있는 사용은 Microsoft의 상표 & 브랜드 지침따라야 합니다. 이 프로젝트의 수정된 버전에서 Microsoft 상표 또는 로고를 사용하면 혼동을 일으키거나 Microsoft 스폰서쉽을 암시해서는 안 됩니다. 타사 상표 또는 로고의 사용은 해당 타사 정책의 적용을 받습니다.