Share via

Início Rápido: Criar um espaço de nomes do Service Bus e uma fila com um ficheiro Bicep

  • Artigo

Este artigo mostra como utilizar um ficheiro Bicep que cria um espaço de nomes do Service Bus e uma fila nesse espaço de nomes. O artigo explica como especificar que recursos são implementados e como definir parâmetros especificados quando a implementação é executada. Pode utilizar este ficheiro Bicep para as suas próprias implementações ou personalizá-lo para cumprir os seus requisitos.

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('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 ficheiro Bicep incluem:

Nota

Os seguintes modelos arm estão disponíveis para transferência e implementação.

Pode encontrar mais modelos bicep/ARM a partir de Modelos de Início Rápido do Azure

Implementar o ficheiro Bicep

Com este ficheiro Bicep, vai implementar um espaço de nomes do Service Bus com uma fila.

As filas do Service Bus oferecem entrega de mensagens First In, First Out (FIFO) a um ou mais consumidores concorrentes.

  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

    Ser-lhe-á pedido para introduzir os seguintes valores de parâmetro:

    • serviceBusNamespaceName: nome do espaço de nomes do Service Bus.
    • serviceBusQueueName: nome da Fila.

    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

Veja o tópico seguinte que mostra como criar uma regra de autorização para o espaço de nomes/fila:

Criar uma regra de autorização do Service Bus para o espaço de nomes e a fila com um modelo do ARM

Saiba como gerir estes recursos ao ver estes artigos: