Início Rápido: Criar um hub de eventos com o Bicep

  • Artigo

Os Hubs de Eventos do Azure são uma plataforma de fluxo de Macrodados e um serviço de ingestão de eventos capaz de receber e processar milhões de eventos por segundo. Os Hubs de Eventos podem processar e armazenar eventos, dados ou telemetria produzidos por dispositivos e software distribuído. Os dados enviados para um hub de eventos podem ser transformados e armazenados em qualquer fornecedor de análise em tempo real ou adaptadores de armazenamento/criação de batches. Para uma descrição geral detalhada dos Hubs de Eventos, veja Descrição geral dos Hubs de Eventos e Funcionalidades dos Hubs de Eventos. Neste início rápido, vai criar um hub de eventos com o Bicep. Implementa um ficheiro Bicep para criar um espaço de nomes do tipo Hubs de Eventos, com um hub de eventos.

O Bicep é uma linguagem específica do domínio (DSL) que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece sintaxe concisa, segurança de tipo fiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para as suas soluções de infraestrutura como código no Azure.

Pré-requisitos

Se não tiver uma subscrição do Azure, crie uma conta gratuita antes de começar.

Rever o ficheiro Bicep

O ficheiro Bicep utilizado neste início rápido é proveniente dos Modelos de Início Rápido do Azure.

@description('Specifies a project name that is used to generate the Event Hub name and the Namespace name.')
param projectName string

@description('Specifies the Azure location for all resources.')
param location string = resourceGroup().location

@description('Specifies the messaging tier for Event Hub Namespace.')
@allowed([
  'Basic'
  'Standard'
])
param eventHubSku string = 'Standard'

var eventHubNamespaceName = '${projectName}ns'
var eventHubName = projectName

resource eventHubNamespace 'Microsoft.EventHub/namespaces@2021-11-01' = {
  name: eventHubNamespaceName
  location: location
  sku: {
    name: eventHubSku
    tier: eventHubSku
    capacity: 1
  }
  properties: {
    isAutoInflateEnabled: false
    maximumThroughputUnits: 0
  }
}

resource eventHub 'Microsoft.EventHub/namespaces/eventhubs@2021-11-01' = {
  parent: eventHubNamespace
  name: eventHubName
  properties: {
    messageRetentionInDays: 7
    partitionCount: 1
  }
}

Os recursos definidos no ficheiro Bicep incluem:

Implementar o ficheiro Bicep

  1. Guarde o ficheiro Bicep como main.bicep no seu computador local.

  2. Implemente o ficheiro Bicep com a CLI do Azure ou Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep --parameters projectName=<project-name>

    Nota

    Substitua <project-name> por um nome de projeto. Será utilizado para gerar o nome dos Hubs de Eventos e o nome do Espaço de Nomes.

    Quando a implementação terminar, deverá ver uma mensagem a indicar que a implementação foi bem-sucedida.

Validar a implementação

Utilize o portal do Azure, a CLI do Azure ou Azure PowerShell para listar os recursos implementados no grupo de recursos.

az resource list --resource-group exampleRG

Limpar recursos

Quando já não for necessário, utilize a portal do Azure, a CLI do Azure ou Azure PowerShell para eliminar a VM e todos os recursos no grupo de recursos.

az group delete --name exampleRG

Passos seguintes

Neste artigo, criou um espaço de nomes dos Hubs de Eventos e um hub de eventos no espaço de nomes com o Bicep. Para obter instruções passo a passo para enviar eventos para (ou) receber eventos de um hub de eventos, veja os tutoriais Enviar e receber eventos :