Snabbstart: Skapa en händelsehubb med hjälp av en ARM-mall

Artikel
03/08/2024

I den här snabbstarten skapar du en händelsehubb med hjälp av en Azure Resource Manager-mall (ARM-mall). Du distribuerar en ARM-mall för att skapa ett namnområde av typen Event Hubs med en händelsehubb.

Förutsättningar

Om du inte har någon Azure-prenumeration skapar du ett kostnadsfritt konto innan du börjar.
Om du inte har använt Azure Event Hubs tidigare kan du läsa Översikt över Event Hubs och Event Hubs-funktioner.

Granska mallen

Mallen som används i den här snabbstarten kommer från Azure-snabbstartsmallar.

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

De resurser som definierats i mallen är:

Mer information om mallexempel finns i Azure-snabbstartsmallar.

Distribuera mallen

Använda användargränssnittet i Azure-portalen

Om din miljö uppfyller förhandskraven och du är van att använda ARM-mallar väljer du knappen Distribuera till Azure. Mallen öppnas i Azure-portalen.
Välj en befintlig resursgrupp eller skapa en resursgrupp och välj den.
Välj region.
Ange ett unikt namn för projektet. Det här namnet används för att generera namn för ett Event Hubs-namnområde och en händelsehubb i namnområdet.
Välj Granska + skapa.
På sidan Granska + skapa väljer du Skapa.

Använda Azure Cloud Shell

Så här distribuerar du mallen med Azure Cloud Shell:

Välj Öppna Cloud Shell från följande kodblock och följ sedan anvisningarna för att logga in på 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 ..."

Det tar en stund att skapa en händelsehubb.

Välj Kopiera för att kopiera PowerShell-skriptet.
Högerklicka på gränssnittskonsolen och välj sedan Klistra in.
Tryck på RETUR för att köra kommandona.

Verifiera distributionen

För att verifiera distributionen kan du antingen öppna resursgruppen från Azure-portalen eller använda följande Azure PowerShell-skript. Om Cloud Shell fortfarande är öppet behöver du inte kopiera/köra den första raden (läsvärd).

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

Rensa resurser

När Azure-resurserna inte längre behövs rensar du de resurser som du har distribuerat genom att ta bort resursgruppen. Om Cloud Shell fortfarande är öppet behöver du inte kopiera/köra den första raden (läsvärd).

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

Nästa steg

I den här artikeln skapade du ett Event Hubs-namnområde och en händelsehubb i namnområdet. Stegvisa instruktioner för att skicka händelser till (eller) ta emot händelser från en händelsehubb finns i självstudierna Skicka och ta emot händelser :