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. Playwright çalışma alanlarıyla özellikleri daha hızlı ve daha güvenli bir şekilde 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.

      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

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.
  • 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 .gitignore dosya eklemeyi .env 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

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