إنشاء مورد Web PubSub

المتطلبات الأساسية

• حساب Azure مع اشتراك نشط. إنشاء حساب Azure مجاني، إذا لم يكن لديك حساب بالفعل.

تلميح

يتضمن Web PubSub مستوى مجانيا سخيا يمكن استخدامه لأغراض الاختبار والإنتاج.

إنشاء مورد من مدخل Microsoft Azure

1. حدد الزر جديد «New» الموجود في الزاوية العلوية اليسرى من مدخل Microsoft Azure. في الشاشة جديد، اكتب Web PubSub في مربع البحث ثم اضغط على مفتاح الإدخال Enter.

   

2. حدد «Web PubSub» من نتائج البحث، ثم حدد «Create».

3. أدخل الإعدادات التالية.

   الإعدادات	القيمة المقترحة	‏‏الوصف
   اسم المورد	اسم فريد عالميًا	الاسم الفريد العام الذي يعرّف مثيل خدمة Web PubSub الجديد. الأحرف الصالحة هي a-zو A-Z0-9و و.-
   الاشتراك	اشتراكك	اشتراك Azure الذي يتم بموجبه إنشاء مثيل خدمة Web PubSub الجديد هذا.
   [مجموعة الموارد]	myResourceGroup	اسم مجموعة الموارد الجديدة التي يتم فيها إنشاء مثيل خدمة Web PubSub.
   الموقع	غرب الولايات المتحدة	اختر منطقة قريبة منك.
   مستوى الأسعار	مجاني	يمكنك أولًا تجربة خدمة Azure Web PubSub مجانًا. تعرف على مزيد من التفاصيل حول مستويات تسعير خدمة Azure Web PubSub
   عدد الوحدات	-	يحدد عدد الوحدات عدد الاتصالات التي يمكن لمثيل خدمة PubSub على الويب قبولها. تدعم كل وحدة 1000 اتصال متزامن على الأكثر. لا يمكن تكوينه إلا في المستوى القياسي.

   

4. حدد Create لتوفير مورد Web PubSub الخاص بك.

إنشاء مورد باستخدام Azure CLI

تُعد واجهة سطر الأوامر Azure هي مجموعة من الأوامر لإنشاء موارد Azure وإدارتها. يتوفر Azure CLI عبر خدمات Azure وهو مصمم لمساعدتك على العمل بسرعة مع Azure، مع التركيز على الأتمتة.

هام

يتطلب هذا التشغيل السريع Azure CLI من الإصدار 2.22.0 أو أعلى.

إنشاء مجموعة موارد

وتُعد مجموعة الموارد عبارة عن حاوية منطقية يتم فيها توزيع موارد Azure وإدارتها. استخدم الأمر az group create لإنشاء مجموعة موارد باسم myResourceGroup في eastus الموقع.

az group create --name myResourceGroup --location EastUS

إنشاء مورد

قم بتشغيل ملحق az add لتثبيت أو ترقية ملحق webpubsub إلى الإصدار الحالي.

az extension add --upgrade --name webpubsub

استخدم الأمر Azure CLI az webpubsub create لإنشاء Web PubSub في مجموعة الموارد التي قمت بإنشائها. ينشئ الأمر التالي مورد Web PubSub مجاني ضمن مجموعة الموارد myResourceGroup في EastUS:

هام

يجب أن يكون لكل مورد Web PubSub ويب اسمًا فريدًا. استبدل <your-unique-resource-name> باسم Web PubSub في الأمثلة التالية.

az webpubsub create --name "<your-unique-resource-name>" --resource-group "myResourceGroup" --location "EastUS" --sku Free_F1

يظهر إخراج هذا الأمر خصائص المورد المنشأ حديثًا. دوّن اثنتين من الخصائص المذكورة أدناه:

• اسم المورد: الاسم الذي قدمته للمعلمة --name أعلاه.
• اسم المضيف: في المثال، اسم المضيف هو <your-unique-resource-name>.webpubsub.azure.com/.

في هذه المرحلة، حساب Azure هو الوحيد المصرح به لتنفيذ أي عمليات على هذا المورد الجديد.

إنشاء مورد باستخدام قالب Bicep

Bicep هي لغة المجال المخصصة (DSL) التي تستخدم بناء الجملة التعريفي لتوزيع موارد Azure. توفر بناء جملة مختصر، وسلامة موثوقة من النوع، ودعمًا لإعادة استخدام التعليمة البرمجية. تقدم Bicep أفضل تجربة تأليف لحلول البنية الأساسية باعتبارها تعليمة برمجية في Azure.

مراجعة ملف Bicep

يُعدّ النموذج المستخدم في هذا التشغيل السريع مأخوذاً من قوالب التشغيل السريع من Azure.

/* This Bicep file deploys a new instance of Azure Web PubSub service. */

// Parameters

@description('The name for your new Web PubSub instance.')
@maxLength(63)
@minLength(3)
param wpsName string = uniqueString(resourceGroup().id)

@description('The region in which to create the new instance, defaults to the same location as the resource group.')
param location string = resourceGroup().location

@description('Unit count')
@allowed([
  1
  2
  5
  10
  20
  50
  100
])
param unitCount int = 1

@description('SKU name')
@allowed([
  'Standard_S1'
  'Free_F1'
])
param sku string = 'Free_F1'

@description('Pricing tier')
@allowed([
  'Free'
  'Standard'
])
param pricingTier string = 'Free'

// Resource definition
resource webpubsub 'Microsoft.SignalRService/webPubSub@2021-10-01' = {
  name: wpsName
  location: location
  sku: {
    capacity: unitCount
    name: sku
    tier: pricingTier
  }
  identity: {
    type: 'None'
  }
  properties: {
    disableAadAuth: false
    disableLocalAuth: false
    liveTraceConfiguration: {
      categories: [
        {
          enabled: 'false'
          name: 'ConnectivityLogs'
        }
        {
          enabled: 'false'
          name: 'MessagingLogs'
        }
      ]
      enabled: 'false'
    }
    networkACLs: {
      defaultAction: 'Deny'     
      publicNetwork: {
        allow: [
          'ServerConnection'
          'ClientConnection'
          'RESTAPI'
          'Trace'
        ]
      }
    }
    publicNetworkAccess: 'Enabled'
    resourceLogConfiguration: {
      categories: [
        {
          enabled: 'true'
          name: 'ConnectivityLogs'
        }
        {
          enabled: 'true'
          name: 'MessagingLogs'
        }
      ]
    }
    tls: {
      clientCertEnabled: false
    }
  }
}

نشر ملف Bicep

1. احفظ ملف Bicep بالاسم main.bicep على الكمبيوتر المحلي الخاص بك.

2. بادر بتوزيع ملف Bicep باستخدام Azure CLI أو Azure PowerShell.

   المبادره القطريه

   az group create --name exampleRG --location eastus
   az deployment group create --resource-group exampleRG --template-file main.bicep
   

   PowerShell

   New-AzResourceGroup -Name exampleRG -Location eastus
   New-AzResourceGroupDeployment -ResourceGroupName exampleRG -TemplateFile ./main.bicep
   

---

عند الانتهاء من عملية النشر، يجب أن ترى رسالة تشير إلى نجاح عملية النشر.

مراجعة الموارد الموزعة

استخدم مدخل Microsoft Azure أو Azure CLI أو Azure PowerShell لإدراج الموارد الموزعة في مجموعة الموارد.

المبادره القطريه

az resource list --resource-group exampleRG

PowerShell

Get-AzResource -ResourceGroupName exampleRG

تنظيف الموارد

عند عدم الحاجة، استخدم مدخل Azure أو Azure CLI أو Azure PowerShell لحذف مجموعة الموارد وموارده.

المبادره القطريه

az group delete --name exampleRG

PowerShell

Remove-AzResourceGroup -Name exampleRG

الخطوة التالية

الآن بعد أن قمت بإنشاء مورد، أنت مستعد لاستخدامه. بعد ذلك، ستتعلم كيفية الاشتراك في الرسائل ونشرها بين عملائك.

PubSub بين العملاء