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

Článek
05/11/2023

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

Šablony Azure Resource Manager pomáhají definovat prostředky, které se mají nasadit pro řešení, a zadat parametry a proměnné, které umožňují 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 psaní šablon Azure Resource Manager a diskuzi o formátu šablon najdete v tématu Struktura a syntaxe šablon Azure Resource Manager.

Poznámka

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

Poznámka

K interakci s Azure doporučujeme použít modul Azure Az PowerShell. Začněte tím, že si projdete téma Instalace Azure PowerShellu. Informace o tom, jak migrovat na modul Az PowerShell, najdete v tématu Migrace Azure PowerShellu z AzureRM na Az.

Šablony Resource Manager služby Service Bus

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

Nasazení s využitím PowerShellu

Následující postup popisuje, jak pomocí PowerShellu nasadit šablonu Azure Resource Manager, která vytvoří obor názvů Service Bus úrovně Standard a frontu v rámci tohoto oboru názvů. Tento příklad je založený na šabloně Vytvoření oboru názvů služby 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.
Vytvořte novou skupinu prostředků, pokud neexistuje.
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í šablon Azure Resource Manager.

Instalace PowerShellu

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

Vytvoření šablony

Naklonujte úložiště nebo zkopírujte šablonu servicebus-create-queue z GitHubu:

{
  "$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 soubor volitelných parametrů, zkopírujte soubor servicebus-create-queue . Nahraďte hodnotu serviceBusNamespaceName názvem oboru názvů služby Service Bus, který chcete v tomto nasazení vytvořit, a hodnotu serviceBusQueueName nahraďte názvem fronty, 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řihlaste se k Azure a nastavte předplatné 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í spusťte následující příkaz, který zobrazí dostupná předplatná:

Get-AzSubscription

Tento příkaz vrátí seznam dostupných předplatných Azure. Spuštěním následujícího příkazu zvolte předplatné pro aktuální relaci. Nahraďte <YourSubscriptionId> identifikátorem GUID pro předplatné 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. Pří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 Test-AzResourceGroupDeployment ověřte nasazení. Při testování nasazení zadejte parametry přesně jako při provádě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 New-AzResourceGroupDeployment a po zobrazení výzvy zadejte potřebné parametry. Mezi parametry patří název vašeho nasazení, název vaší skupiny prostředků a cesta nebo adresa URL k souboru šablony. Pokud parametr Mode není zadaný, 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

Při spuštění rutiny nasazení můžete také použít vložené parametry. 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 Hodnotu 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

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