Краткое руководство: создание пространства имен Служебной шины с темой и подпиской с помощью шаблона Azure Resource Manager

В этой статье показано, как использовать шаблон Azure Resource Manager, который создаёт пространство имён служебная шина, а также тему и подписку в этом пространстве имён. Здесь объясняется, как указать развертываемые ресурсы и определить параметры, указываемые при развертывании. Этот шаблон можно использовать для собственных развертываний или настроить его в соответствии с вашими требованиями.

Дополнительные сведения о создании шаблонов см. в статье Создание шаблонов Azure Resource Manager.

Полный шаблон пространства имен служебной шины с разделом и подпиской приведен здесь.

Примечание.

Для скачивания и развертывания можно использовать указанные ниже шаблоны диспетчера ресурсов Azure.

Чтобы узнать о новых шаблонах, в коллекции шаблонов быстрого запуска Azure выполните поиск по фразе служебная шина.

Что вы развертываете?

С помощью этого шаблона вы развертываете пространство имен служебная шина с темой и подпиской.

Темы и подписки служебная шина обеспечивают взаимодействие по модели «один ко многим» в рамках шаблона «издатель-подписчик».

Чтобы выполнить развертывание автоматически, нажмите следующую кнопку.

Развернуть в Azure

Параметры

С помощью диспетчера ресурсов Azure можно определить параметры значений, которые должны указываться на этапе развертывания шаблона. В шаблоне есть раздел Parameters , содержащий все значения параметров. Определите параметры для тех значений, которые зависят от развертываемого проекта либо от среды, в которую выполняется развертывание. Не определяйте параметры для значений, которые не меняются. Значение каждого параметра в шаблоне определяет развертываемые ресурсы.

Ниже описаны параметры, которые определяет шаблон.

serviceBusNamespaceName

Имя пространства имен служебная шина, которое требуется создать.

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

serviceBusTopicName

Имя темы, созданной в пространстве имен служебная шина.

Примечание.

Если имя темы содержит косую черту (/), используйте ~ (тильда) вместо / в параметре шаблона. Например, чтобы создать раздел с именем events/billing, укажите имя как events~billing. Подробнее см. Имена сущностей с прямыми косыми чертами.

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

serviceBusSubscriptionName

Имя подписки, созданной в пространстве имен служебная шина.

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

serviceBusApiVersion

Версия шаблона для API служебной шины.

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

Развертываемые ресурсы

Создает стандартное пространство имен служебной шины типа Messagingс разделом и подпиской.

"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": [
                    "[concat('Microsoft.ServiceBus/namespaces/', parameters('serviceBusNamespaceName'), '/Topics/', parameters('serviceBusTopicName'))]"
                ],
                "properties": {}
            }]
        }]
    }]

Сведения о синтаксисе и свойствах JSON см. в статьях о пространствах имен, разделах и подписках.

Команды для выполнения развертывания

Чтобы развернуть ресурсы в Azure, необходимо войти в учетную запись Azure и воспользоваться модулем Azure Resource Manager. Информацию об использовании диспетчера ресурсов Azure с помощью Azure PowerShell или интерфейса командной строки Azure см. в следующих статьях:

В приведенных ниже примерах предполагается, что в вашей учетной записи уже есть группа ресурсов с указанным именем.

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>

Azure CLI

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>

Следующие шаги

Теперь, когда вы создали и развернули ресурсы с помощью диспетчера ресурсов Azure, узнайте, как управлять этими ресурсами, изучив следующие статьи:

Примечание.

Сведения о создании разделов и подписок с помощью REST API см. в справочнике по REST API служебной шины для подписок.

  • Last updated on