التشغيل السريع: قم بإنشاء مركز أحداث باستخدام قالب ARM

مقالة
03/10/2024

في هذا التشغيل السريع، يمكنك إنشاء لوحة وصل حدث باستخدام قالب إدارة موارد Azure (قالب ARM). نشر قالب ARM لإنشاء مساحة اسم من نوع Event Hubs، مع مركز أحداث واحد.

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

في حال لم يكن لديك اشتراك Azure، فأنشئ حساباً مجانيّاً قبل البدء.
إذا كنت مستخدما جديدا لمراكز أحداث Azure، فشاهد نظرة عامة على مراكز الأحداث وميزات مراكز الأحداث.

مراجعة القالب

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

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "metadata": {
    "_generator": {
      "name": "bicep",
      "version": "0.5.6.12127",
      "templateHash": "16940368634879422816"
    }
  },
  "parameters": {
    "projectName": {
      "type": "string",
      "metadata": {
        "description": "Specifies a project name that is used to generate the Event Hub name and the Namespace name."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Specifies the Azure location for all resources."
      }
    },
    "eventHubSku": {
      "type": "string",
      "defaultValue": "Standard",
      "allowedValues": [
        "Basic",
        "Standard"
      ],
      "metadata": {
        "description": "Specifies the messaging tier for Event Hub Namespace."
      }
    }
  },
  "variables": {
    "eventHubNamespaceName": "[format('{0}ns', parameters('projectName'))]",
    "eventHubName": "[parameters('projectName')]"
  },
  "resources": [
    {
      "type": "Microsoft.EventHub/namespaces",
      "apiVersion": "2021-11-01",
      "name": "[variables('eventHubNamespaceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('eventHubSku')]",
        "tier": "[parameters('eventHubSku')]",
        "capacity": 1
      },
      "properties": {
        "isAutoInflateEnabled": false,
        "maximumThroughputUnits": 0
      }
    },
    {
      "type": "Microsoft.EventHub/namespaces/eventhubs",
      "apiVersion": "2021-11-01",
      "name": "[format('{0}/{1}', variables('eventHubNamespaceName'), variables('eventHubName'))]",
      "properties": {
        "messageRetentionInDays": 7,
        "partitionCount": 1
      },
      "dependsOn": [
        "[resourceId('Microsoft.EventHub/namespaces', variables('eventHubNamespaceName'))]"
      ]
    }
  ]
}

تشمل الموارد المحددة في النموذج ما يلي:

للعثور على المزيد من نماذج القوالب، راجع Azure Quickstart Templates.

نشر القالب

استخدام واجهة مستخدم مدخل Microsoft Azure

إذا كانت بيئتك تلبي المتطلبات الأساسية وكنت معتاداً على استخدام قوالب "ARM"، فحدد زر "Deploy to Azure". سيتم فتح القالب في مدخل Azure.
حدد مجموعة موارد موجودة أو أنشئ مجموعة موارد وحددها.
حدد المنطقة.
أدخل اسمافريدا للمشروع. يتم استخدام هذا الاسم لإنشاء أسماء لمساحة اسم Event Hubs ومركز أحداث في مساحة الاسم.
حدد "Review + create".
في صفحة مراجعة+ إنشاء حدد إنشاء.

استخدام Azure Cloud Shell

لنشر القالب باستخدام Azure Cloud Shell:

حدد Open Cloud Shell من كتلة التعليمات البرمجية التالية، ثم اتبع الإرشادات لتسجيل الدخول إلى Azure Cloud Shell.

$projectName = Read-Host -Prompt "Enter a project name that is used for generating resource names"
$location = Read-Host -Prompt "Enter the location (i.e. centralus)"
$resourceGroupName = "${projectName}rg"
$templateUri = "https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/quickstarts/microsoft.eventhub/eventhubs-create-namespace-and-eventhub/azuredeploy.json"

New-AzResourceGroup -Name $resourceGroupName -Location $location
New-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -TemplateUri $templateUri -projectName $projectName

Write-Host "Press [ENTER] to continue ..."

يستغرق إنشاء مركز أحداث بضع لحظات.

حدد Copy لنسخ برنامج "PowerShell" النصي.
انقر بزر الماوس الأيمن على وحدة تحكم shell، ثم حدِّد Paste.
اضغط على ENTER لتشغيل الأوامر.

التحقُّق من صحة عملية النشر

للتحقق من النشر، يمكنك إما فتح مجموعة الموارد من مدخل Microsoft Azure،أو استخدام برنامج Azure PowerShell النصي التالي. إذا كانت « Cloud Shell» لا تزال مفتوحة، فلا تحتاج إلى نسخ/تشغيل السطر الأول (قراءة المضيف).

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"
$resourceGroupName = "${projectName}rg"
$namespaceName = "${projectName}ns"

Get-AzEventHub -ResourceGroupName $resourceGroupName -Namespace $namespaceName

Write-Host "Press [ENTER] to continue ..."

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

عندما لا تكون موارد Azure مطلوبة، قم بتنظيف الموارد التي قمت بنشرها عن طريق حذف مجموعة الموارد. إذا كانت « Cloud Shell» لا تزال مفتوحة، فلا تحتاج إلى نسخ/تشغيل السطر الأول (قراءة المضيف).

$projectName = Read-Host -Prompt "Enter the same project name that you used in the last procedure"
$resourceGroupName = "${projectName}rg"

Remove-AzResourceGroup -ResourceGroupName $resourceGroupName

Write-Host "Press [ENTER] to continue ..."

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

في هذه المقالة، قمت بإنشاء مساحة اسم لمركز الأحداث ومركز لحدث في مساحة اسم. للحصول على إرشادات خطوة بخطوة لإرسال الأحداث إلى (أو) تلقي الأحداث من مركز الأحداث، راجع البرامج التعليمية لإرسال الأحداثواستلامها:

Share via