Guia de Início Rápido: Criar um namespace e uma fila de Barramento de Serviço usando um arquivo do Bicep

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

O Bicep é um DSL (linguagem específica de domínio) que usa sintaxe declarativa para implantar recursos do Azure. Ele fornece sintaxe concisa, segurança de tipos confiá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 você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

Examinar o arquivo Bicep

O arquivo Bicep usado neste guia de início rápido é proveniente dos 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 arquivo Bicep incluem:

• Microsoft.ServiceBus/namespaces
• Microsoft.ServiceBus/namespaces/queues

É possível encontrar mais modelos do Bicep/ARM em Modelos de Início Rápido do Azure

Implante o arquivo Bicep

Com este arquivo do Bicep, você implantará um namespace de Barramento de Serviço com uma fila.

As filas do Barramento de Serviço oferecem entrega de mensagem do tipo PEPS (primeiro a entrar, primeiro a sair) para um ou mais consumidores concorrentes.

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

2. Para implantar o arquivo Bicep, use a CLI do Azure ou o Azure PowerShell.

   • CLI
   • PowerShell

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

   Você deverá inserir os seguintes valores de parâmetro:

   • serviceBusNamespaceName: nome do namespace do Barramento de Serviço.
   • serviceBusQueueName: nome da fila.

   Quando a implantação for concluída, você deverá ver uma mensagem indicando que ela foi bem-sucedida.

Validar a implantaçã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

Get-AzResource -ResourceGroupName exampleRG

Limpar os recursos

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

az group delete --name exampleRG

Remove-AzResourceGroup -Name exampleRG

Próximas etapas

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

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

Saiba como gerenciar esses recursos analisando estes artigos:

• Gerenciar o Barramento de Serviço com o PowerShell
• Gerenciar recursos do Barramento de Serviço com o Service Bus Explorer