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. Dengan ruang kerja Playwright, 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.

     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
   

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

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.