Penulis Drama Azure

Azure Playwright adalah layanan Azure yang dikelola sepenuhnya yang menggunakan cloud untuk memungkinkan Anda menjalankan pengujian Playwright dengan paralelisasi yang jauh lebih tinggi di berbagai kombinasi sistem-browser operasi secara bersamaan. Ini berarti uji coba lebih cepat dengan cakupan skenario yang lebih luas, yang membantu mempercepat pengiriman fitur tanpa mengorbankan kualitas. Layanan ini juga menyertakan kemampuan pelaporan terintegrasi yang secara otomatis mengunggah hasil pengujian dan artefak terkait ke penyimpanan Azure dan melihatnya di portal layanan, memungkinkan pemecahan masalah yang lebih cepat dan lebih mudah. Dengan Playwright Workspaces, Anda dapat merilis fitur dengan lebih cepat dan lebih percaya diri.

Siap untuk memulai? Masuk ke panduan memulai cepat kami!

Tautan yang Berguna

• Mulai cepat: Menjalankan pengujian menyeluruh dalam skala besar
• Mulai cepat: Menyiapkan pengujian menyeluruh berkelanjutan di berbagai browser dan sistem operasi
• Jelajahi fitur dan manfaat
• Dokumentasi
• Penetapan Harga
• Bagikan umpan balik

Mulai

Ikuti langkah-langkah ini untuk menjalankan rangkaian pengujian Playwright yang ada dengan layanan ini.

Prasyarat

• Sebuah akun Azure dengan langganan aktif. Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.
• Akun Azure Anda harus diberi peran Pemilik, Kontributor, atau salah satu peran administrator klasik.
• Azure CLI harus diinstal di komputer tempat Anda menjalankan pengujian Playwright.

Membuat Ruang Kerja

1. Masuk ke portal Azure dengan akun Azure Anda.

2. Buat Ruang Kerja.

   • Pilih tombol menu di sudut kiri atas portal, lalu pilih Buat sumber daya.

     

   • Masukkan Ruang Kerja Playwright di kotak pencarian.

   • Pilih kartu Ruang Kerja Playwright , lalu pilih Buat.

     

   • Berikan informasi berikut untuk mengonfigurasi ruang kerja Playwright baru:

     Bidang	Description
     Subscription	Pilih langganan Azure yang ingin Anda gunakan untuk ruang kerja Playwright ini.
     grup Sumber Daya	Memilih grup sumber daya yang sudah ada. Atau pilih Buat baru, lalu masukkan nama unik untuk grup sumber daya baru.
     Nama	Masukkan nama unik untuk mengidentifikasi ruang kerja Anda. Nama hanya dapat terdiri dari karakter alfanumerik, dan memiliki panjang antara 3 dan 64 karakter.
     Tempat	Pilih lokasi geografis untuk menghosting ruang kerja Anda. Lokasi ini juga menentukan di mana hasil eksekusi pengujian disimpan.
     Pelaporan	Toggle diatur ke "Diaktifkan" secara default untuk memungkinkan pengguna menyimpan dan melihat laporan uji coba mereka dari Playwright Workspace. Jika Anda ingin menonaktifkan pelaporan, alihkan pengaturan ke "Dinonaktifkan".
     Akun penyimpanan	Akun penyimpanan baru dibuat dan dipilih secara default untuk menyimpan artefak pelaporan Ruang Kerja Penulis Drama. Untuk memilih akun penyimpanan yang ada, pilih dari dropdown atau klik "Buat baru" untuk membuat akun penyimpanan baru pilihan Anda.

     Nota

     Secara opsional, Anda dapat mengonfigurasi detail lebih lanjut pada tab Tag . Tag adalah pasangan nama/nilai yang memungkinkan Anda mengategorikan sumber daya dan melihat penagihan terkonsolidasi dengan menerapkan tag yang sama ke beberapa sumber daya dan grup sumber daya.

   • Setelah selesai mengonfigurasi sumber daya, pilih Tinjau + Buat.

   • Tinjau semua pengaturan konfigurasi dan pilih Buat untuk memulai penyebaran ruang kerja Playwright.

   • Setelah proses selesai, pesan keberhasilan penyebaran muncul.

   • Untuk melihat ruang kerja baru, pilih Buka sumber daya.

     

Menginstal paket Azure Playwright

1. Jalankan perintah ini untuk menginstal paket layanan

   npm init @azure/playwright@latest
   

Menginstal paket layanan akan membuat file konfigurasi layanan bernama playwright.service.config.ts

Konfigurasi layanan berfungsi untuk:

• Arahkan dan autentikasi Playwright ke Ruang Kerja Playwright.
• Tambahkan pelaporan Ruang Kerja Playwright ke konfigurasi Anda.
• Ganti batas waktu untuk operasi layanan, jika diperlukan.

Pastikan project Anda menggunakan @playwright/test versi 1.47 atau yang lebih tinggi.

Mendapatkan titik akhir wilayah

1. Di portal Microsoft Azure, salin perintah di bawah Tambahkan titik akhir wilayah di penyiapan Anda.

   

   URL titik akhir sesuai dengan wilayah ruang kerja. Anda mungkin melihat URL titik akhir yang berbeda di portal Microsoft Azure, tergantung pada wilayah yang Anda pilih saat membuat ruang kerja.

Menyiapkan lingkungan kerja

Pastikan bahwa yang PLAYWRIGHT_SERVICE_URL Anda peroleh pada langkah sebelumnya tersedia di lingkungan Anda.

Kami merekomendasikan untuk menggunakan dotenv modul untuk mengelola lingkungan Anda. Dengan dotenv Anda akan menggunakan .env file untuk menentukan variabel lingkungan Anda.

Jangan lupa untuk menambahkan .env file ke file Anda .gitignore agar tidak membocorkan rahasia Anda.

npm i --save-dev dotenv

File .env

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

Menyiapkan Autentikasi

Untuk menjalankan pengujian Playwright di ruang kerja Azure Playwright, Anda perlu mengautentikasi klien Playwright tempat Anda menjalankan pengujian dengan layanan. Ini bisa menjadi mesin dev lokal atau mesin CI Anda.

Layanan ini menawarkan dua metode autentikasi: ID Microsoft Entra dan Token Akses.

ID Microsoft Entra menggunakan kredensial Azure Anda, memerlukan masuk ke akun Azure Anda untuk akses yang aman. Atau, Anda dapat menghasilkan token akses dari ruang kerja Playwright dan menggunakannya dalam penyiapan Anda.

Menyiapkan otentikasi menggunakan Microsoft Entra ID

ID Microsoft Entra adalah autentikasi default dan direkomendasikan untuk layanan. Dari komputer dev lokal, Anda dapat menggunakan Azure CLI untuk masuk

az login

CATATAN: Jika Anda adalah bagian dari beberapa penyewa Microsoft Entra, pastikan Anda masuk ke penyewa tempat ruang kerja Anda berada. Anda bisa mendapatkan id penyewa dari portal Microsoft Azure, lihat Menemukan Penyewa Microsoft Entra Anda. Setelah Anda mendapatkan ID, masuk menggunakan perintah az login --tenant <TenantID>

Menyiapkan autentikasi menggunakan token akses

Anda dapat menghasilkan token akses dari ruang kerja Azure Playwright Anda dan menggunakannya dalam penyiapan Anda. Namun, kami sangat merekomendasikan ID Microsoft Entra untuk autentikasi karena keamanannya yang ditingkatkan. Token akses, meskipun nyaman, berfungsi seperti kata sandi berumur panjang dan lebih rentan disusupi.

1. Untuk menggunakan autentikasi berbasis token akses, Aktifkan autentikasi berbasis token akses

2. Menyiapkan autentikasi menggunakan token akses

Sebaiknya gunakan ID Microsoft Entra untuk autentikasi ke layanan. Jika Anda menggunakan token akses, lihat Cara Mengelola Token Akses

NOTA: Untuk menggunakan Azure Playwright di alur CI, Anda perlu mengonfigurasi autentikasi dengan layanan dari alur, lihat menyiapkan pengujian end-to-end berkelanjutan di berbagai browser dan sistem operasi

Jalankan pengujian

Jalankan pengujian Playwright terhadap browser yang dikelola oleh layanan menggunakan konfigurasi yang Anda buat di atas.

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

Reporter Penulis Drama Azure

Azure Playwright menyertakan pelapor kustom yang secara otomatis mengunggah laporan pengujian HTML Playwright Anda ke Azure Storage, membuatnya dapat diakses langsung melalui portal Microsoft Azure untuk penelusuran kesalahan dan berbagi hasil yang lebih mudah.

Features

• Unggahan Laporan Otomatis: Mengunggah laporan HTML Playwright dengan mulus ke akun Azure Storage Anda
• Integrasi Portal: Melihat hasil pengujian langsung di portal Azure Playwright
• Debugging yang Disempurnakan: Akses artefak pengujian terperinci, jejak, dan tangkapan layar

Penyiapan dan Konfigurasi

Reporter Azure Playwright disertakan dengan @azure/playwright paket dan bekerja bersama reporter HTML bawaan Playwright.

1. Konfigurasikan Reporter di Konfigurasi Playwright

Tambahkan reporter HTML dan reporter Azure Playwright ke 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. Prasyarat Pelaporan

Sebelum menggunakan reporter Azure Playwright, pastikan ruang kerja Anda dikonfigurasi dengan benar:

Konfigurasi Ruang Kerja

Aktifkan Pelaporan dan Konfigurasikan Penyimpanan:

1. Buka Ruang Kerja Playwright Anda di portal Microsoft Azure
2. Navigasikan ke tab Konfigurasi penyimpanan
3. Beralih Pelaporan ke Diaktifkan
4. Membuat akun penyimpanan baru atau pilih yang ada
5. Klik Simpan

Konfigurasikan RBAC untuk Akses Penyimpanan:

1. Buka akun penyimpanan yang ditautkan
2. Buka tab Kontrol Akses (IAM)
3. Klik Tambahkan penetapan peran
4. Cari dan pilih peran Kontributor Data Blob Penyimpanan , lalu klik Berikutnya
5. Pilih dan tambahkan semua anggota yang akan menjalankan pengujian
6. Klik Tinjau + tetapkan

Konfigurasikan CORS untuk Penampil Pelacakan:

1. Buka akun penyimpanan yang ditautkan
2. Buka Pengaturan → Berbagi sumber daya (CORS)
3. Di bawah Layanan Blob, tambahkan rekaman baru:
   • Asal yang diizinkan: https://trace.playwright.dev
   • Metode yang diizinkan: GET, OPTIONS
   • Usia maks: Masukkan nilai antara 0 dan 2147483647
4. Klik Simpan

Persyaratan Klien

• Autentikasi: Autentikasi ID Microsoft Entra diperlukan (token akses tidak didukung untuk pelaporan)
• Versi Penulis Drama: Memerlukan Penulis Drama versi 1.57 atau lebih tinggi
• Konfigurasi Layanan: Harus menggunakan konfigurasi layanan (playwright.service.config.ts)
• Pengaturan Ruang Kerja: Pelaporan harus diaktifkan di ruang kerja Azure Playwright Anda

Cara Kerjanya

1. Eksekusi Pengujian: Pengujian berjalan secara normal menggunakan browser layanan Azure Playwright
2. Pembuatan Laporan HTML: Reporter HTML penulis drama menghasilkan laporan pengujian standar
3. Unggahan Otomatis: Reporter Azure mengunggah folder laporan HTML ke Azure Storage ruang kerja Anda
4. Akses Portal: Lihat hasil di portal Microsoft Azure melalui URL yang disediakan

Langkah selanjutnya

• Jalankan pengujian dalam alur CI/CD.

• Pelajari cara mengelola akses ke ruang kerja yang dibuat.

• Bereksperimenlah dengan jumlah pekerja yang berbeda untuk menentukan konfigurasi optimal rangkaian pengujian Anda.

Contributing

Proyek ini menyambut kontribusi dan saran. Sebagian besar kontribusi mengharuskan Anda untuk menyetujui Perjanjian Lisensi Kontributor (KLA) yang menyatakan bahwa Anda memiliki hak untuk, dan benar-benar memiliki, memberi kami hak untuk menggunakan kontribusi Anda. Untuk detailnya, kunjungi https://cla.opensource.microsoft.com.

Saat Anda mengirimkan permintaan pull, bot CLA akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan mendekorasi PR dengan tepat (misalnya, pemeriksaan status, komentar). Cukup ikuti instruksi yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali di semua repositori menggunakan CLA kami.

Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi lebih lanjut, lihat FAQ Kode Etik atau hubungi opencode@microsoft.com dengan pertanyaan atau komentar tambahan.

Merek dagang

Proyek ini mungkin berisi merek dagang atau logo untuk proyek, produk, atau layanan. Penggunaan resmi merek dagang atau logo Microsoft tunduk pada dan harus mengikuti Pedoman Merek Dagang & Merek Microsoft. Penggunaan merek dagang atau logo Microsoft dalam versi modifikasi proyek ini tidak boleh menyebabkan kebingungan atau menyiratkan sponsor Microsoft. Setiap penggunaan merek dagang atau logo pihak ketiga tunduk pada kebijakan pihak ketiga tersebut.