Vytváření Service Bus prostředků pomocí Azure Resource Manager šablon

Článek
09/26/2021
4 min ke čtení

Tento článek popisuje, jak vytvořit a nasadit Service Bus prostředky pomocí Azure Resource Manager šablon, PowerShellu a poskytovatele Service Bus prostředků.

Azure Resource Manager vám pomohou definovat prostředky, které se mají nasadit pro řešení, a určit parametry a proměnné, které vám umožní zadat hodnoty pro různá prostředí. Šablona je napsaná ve formátu JSON a skládá se z výrazů, které můžete použít k vytvoření hodnot pro vaše nasazení. Podrobné informace o zápisu Azure Resource Manager šablony a diskusi o formátu šablony najdete v tématu struktura a syntaxe Azure Resource Manager šablonách.

Poznámka

Příklady v tomto článku ukazují, jak pomocí Azure Resource Manager vytvořit obor názvů Service Bus a entitu zasílání zpráv (frontu). Další příklady šablon najdete v galerii šablon Azure pro rychlý start a vyhledejte Service Bus.

Poznámka

Tento článek používá modul Azure Az PowerShell, což je doporučený modul PowerShellu pro interakci s Azure. Pokud chcete začít s modulem Az PowerShell, projděte si téma věnované instalaci Azure PowerShellu. Informace o tom, jak migrovat na modul Az PowerShell, najdete v tématu Migrace Azure PowerShellu z AzureRM na Az.

Service Bus Resource Manager šablony

Tyto Service Bus Azure Resource Manager šablony jsou k dispozici ke stažení a nasazení. Kliknutím na následující odkazy zobrazíte podrobnosti o každé z nich s odkazy na šablony v GitHub:

Nasazení s využitím PowerShellu

Následující postup popisuje, jak pomocí PowerShellu nasadit šablonu Azure Resource Manager, která vytvoří standardní vrstvu Service Bus oboru názvů a frontu v rámci tohoto oboru názvů. Tento příklad je založený na šabloně Vytvořit Service Bus s frontou. Přibližný pracovní postup je následující:

Nainstalujte PowerShell.
Vytvořte šablonu a (volitelně) soubor parametrů.
V PowerShellu se přihlaste ke svému účtu Azure.
Pokud neexistuje, vytvořte novou skupinu prostředků.
Otestujte nasazení.
V případě potřeby nastavte režim nasazení.
Nasazení šablony

Úplné informace o nasazení šablon Azure Resource Manager najdete v tématu Nasazení prostředků pomocí Azure Resource Manager šablon.

Instalace PowerShellu

Nainstalujte Azure PowerShell podle pokynů v tématu Začínáme s Azure PowerShell.

Vytvoření šablony

Naklonovat úložiště nebo zkopírovat šablonu servicebus-create-queue z GitHub:

{
  "$schema": "https://schema.management.azure.com/schemas/2014-04-01-preview/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "serviceBusNamespaceName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Service Bus namespace"
      }
    },
    "serviceBusQueueName": {
      "type": "string",
      "metadata": {
        "description": "Name of the Queue"
      }
    }
  },
  "variables": {
    "defaultSASKeyName": "RootManageSharedAccessKey",
    "authRuleResourceId": "[resourceId('Microsoft.ServiceBus/namespaces/authorizationRules', parameters('serviceBusNamespaceName'), variables('defaultSASKeyName'))]",
  "sbVersion": "2017-04-01"
  },
  "resources": [
    {
      "apiVersion": "2017-04-01",
      "name": "[parameters('serviceBusNamespaceName')]",
      "type": "Microsoft.ServiceBus/Namespaces",
      "location": "[resourceGroup().location]",
      "sku": {
        "name": "Standard"
      },
      "properties": {},
      "resources": [
        {
          "apiVersion": "2017-04-01",
          "name": "[parameters('serviceBusQueueName')]",
          "type": "Queues",
          "dependsOn": [
            "[concat('Microsoft.ServiceBus/namespaces/', parameters('serviceBusNamespaceName'))]"
          ],
          "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"
          }
        }
      ]
    }
  ],
  "outputs": {
    "NamespaceConnectionString": {
      "type": "string",
      "value": "[listkeys(variables('authRuleResourceId'), variables('sbVersion')).primaryConnectionString]"
    },
    "SharedAccessPolicyPrimaryKey": {
      "type": "string",
      "value": "[listkeys(variables('authRuleResourceId'), variables('sbVersion')).primaryKey]"
    }
  }
}

Vytvoření souboru parametrů (volitelné)

Pokud chcete použít volitelný soubor parametrů, zkopírujte soubor servicebus-create-queue. Nahraďte hodnotu názvem oboru názvů Service Bus, který chcete v tomto nasazení vytvořit, a nahraďte hodnotu názvem serviceBusNamespaceName fronty, serviceBusQueueName kterou chcete vytvořit.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "serviceBusNamespaceName": {
            "value": "<myNamespaceName>"
        },
        "serviceBusQueueName": {
            "value": "<myQueueName>"
        },
        "serviceBusApiVersion": {
            "value": "2017-04-01"
        }
    }
}

Další informace najdete v článku Parametry.

Přihlášení k Azure a nastavení předplatného Azure

Na příkazovém řádku PowerShellu spusťte následující příkaz:

Connect-AzAccount

Zobrazí se výzva k přihlášení ke svému účtu Azure. Po přihlášení spuštěním následujícího příkazu zobrazte dostupná předplatná:

Get-AzSubscription

Tento příkaz vrátí seznam dostupných předplatných Azure. Zvolte předplatné pro aktuální relaci spuštěním následujícího příkazu. Nahraďte <YourSubscriptionId> identifikátorem GUID předplatného Azure, které chcete použít:

Set-AzContext -SubscriptionID <YourSubscriptionId>

Nastavení skupiny prostředků

Pokud nemáte existující skupinu prostředků, vytvořte novou skupinu prostředků pomocí příkazu New-AzResourceGroup. Zadejte název skupiny prostředků a umístění, které chcete použít. Například:

New-AzResourceGroup -Name MyDemoRG -Location "West US"

V případě úspěchu se zobrazí souhrn nové skupiny prostředků.

ResourceGroupName : MyDemoRG
Location          : westus
ProvisioningState : Succeeded
Tags              :
ResourceId        : /subscriptions/<GUID>/resourceGroups/MyDemoRG

Otestování nasazení

Spuštěním rutiny ověřte Test-AzResourceGroupDeployment nasazení. Při testování nasazení zadejte parametry úplně stejně jako při spuštění nasazení.

Test-AzResourceGroupDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json

Vytvoření nasazení

Pokud chcete vytvořit nové nasazení, spusťte rutinu a po zobrazení výzvy New-AzResourceGroupDeployment zadejte potřebné parametry. Parametry zahrnují název vašeho nasazení, název skupiny prostředků a cestu nebo adresu URL k souboru šablony. Pokud parametr Mode nezadáte, použije se výchozí hodnota Přírůstkové. Další informace najdete v tématu Přírůstková a úplná nasazení.

Následující příkaz vás vyzve k zadání tří parametrů v okně PowerShellu:

New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json

Pokud chcete místo toho zadat soubor parametrů, použijte následující příkaz:

New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -TemplateParameterFile <path to parameters file>\azuredeploy.parameters.json

Vložené parametry můžete použít také při spuštění rutiny nasazení. Příkaz vypadá takto:

New-AzResourceGroupDeployment -Name MyDemoDeployment -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json -parameterName "parameterValue"

Pokud chcete spustit úplné nasazení, nastavte parametr Mode na Dokončeno:

New-AzResourceGroupDeployment -Name MyDemoDeployment -Mode Complete -ResourceGroupName MyDemoRG -TemplateFile <path to template file>\azuredeploy.json

Ověření nasazení

Pokud se prostředky úspěšně nasadí, zobrazí se v okně PowerShellu souhrn nasazení:

DeploymentName    : MyDemoDeployment
ResourceGroupName : MyDemoRG
ProvisioningState : Succeeded
Timestamp         : 4/19/2017 10:38:30 PM
Mode              : Incremental
TemplateLink      :
Parameters        :
                    Name             Type                       Value
                    ===============  =========================  ==========
                    serviceBusNamespaceName  String             <namespaceName>
                    serviceBusQueueName  String                 <queueName>
                    serviceBusApiVersion  String                2017-04-01

Další kroky

Viděli jste základní pracovní postup a příkazy pro nasazení Azure Resource Manager šablony. Podrobnější informace najdete na následujících odkazech: