Aracılığıyla paylaş

Azure Oyun Yazarı

Azure Playwright, Playwright testlerini farklı işletim sistemi-tarayıcı birleşimleri arasında aynı anda çok daha yüksek paralelleştirmeyle çalıştırmanıza olanak sağlamak için bulutu kullanan, tam olarak yönetilen bir Azure hizmetidir. Bu, kaliteden ödün vermeden özelliklerin sunulmasını hızlandırmaya yardımcı olan daha geniş senaryo kapsamıyla daha hızlı test çalıştırmaları anlamına gelir. Hizmet ayrıca, test sonuçlarını ve ilgili artefaktları otomatik olarak Azure depolamaya yükleyip servis portalında görüntüleyen entegre raporlama yetenekleri de içeriyor; böylece sorun giderme daha hızlı ve kolay hale getiriliyor. Playwright Workspaces ile özellikleri daha hızlı ve daha güvenle yayınlayabilirsiniz.

Başlamaya hazır mısınız? Hızlı başlangıç kılavuzumuza atlayın!

Get Started

Mevcut Playwright test paketinizi hizmetle çalıştırmak için bu adımları izleyin.

Önkoşullar

Çalışma Alanı Oluşturma

  1. Azure hesabınızla Azure portalında oturum açın.

  2. Çalışma alanını oluşturun.

    • Portalın sol üst köşesindeki menü düğmesini seçin ve ardından Kaynak oluştur'u seçin.

      Azure portal'da kaynak oluşturma

    • Arama kutusuna Oyun Yazarı Çalışma Alanları yazın.

    • Oyun Yazarı Çalışma Alanları kartını seçin ve ardından Oluştur'u seçin.

      Azure Market'te oyun yazarı çalışma alanlarını arama

    • Yeni bir Playwright çalışma alanı yapılandırmak için aşağıdaki bilgileri sağlayın:

      Veri Alanı Description
      Subscription Bu Oyun Yazarı çalışma alanı için kullanmak istediğiniz Azure aboneliğini seçin.
      Kaynak Grubu Mevcut bir kaynak grubunu seçin. Alternatif olarak Yeni oluştur'u seçin ve yeni kaynak grubu için benzersiz bir ad girin.
      İsim Çalışma alanınızı tanımlamak için benzersiz bir ad girin.
      Ad yalnızca alfasayısal karakterlerden oluşabilir ve 3 ile 64 karakter arasında bir uzunluğa sahip olabilir.
      Location Çalışma alanınızı barındırmak için coğrafi bir konum seçin.
      Bu konum aynı zamanda test yürütme sonuçlarının nerede depolandığını da belirler.
      Raporlama Toggle, kullanıcıların Playwright Workspace'ten test çalıştırma raporlarını kaydedip görüntülemesini sağlamak için varsayılan olarak "Etkin" olarak ayarlanmıştır. Raporlamayı kapatmak isterseniz, ayarı "Devre Engelli" olarak değiştirin.
      Depolama hesabı Playwright Workspaces'in rapor eserlerini depolamak için varsayılan olarak yeni depolama hesabı oluşturulur ve seçilir. Mevcut bir depolama hesabı seçmek için açılır menüden seçin veya "Yeni Oluştur" seçeneğine tıklayarak istediğiniz yeni bir depolama hesabı oluşturun.

      Uyarı

      İsteğe bağlı olarak, Etiketler sekmesinde daha fazla ayrıntı yapılandırabilirsiniz. Etiketler, birden çok kaynağa ve kaynak grubuna aynı etiketi uygulayarak kaynakları kategorilere ayırmanızı ve birleştirilmiş faturalamayı görüntülemenizi sağlayan ad/değer çiftleridir.

    • Kaynağı yapılandırmayı tamamladıktan sonra Gözden Geçir + Oluştur'u seçin.

    • Tüm yapılandırma ayarlarını gözden geçirin ve Playwright çalışma alanının dağıtımını başlatmak için Oluştur'u seçin.

    • İşlem tamamlandığında bir dağıtım başarılı iletisi görüntülenir.

    • Yeni çalışma alanını görüntülemek için Kaynağa git öğesini seçin.

      Dağıtım tamamlandı - Kaynağa git

Azure Playwright paketini yükleme

  1. Hizmet paketini yüklemek için bu komutu çalıştırın

    npm init @azure/playwright@latest

Hizmet paketini yüklemek, adlı bir hizmet yapılandırma dosyası oluşturur. playwright.service.config.ts

Hizmet yapılandırması şunlara hizmet eder:

  • Oyun Yazarını Oyun Yazarı Çalışma Alanlarına yönlendirin ve doğrulayın.
  • Yapılandırmanıza Playwright Workspaces raporu ekleyin.
  • Gerekirse, hizmet işlemleri için zaman aşımlarını geçersiz kılın.

Projenizin 1.47 veya üzeri bir sürümü kullandığından @playwright/test emin olun.

Bölge uç noktasını alma

  1. Azure portal, kurulumunuzda Bölge uç noktası ekle'nin altındaki komutu kopyalayın.

    Çalışma alanı uç noktasını ayarlama

    Uç nokta URL'si çalışma alanı bölgesine karşılık gelir. Çalışma alanını oluştururken seçtiğiniz bölgeye bağlı olarak Azure portal farklı bir uç nokta URL'si görebilirsiniz.

Ortamı ayarlama

Önceki adımda edindiğiniz şeyin PLAYWRIGHT_SERVICE_URL ortamınızda kullanılabilir olduğundan emin olun.

Ortamınızı yönetmek için module kullanmanızı dotenv öneririz. İle dotenv ortam değişkenlerinizi tanımlamak için dosyayı kullanacaksınız .env .

Sırlarınızı sızdırmamak için dosyanıza .env dosya eklemeyi .gitignore unutmayın.

npm i --save-dev dotenv

.env dosyası

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

Kimlik Doğrulamayı Ayarlama

Playwright testlerinizi Azure Playwright çalışma alanınızda çalıştırmak için, hizmetle testleri çalıştırdığınız Playwright istemcisinin kimliğini doğrulamanız gerekir. Bu, yerel geliştirme makineniz veya CI makineniz olabilir.

Hizmet iki kimlik doğrulama yöntemi sunar: Microsoft Entra Id ve Access Tokens.

Microsoft Entra Id, Güvenli erişim için Azure hesabınızda oturum açmayı gerektiren Azure kimlik bilgilerinizi kullanır. Alternatif olarak, Playwright çalışma alanınızdan bir erişim belirteci oluşturabilir ve bunu kurulumunuzda kullanabilirsiniz.

Microsoft Entra ID kullanarak kimlik doğrulamayı ayarlama

Microsoft Entra Id, hizmet için varsayılan ve önerilen kimlik doğrulamasıdır. Yerel geliştirme makinenizde oturum açmak için Azure CLI kullanabilirsiniz

az login

NOT: Birden çok Microsoft Entra kiracısının parçasıysanız, çalışma alanınızın ait olduğu kiracıda oturum açtığınızdan emin olun. Kiracı kimliğini Azure portalından alabilirsiniz, bkz. Kimliği aldıktan sonra komutunu kullanarak oturum açın az login --tenant <TenantID>

Erişim belirteçlerini kullanarak kimlik doğrulamayı ayarlama

Azure Playwright çalışma alanınızdan bir erişim belirteci oluşturabilir ve bunu kurulumunuzda kullanabilirsiniz. Ancak, gelişmiş güvenliği nedeniyle kimlik doğrulaması için Microsoft Entra Id'yi kesinlikle öneririz. Erişim belirteçleri kullanışlı olsa da uzun ömürlü parolalar gibi çalışır ve güvenliğin tehlikeye atılmasına daha duyarlıdır.

  1. Erişim belirteci tabanlı kimlik doğrulamasını kullanmak için, Erişim belirteci tabanlı kimlik doğrulamasını etkinleştir

  2. Erişim belirteçlerini kullanarak kimlik doğrulamasını ayarlama

Hizmette kimlik doğrulaması için Microsoft Entra Id kullanmanızı kesinlikle öneririz. Erişim belirteçleri kullanıyorsanız, bkz: Erişim Belirteçlerini Yönetme

NOT: CI işlem hatlarında Azure Playwright'ı kullanmak için işlem hattından hizmetle kimlik doğrulamasını yapılandırmanız gerekir, bkz. farklı tarayıcılar ve işletim sistemleri arasında sürekli uçtan uca test ayarlama

Testleri çalıştırın

Yukarıda oluşturduğunuz yapılandırmayı kullanarak hizmet tarafından yönetilen tarayıcılarda Playwright testleri çalıştırın.

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

Azure Playwright Reporter

Azure Playwright, Playwright HTML test raporlarınızı otomatik olarak Azure Storage'a yükleyen özel bir raporlayıcı içerir; böylece hata ayıklama ve sonuç paylaşımı için doğrudan Azure portalı üzerinden erişilebilir hale gelir.

Özellikler

  • Otomatik Rapor Yükleme: Playwright HTML raporlarını Azure Depolama hesabınıza sorunsuz yükler
  • Portal Integration: Test sonuçlarını doğrudan Azure Playwright portalında görüntüle
  • Gelişmiş Hata Hata Düzeltme: Detaylı test artefaktlarına, izlere ve ekran görüntülerine erişin

Kurulum ve Yapılandırma

Azure Playwright muhabir paketle @azure/playwright birlikte gelir ve Playwright'ın yerleşik HTML muhabiriyle birlikte çalışır.

1. Playwright Config'de Muhabirleri Yapılandırmak

Hem HTML reporter'ı hem de Azure Playwright reporter'ı ekleyin 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. Raporlama İçin Ön Koşullar

Azure Playwright raporlayıcısını kullanmadan önce, çalışma alanınızın doğru şekilde yapılandırıldığından emin olun:

Çalışma Alanı Yapılandırması

Raporlamayı Etkinleştirin ve Depolamayı Yapılandırmak:

  1. Azure portalında Playwright Workspace'inize gidin
  2. Depolama yapılandırma sekmesine gidin
  3. RaporlamayıEtkin Rejime Aç
  4. Yeni bir depolama hesabı oluşturun veya mevcut depolama hesabını seçin
  5. Kaydet'e tıklayın

Depolama Erişimi için RBAC'ı Yapılandırma:

  1. Bağlı depolama hesabını açın
  2. Erişim Kontrolü (IAM) sekmesine gidin
  3. Rol atamasını ekle tuşuna tıklayın
  4. Storage Blob Data Contributor role ile ara, sonra Sonra'ya tıklayın
  5. Test yapacak tüm üyeleri seçin ve ekleyin
  6. İncele + Atamaya tıklayın

Trace Viewer için CORS'u yapılandırma:

  1. Bağlı depolama hesabını açın
  2. Ayarlar → Kaynak paylaşımı (CORS) bölümüne gidin
  3. Blob servisi altında yeni bir kayıt ekleyin:
    • İzin verilen kaynaklar: https://trace.playwright.dev
    • İzin verilen yöntemler: GET, OPTIONS
    • Maksimum yaş: 0 ile 2147483647 arasında bir değer girin
  4. Kaydet'e tıklayın
Müşteri Gereksinimleri
  • Kimlik doğrulama: Microsoft Entra ID doğrulaması gereklidir (erişim tokenları raporlama için desteklenmez)
  • Oyun Yazarı Versiyonu: Oyun yazarı 1.57 veya üzeri sürüm gerektirir
  • Servis Yapılandırması: Servis yapılandırmasını kullanmak zorundadır (playwright.service.config.ts)
  • Çalışma Alanı Ayarları: Azure Playwright çalışma alanında raporlama etkin olmalıdır

Nasıl Çalışır?

  1. Test Execution: Test normal şekilde Azure Playwright servis tarayıcıları kullanılarak çalıştırılır
  2. HTML Rapor Oluşturma: Playwright'ın HTML muhabiri standart test raporunu oluşturur
  3. Otomatik Yükleme: Azure Reporter, HTML rapor klasörünü çalışma alanınızın Azure Storage'ına yükler
  4. Portal Erişimi: Azure portalında sağlanan URL üzerinden sonuçları görüntüleyin

Sonraki Adımlar

Contributing

Bu proje katkı ve önerilere açıktır. Çoğu katkı, katkınızı kullanma hakkına sahip olduğunuzu ve bize katkınızı kullanma haklarını gerçekten verdiğinizi beyan eden bir Katılımcı Lisans Sözleşmesini (CLA) kabul etmenizi gerektirir. Ayrıntılar için adresini ziyaret edin https://cla.opensource.microsoft.com.

Bir çekme isteği gönderdiğinizde, bir CLA botu otomatik olarak bir CLA sağlamanız gerekip gerekmediğini belirler ve PR'yi uygun şekilde dekore eder (örneğin, durum kontrolü, yorum). Bot tarafından sağlanan talimatları uygulamanız yeterlidir. Bunu, CLA'mızı kullanan tüm depolarda yalnızca bir kez yapmanız gerekecektir.

Bu proje, Microsoft Açık Kaynak Davranış Kuralları'nı benimsemiştir. Daha fazla bilgi için Davranış Kuralları SSS bölümüne bakın veya ek sorularınız veya yorumlarınız için iletişime geçin opencode@microsoft.com .

Ticari markalarıdır

Bu proje, projeler, ürünler veya hizmetler için ticari markalar veya logolar içerebilir. Microsoft ticari markalarının veya logolarının yetkili kullanımı, Microsoft'un Ticari Marka ve Marka Yönergeleri'ne tabidir ve bu yönergelere uymak zorundadır. Bu projenin değiştirilmiş sürümlerinde Microsoft ticari markalarının veya logolarının kullanılması karışıklığa neden olmamalı veya Microsoft sponsorluğunu ima etmemelidir. Üçüncü taraf ticari markalarının veya logolarının herhangi bir şekilde kullanılması, söz konusu üçüncü tarafın politikalarına tabidir.

  • Last updated on