다음을 통해 공유

Azure Playwright

Azure Playwright는 클라우드를 사용하여 다양한 운영 체제-브라우저 조합에서 동시에 훨씬 더 높은 병렬화로 Playwright 테스트를 실행할 수 있는 완전 관리형 Azure 서비스입니다. 즉, 더 넓은 시나리오 적용 범위로 더 빠른 테스트 실행을 의미하며, 이를 통해 품질 저하 없이 기능 제공 속도를 높일 수 있습니다. Playwright 작업 공간을 사용하면 기능을 더 빠르고 자신 있게 릴리스할 수 있습니다.

시작할 준비가 되셨나요? 빠른 시작 가이드로 이동하세요!

Get Started

다음 단계에 따라 서비스를 사용하여 기존 Playwright 테스트 스위트를 실행합니다.

필수 조건

작업 영역 만들기

  1. Azure 계정으로 Azure Portal 에 로그인합니다.

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

    • 포털의 왼쪽 위 모서리에 있는 메뉴 단추를 선택한 다음, 리소스 만들기를 선택합니다.

      Azure Portal에서 리소스 만들기

    • 검색창에 Playwright Workspaces 를 입력합니다.

    • Playwright 작업 영역 카드를 선택한 다음, 만들기를 선택합니다.

      Azure Marketplace에서 Playwright 작업 영역 검색

    • 새 Playwright 작업 영역을 구성하려면 다음 정보를 제공합니다.

      분야 Description
      Subscription 이 Playwright 작업 영역에 사용할 Azure 구독을 선택합니다.
      리소스 그룹 기존 리소스 그룹을 선택합니다. 또는 새로 만들기를 선택하고 새 리소스 그룹의 고유한 이름을 입력합니다.
      이름 작업 영역을 식별할 수 있는 고유한 이름을 입력합니다.
      이름은 영숫자로만 구성될 수 있으며 길이는 3자에서 64자 사이입니다.
      위치 작업 영역을 호스팅할 지리적 위치를 선택합니다.
      이 위치는 테스트 실행 결과가 저장되는 위치도 결정합니다.

      비고

      필요에 따라 태그 탭에서 세부 정보를 구성할 수 있습니다. 태그는 동일한 태그를 여러 개의 리소스 및 리소스 그룹에 적용하여 리소스를 범주화하고 통합된 청구를 볼 수 있는 이름/값 쌍입니다.

    • 리소스 구성을 마쳤으면 검토 + 만들기를 선택합니다.

    • 모든 구성 설정을 검토하고 만들기 를 선택하여 Playwright 작업 영역의 배포를 시작합니다.

    • 프로세스가 완료되면 배포 성공 메시지가 표시됩니다.

    • 새 작업 영역을 보려면 리소스로 이동을 선택합니다.

      배포 완료 - 리소스로 이동

Azure Playwright 패키지 설치

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

    npm init @azure/playwright

서비스 패키지를 설치하면 playwright.service.config.ts

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

  • Playwright를 Playwright 작업 공간으로 안내하고 인증합니다.
  • 필요한 경우 서비스 작업에 대한 시간 제한을 재정의합니다.

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

지역 엔드포인트 가져오기

  1. Azure Portal에서 설정의 지역 엔드포인트 추가 아래에 있는 명령을 복사합니다.

    작업 영역 엔드포인트 설정

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

환경 설정

이전 단계에서 얻은 것이 PLAYWRIGHT_SERVICE_URL 사용자 환경에서 사용 가능한지 확인하십시오.

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

비밀이 유출되지 않도록 파일에 파일을 .gitignore 추가하는 .env 것을 잊지 마십시오.

npm i --save-dev dotenv

.env 파일

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

인증 설정

Azure Playwright 작업 영역에서 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>을(를) 사용하여 로그인합니다.

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

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

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

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

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

메모: CI 파이프라인에서 Azure Playwright를 사용하려면 파이프라인에서 서비스를 사용하여 인증을 구성해야 하며, 다양한 브라우저 및 운영 체제에서 지속적인 엔드투엔드 테스트 설정을 참조하세요.

테스트 실행

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

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

다음 단계

Contributing

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

풀 리퀘스트를 제출하면 CLA 봇이 CLA를 제공하고 PR을 적절하게 장식해야 하는지 여부를 자동으로 결정합니다(예: 상태 확인, 댓글). 봇이 제공하는 지침을 따르기만 하면 됩니다. CLA를 사용하여 모든 리포지토리에서 이 작업을 한 번만 수행하면 됩니다.

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

상표

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

  • Last updated on