Rychlý Start: vytvoření oboru názvů Service Bus a fronty pomocí šablony Azure Resource ManagerQuickstart: Create a Service Bus namespace and a queue using an Azure Resource Manager template

Tento článek ukazuje, jak použít šablonu Azure Resource Manager, která vytvoří obor názvů Service Bus a frontu v rámci tohoto oboru názvů.This article shows how to use an Azure Resource Manager template that creates a Service Bus namespace and a queue within that namespace. V tomto článku se dozvíte, jak určit, které prostředky se nasazují a jak definovat parametry, které jsou zadané při spuštění nasazení.The article explains how to specify which resources are deployed and how to define parameters that are specified when the deployment is executed. Tuto šablonu můžete použít pro vlastní nasazení nebo ji upravit, aby splňovala vaše požadavky.You can use this template for your own deployments, or customize it to meet your requirements.

Další informace o vytváření šablon najdete v tématu vytváření šablon Azure Resource Manager.For more information about creating templates, please see Authoring Azure Resource Manager templates.

Úplnou šablonu najdete v tématu Service Bus obor názvů a šablona fronty na GitHubu.For the complete template, see the Service Bus namespace and queue template on GitHub.

Poznámka

Následující šablony Azure Resource Manager jsou k dispozici ke stažení a nasazení.The following Azure Resource Manager templates are available for download and deployment.

Pokud chcete vyhledat nejnovější šablony, přejděte na galerii šablon Azure pro rychlý Start a vyhledejte Service Bus.To check for the latest templates, visit the Azure Quickstart Templates gallery and search for Service Bus.

Poznámka

Tento článek je aktualizovaný a využívá nový modul Az Azure PowerShellu.This article has been updated to use the new Azure PowerShell Az module. Můžete dál využívat modul AzureRM, který bude dostávat opravy chyb nejméně do prosince 2020.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Další informace o kompatibilitě nového modulu Az a modulu AzureRM najdete v tématu Seznámení s novým modulem Az Azure PowerShellu.To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Pokyny k instalaci modulu Az najdete v tématu věnovaném instalaci Azure PowerShellu.For Az module installation instructions, see Install Azure PowerShell.

Co budete nasazovat?What will you deploy?

Pomocí této šablony nasadíte obor názvů Service Bus s frontou.With this template, you deploy a Service Bus namespace with a queue.

Fronty Service Bus nabízejí doručování zpráv first in, First out (FIFO) do jednoho nebo více konkurenčních zákazníků.Service Bus queues offer First In, First Out (FIFO) message delivery to one or more competing consumers.

Pokud chcete nasazení spustit automaticky, klikněte na následující tlačítko:To run the deployment automatically, click the following button:

Nasazení do AzureDeploy to Azure

ParametryParameters

Pomocí Azure Resource Manageru definujete parametry pro hodnoty, které chcete zadat při nasazení šablony.With Azure Resource Manager, you define parameters for values you want to specify when the template is deployed. Šablona obsahuje oddíl s názvem Parameters, který obsahuje všechny hodnoty parametrů.The template includes a section called Parameters that contains all of the parameter values. Měli byste definovat parametr pro tyto hodnoty, které se budou lišit v závislosti na projektu, který nasazujete, nebo na základě prostředí, do kterého nasazujete.You should define a parameter for those values that will vary based on the project you are deploying or based on the environment you are deploying to. Nedefinujte parametry pro hodnoty, které budou vždycky zůstat stejné.Do not define parameters for values that will always stay the same. Každá hodnota parametru se v šabloně použije k definování nasazovaných prostředků.Each parameter value is used in the template to define the resources that are deployed.

Šablona definuje následující parametry.The template defines the following parameters.

serviceBusNamespaceNameserviceBusNamespaceName

Název oboru názvů Service Bus, který se má vytvořitThe name of the Service Bus namespace to create.

"serviceBusNamespaceName": {
"type": "string",
"metadata": { 
    "description": "Name of the Service Bus namespace" 
    }
}

serviceBusQueueNameserviceBusQueueName

Název fronty vytvořený v oboru názvů Service Bus.The name of the queue created in the Service Bus namespace.

"serviceBusQueueName": {
"type": "string"
}

serviceBusApiVersionserviceBusApiVersion

Verze Service Bus rozhraní API šablony.The Service Bus API version of the template.

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

Prostředky k nasazeníResources to deploy

Vytvoří obor názvů Standard Service Bus typu zasílání zprávs frontou.Creates a standard Service Bus namespace of type Messaging, with a queue.

{
    "resources": [{
        "apiVersion": "2017-04-01",
        "name": "[parameters('serviceBusNamespaceName')]",
        "type": "Microsoft.ServiceBus/namespaces",
        "location": "[parameters('location')]",
        "sku": {
            "name": "Standard"
        },
        "properties": {},
        "resources": [{
            "apiVersion": "[variables('sbVersion')]",
            "name": "[parameters('serviceBusQueueName')]",
            "type": "Queues",
            "dependsOn": [
                "[concat('Microsoft.ServiceBus/namespaces/', parameters('serviceBusNamespaceName'))]"
            ],
            "properties": {
                "path": "[parameters('serviceBusQueueName')]"
            }
        }]
    }]
}

Informace o syntaxi a vlastnostech JSON najdete v tématu obory názvů a fronty.For JSON syntax and properties, see namespaces and queues.

Příkazy pro spuštění nasazeníCommands to run deployment

Pokud chcete nasadit prostředky do Azure, musíte být přihlášení k účtu Azure a používat modul Azure Resource Manager.To deploy the resources to Azure, you must be signed in to your Azure account and you must use the Azure Resource Manager module. Další informace o použití Azure Resource Manageru s Azure PowerShellem nebo Azure CLI najdete v tématech:To learn about using Azure Resource Manager with either Azure PowerShell or Azure CLI, see:

Následující příklady předpokládají, že v účtu již máte skupinu prostředků s daným názvem.The following examples assume you already have a resource group in your account with the specified name.

PowerShellPowerShell

New-AzResourceGroupDeployment -ResourceGroupName \<resource-group-name\> -TemplateFile <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-servicebus-create-queue/azuredeploy.json>

Azure CLIAzure CLI

azure config mode arm

azure group deployment create \<my-resource-group\> \<my-deployment-name\> --template-uri <https://raw.githubusercontent.com/azure/azure-quickstart-templates/master/201-servicebus-create-queue/azuredeploy.json>

Další krokyNext steps

V následujícím tématu se dozvíte, jak vytvořit autorizační pravidlo pro obor názvů nebo frontu: Vytvoření autorizačního pravidla Service Bus pro obor názvů a frontu pomocí šablony Azure Resource ManagerSee the following topic that shows how to create an authorization rule for the namespace/queue: Create a Service Bus authorization rule for namespace and queue using an Azure Resource Manager template

Naučte se spravovat tyto prostředky zobrazením těchto článků:Learn how to manage these resources by viewing these articles: