Guia de início rápido: criar um hub de eventos usando um modelo ARM

Artigo
03/08/2024

Neste início rápido, você cria um hub de eventos usando um modelo do Azure Resource Manager (modelo ARM). Você implanta um modelo ARM para criar um namespace do tipo Hubs de Eventos, com um hub de eventos.

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.
Se você é novo nos Hubs de Eventos do Azure, consulte Visão geral dos Hubs de Eventos e Recursos dos Hubs de Eventos.

Rever o modelo

O modelo utilizado neste início rápido pertence aos Modelos de Início Rápido do 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'))]"
      ]
    }
  ]
}

Os recursos definidos no modelo incluem:

Para encontrar mais exemplos de modelos, consulte Modelos de início rápido do Azure.

Implementar o modelo

Usando a interface do usuário do portal do Azure

Se o seu ambiente cumpre os pré-requisitos e se está familiarizado com a utilização de modelos ARM, selecione o botão Implementar no Azure. O modelo é aberto no portal do Azure.
Selecione um grupo de recursos existente ou crie um grupo de recursos e selecione-o.
Selecione a região.
Insira um nome exclusivo para o projeto. Esse nome é usado para gerar nomes para um namespace de Hubs de Eventos e um hub de eventos no namespace.
Selecione Rever + criar.
Na página Rever + criar, selecione Criar.

Utilizar o Azure Cloud Shell

Para implantar o modelo usando o Azure Cloud Shell:

Selecione Open Cloud Shell no bloco de código a seguir e siga as instruções para entrar no 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 ..."

Leva alguns minutos para criar um hub de eventos.

Selecione Copiar para copiar o script do PowerShell.
Clique com o botão direito do mouse no console do shell e selecione Colar.
Pressione ENTER para executar os comandos.

Validar a implementação

Para verificar a implantação, você pode abrir o grupo de recursos no portal do Azure ou usar o seguinte script do Azure PowerShell. Se o Cloud Shell ainda estiver aberto, você não precisará copiar/executar a primeira linha (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 ..."

Clean up resources (Limpar recursos)

Quando os recursos do Azure já não forem necessários, limpe os recursos implementados ao eliminar o grupo de recursos. Se o Cloud Shell ainda estiver aberto, você não precisará copiar/executar a primeira linha (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 ..."

Próximos passos

Neste artigo, você criou um namespace de Hubs de Eventos e um hub de eventos no namespace. Para obter instruções passo a passo para enviar eventos para (ou) receber eventos de um hub de eventos, consulte os tutoriais Enviar e receber eventos :

Partilhar via