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

Artigo
03/05/2024

Este artigo mostra como usar um modelo do Azure Resource Manager (modelo ARM) 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. Pode utilizar este modelo para as suas próprias implementações ou personalizá-lo para satisfazer as suas necessidades.

Um modelo do Azure Resource Manager é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do seu projeto. O modelo utiliza sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

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 será aberto no portal do Azure.

Pré-requisitos

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

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.9.1.41621",
      "templateHash": "724589808436302889"
    }
  },
  "parameters": {
    "serviceBusNamespaceName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Service Bus namespace"
      }
    },
    "serviceBusQueueName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Queue"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources."
      }
    }
  },
  "resources": [
    {
      "type": "Microsoft.ServiceBus/namespaces",
      "apiVersion": "2022-01-01-preview",
      "name": "[parameters('serviceBusNamespaceName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard"
      },
      "properties": {}
    },
    {
      "type": "Microsoft.ServiceBus/namespaces/queues",
      "apiVersion": "2022-01-01-preview",
      "name": "[format('{0}/{1}', parameters('serviceBusNamespaceName'), parameters('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
      },
      "dependsOn": [
        "[resourceId('Microsoft.ServiceBus/namespaces', parameters('serviceBusNamespaceName'))]"
      ]
    }
  ]
}

Os recursos definidos no modelo incluem:

Nota

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

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

Implementar o modelo

Com esse modelo, 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.

Para executar a implantação automaticamente, clique no seguinte botão: Crie um novo grupo de recursos para a implantação para que você possa limpar facilmente mais tarde.

Validar a implementação

Selecione Notificações na parte superior para ver o status da implantação. Aguarde até que a implantação seja bem-sucedida. Em seguida, selecione Ir para o grupo de recursos na mensagem de notificação para navegar até a página do grupo de recursos que contém o namespace do Service Bus.
Confirme que você vê seu namespace do Service Bus na lista de recursos.
Selecione o namespace na lista para ver a página Namespace do Service Bus.

Clean up resources (Limpar recursos)

No portal do Azure, navegue até a página Grupo de recursos do seu grupo de recursos.
Selecione Eliminar grupo de recursos na barra de ferramentas.
Digite o nome do grupo de recursos e selecione Excluir.

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:

Partilhar via