Guia de início rápido: criar um namespace do Service Bus e uma fila usando um arquivo Bicep

  • Artigo

Este artigo mostra como usar um arquivo Bicep que cria um namespace do Service Bus e uma fila dentro desse namespace. O artigo explica como especificar quais recursos são implantados e como definir parâmetros que são especificados quando a implantação é executada. Você pode usar esse arquivo Bicep para suas próprias implantações ou personalizá-lo para atender às suas necessidades.

O Bicep é uma linguagem específica do domínio que utiliza sintaxe declarativa para implementar recursos do Azure. Fornece sintaxe concisa, segurança de tipos fiável e suporte para reutilização de código. O Bicep oferece a melhor experiência de criação para 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.

Revise o arquivo Bicep

O arquivo Bicep usado neste início rápido é de Modelos de Início Rápido do Azure.

@description('Name of the Service Bus namespace')
param serviceBusNamespaceName string

@description('Name of the Queue')
param serviceBusQueueName string

@description('Location for all resources.')
param location string = resourceGroup().location

resource serviceBusNamespace 'Microsoft.ServiceBus/namespaces@2022-01-01-preview' = {
  name: serviceBusNamespaceName
  location: location
  sku: {
    name: 'Standard'
  }
  properties: {}
}

resource serviceBusQueue 'Microsoft.ServiceBus/namespaces/queues@2022-01-01-preview' = {
  parent: serviceBusNamespace
  name: serviceBusQueueName
  properties: {
    lockDuration: 'PT5M'
    maxSizeInMegabytes: 1024
    requiresDuplicateDetection: false
    requiresSession: false
    defaultMessageTimeToLive: 'P10675199DT2H48M5.4775807S'
    deadLetteringOnMessageExpiration: false
    duplicateDetectionHistoryTimeWindow: 'PT10M'
    maxDeliveryCount: 10
    autoDeleteOnIdle: 'P10675199DT2H48M5.4775807S'
    enablePartitioning: false
    enableExpress: false
  }
}

Os recursos definidos no arquivo Bicep incluem:

Nota

Os seguintes modelos ARM estão disponíveis para download e implantação.

Você pode encontrar mais modelos de Bicep/ARM em Modelos de Início Rápido do Azure

Implantar o arquivo Bicep

Com esse arquivo Bicep, você implanta um namespace do Service Bus com uma fila.

As filas do Barramento de Serviço oferecem a entrega de mensagens First In, First out (FIFO) para um ou mais consumidores concorrentes.

  1. Salve o arquivo Bicep como main.bicep em seu computador local.

  2. Implante o arquivo Bicep usando a CLI do Azure ou o Azure PowerShell.

    az group create --name exampleRG --location eastus
az deployment group create --resource-group exampleRG --template-file main.bicep

    Você será solicitado a inserir os seguintes valores de parâmetro:

    • serviceBusNamespaceName: Nome do namespace do Service Bus.
    • serviceBusQueueName: Nome da fila.

    Quando a implantação terminar, você verá uma mensagem indicando que a implantação foi bem-sucedida.

Validar a implementação

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

az resource list --resource-group exampleRG

Clean up resources (Limpar recursos)

Quando não for mais necessário, use o portal do Azure, a CLI do Azure ou o Azure PowerShell para excluir a VM e todos os recursos do grupo de recursos.

az group delete --name exampleRG

Próximos passos

Consulte o tópico a seguir que mostra como criar uma regra de autorização para o namespace/fila:

Criar uma regra de autorização do Service Bus para namespace e fila usando um modelo ARM

Saiba como gerir estes recursos visualizando estes artigos: