Guida introduttiva: Creare un hub eventi usando un modello di Resource Manager

Articolo
03/15/2023

In questa guida di avvio rapido viene creato un hub eventi usando un modello di Azure Resource Manager. Il modello di Resource Manager viene distribuito per creare uno spazio dei nomi di tipo Hub eventi con un hub eventi.

Prerequisiti

Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.
Se non si ha familiarità con Hub eventi di Azure, vedere Panoramica di Hub eventi e funzionalità di Hub eventi.

Rivedere il modello

Il modello usato in questo avvio rapido proviene dai modelli di avvio rapido di 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'))]"
      ]
    }
  ]
}

Nel modello sono definite le risorse seguenti:

Per altri esempi di modello, vedere Modelli di avvio rapido di Azure.

Distribuire il modello

Uso dell'interfaccia utente di portale di Azure

Se l'ambiente soddisfa i prerequisiti e si ha familiarità con l'uso dei modelli di Resource Manager, selezionare il pulsante Distribuisci in Azure. Il modello viene visualizzato nel portale di Azure.
Selezionare un gruppo di risorse esistente o crearne uno e selezionarlo.
Selezionare l'area.
Immettere un nome univoco per il progetto. Questo nome viene usato per generare nomi per uno spazio dei nomi di Hub eventi e un hub eventi nello spazio dei nomi .
Selezionare Rivedi e crea.
Nella pagina Rivedi e crea selezionare Crea.

Uso di Azure Cloud Shell

Per distribuire il modello usando Azure Cloud Shell:

Selezionare Open Cloud Shell (Apri Cloud Shell ) dal blocco di codice seguente e quindi seguire le istruzioni per accedere ad 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 ..."

La creazione di un hub eventi richiede pochi minuti.

Selezionare Copia per copiare lo script di PowerShell.
Fare clic con il pulsante destro del mouse sulla console della shell e quindi scegliere Incolla.
Premere INVIO per eseguire i comandi.

Convalidare la distribuzione

Per verificare la distribuzione, è possibile aprire il gruppo di risorse dal portale di Azure oppure usare lo script di Azure PowerShell riportato di seguito. Se Cloud Shell è ancora aperto, non è necessario copiare/eseguire la prima riga (Read-Host).

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

Pulire le risorse

Quando non sono più necessarie, eseguire la pulizia delle risorse di Azure distribuite eliminando il gruppo di risorse. Se Cloud Shell è ancora aperto, non è necessario copiare/eseguire la prima riga (Read-Host).

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

Passaggi successivi

In questo articolo è stato creato uno spazio dei nomi Hub eventi e un hub eventi nello spazio dei nomi. Per istruzioni dettagliate relative all'invio o alla ricezione di eventi da un hub eventi, vedere le esercitazioni per l'invio e la ricezione di eventi: