Rövid útmutató: Eseményközpont létrehozása ARM-sablonnal

Cikk
03/08/2024

Ebben a rövid útmutatóban egy Azure Resource Manager-sablon (ARM-sablon) használatával hozhat létre eseményközpontot. Arm-sablont helyez üzembe egy Event Hubs típusú névtér létrehozásához egy eseményközponttal.

Előfeltételek

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.
Ha még nem ismerkedik az Azure Event Hubs szolgáltatásokkal, tekintse meg az Event Hubs áttekintését és az Event Hubs funkcióit.

A sablon áttekintése

Az ebben a gyorsútmutatóban használt sablon az Azure-gyorssablonok közül származik.

{
  "$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'))]"
      ]
    }
  ]
}

A sablonban definiált erőforrások a következők:

További sablonmintákért tekintse meg az Azure rövid útmutatósablonjait.

A sablon üzembe helyezése

Az Azure Portal felhasználói felületének használata

Ha a környezet megfelel az előfeltételeknek, és már ismeri az ARM-sablonokat, kattintson az Üzembe helyezés az Azure-ban gombra. A sablon megnyílik az Azure Portalon.
Válasszon ki egy meglévő erőforráscsoportot , vagy hozzon létre egy erőforráscsoportot, és jelölje ki.
Válassza ki a régiót.
Adja meg a projekt egyedi nevét. Ez a név egy Event Hubs-névtér és egy eseményközpont neveinek létrehozására szolgál a névtérben.
Válassza az Áttekintés + létrehozás lehetőséget.
A Véleményezés + létrehozás lapon válassza a Létrehozás lehetőséget.

Az Azure Cloud Shellt használata

A sablon üzembe helyezése az Azure Cloud Shell használatával:

A következő kódblokkban válassza a Cloud Shell megnyitása lehetőséget, majd az utasításokat követve jelentkezzen be az Azure Cloud Shellbe.

$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 ..."

Az eseményközpont létrehozása néhány percet vesz igénybe.

Válassza a Másolás lehetőséget a PowerShell-szkript másolásához.
Kattintson a jobb gombbal a rendszerhéjkonzolra, majd válassza a Beillesztés parancsot.
A parancsok futtatásához nyomja le az ENTER billentyűt .

Az üzembe helyezés ellenőrzése

Az üzembe helyezés ellenőrzéséhez megnyithatja az erőforráscsoportot az Azure Portalon, vagy használhatja a következő Azure PowerShell-szkriptet. Ha a Cloud Shell továbbra is nyitva van, nem kell az első sort (Olvasási gazdagép) másolni/futtatni.

$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 ..."

Az erőforrások eltávolítása

Ha már nincs szükség az Azure-erőforrásokra, törölje az üzembe helyezett erőforrásokat az erőforráscsoport törlésével. Ha a Cloud Shell továbbra is nyitva van, nem kell az első sort (Olvasási gazdagép) másolni/futtatni.

$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 ..."

Következő lépések

Ebben a cikkben létrehozott egy Event Hubs-névteret és egy eseményközpontot a névtérben. Az események eseményközpontba (vagy az eseményközpontból) való fogadására vonatkozó részletes útmutatásért tekintse meg az Események küldése és fogadása oktatóanyagot: