Início Rápido: Criar um espaço de nomes do Service Bus com tópico e subscrição com um modelo do Azure Resource Manager

  • Artigo

Este artigo mostra como utilizar um modelo do Azure Resource Manager que cria um espaço de nomes do Service Bus e um tópico e uma subscrição 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 modelo para as suas próprias implementações ou personalizá-lo para satisfazer as suas necessidades

Para obter mais informações sobre a criação de modelos, consulte Authoring Azure Resource Manager templates (Criar modelos do Azure Resource Manager).

Para obter o modelo completo, veja o espaço de nomes do Service Bus com o tópico e o modelo de subscrição.

Nota

Os seguintes modelos de Resource Manager do Azure estão disponíveis para transferência e implementação.

Para procurar os modelos mais recentes, visite a galeria Modelos de Início Rápido do Azure e procure Service Bus.

O que implementa?

Com este modelo, vai implementar um espaço de nomes do Service Bus com tópico e subscrição.

Os tópicos e subscrições do Service Bus fornecem uma forma de comunicação um-para-muitos, num padrão de publicação/subscrição .

Para executar automaticamente a implementação, clique no seguinte botão:

Implementar no Azure

Parâmetros

Com o Azure Resource Manager, define parâmetros para os valores que pretende especificar quando o modelo é implementado. O modelo inclui uma secção denominada Parameters que contém todos os valores de parâmetros. Defina um parâmetro para esses valores que variam com base no projeto que está a implementar ou com base no ambiente no qual está a implementar. Não defina parâmetros para valores que permanecem sempre iguais. Cada valor de parâmetro é utilizado no modelo para definir os recursos que são implementados.

O modelo define os seguintes parâmetros:

serviceBusNamespaceName

O nome do espaço de nomes do Service Bus a criar.

"serviceBusNamespaceName": {
"type": "string"
}

serviceBusTopicName

O nome do tópico criado no espaço de nomes do Service Bus.

"serviceBusTopicName": {
"type": "string"
}

serviceBusSubscriptionName

O nome da subscrição criada no espaço de nomes do Service Bus.

"serviceBusSubscriptionName": {
"type": "string"
}

serviceBusApiVersion

A versão da API do Service Bus do modelo.

"serviceBusApiVersion": {
       "type": "string",
       "defaultValue": "2017-04-01",
       "metadata": {
           "description": "Service Bus ApiVersion used by the template"
       }

Recursos a implementar

Cria um espaço de nomes padrão do Service Bus do tipo Mensagens, com tópico e subscrição.

"resources": [{
        "apiVersion": "[variables('sbVersion')]",
        "name": "[parameters('serviceBusNamespaceName')]",
        "type": "Microsoft.ServiceBus/Namespaces",
        "location": "[variables('location')]",
        "kind": "Messaging",
        "sku": {
            "name": "Standard",
        },
        "resources": [{
            "apiVersion": "[variables('sbVersion')]",
            "name": "[parameters('serviceBusTopicName')]",
            "type": "Topics",
            "dependsOn": [
                "[concat('Microsoft.ServiceBus/namespaces/', parameters('serviceBusNamespaceName'))]"
            ],
            "properties": {
                "path": "[parameters('serviceBusTopicName')]",
            },
            "resources": [{
                "apiVersion": "[variables('sbVersion')]",
                "name": "[parameters('serviceBusSubscriptionName')]",
                "type": "Subscriptions",
                "dependsOn": [
                    "[parameters('serviceBusTopicName')]"
                ],
                "properties": {}
            }]
        }]
    }]

Para obter a sintaxe e as propriedades JSON, veja espaços de nomes, tópicos e subscrições.

Comandos para executar a implementação

Para implementar os recursos no Azure, deve ter a sessão iniciada na sua conta do Azure e deve utilizar o módulo do Azure Resource Manager. Para saber mais sobre como utilizar o Azure Resource Manager com o Azure PowerShell ou com a CLI do Azure, veja:

Os exemplos seguintes partem do princípio em como já tem um grupo de recursos na sua conta com o nome especificado.

PowerShell

New-AzureResourceGroupDeployment -Name \<deployment-name\> -ResourceGroupName \<resource-group-name\> -TemplateUri <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/quickstarts/microsoft.servicebus/servicebus-create-topic-and-subscription/azuredeploy.json>

CLI do Azure

az deployment group create \<my-resource-group\> --name \<my-deployment-name\> --template-uri <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/quickstarts/microsoft.servicebus/servicebus-create-topic-and-subscription/azuredeploy.json>

Passos seguintes

Agora que criou e implementou recursos com o Azure Resource Manager, saiba como gerir estes recursos ao ver estes artigos: