Прочитать на английском

Поделиться через

Учебник по развертыванию шаблона ARM в локальной среде

  • Статья

Узнайте, как развернуть шаблон Azure Resource Manager (шаблон ARM) на локальном компьютере. Выполнение занимает около 8 минут.

Этот учебник первый в серии. По мере выполнения серии вы модульизируете шаблон путем создания связанного шаблона, хранения связанного шаблона в учетной записи хранения, защиты связанного шаблона с помощью маркера SAS и узнайте, как создать конвейер DevOps для развертывания шаблонов. Эта серия посвящена развертыванию шаблона. Если вы хотите изучить разработку шаблонов, ознакомьтесь с Руководством для начинающих.

Получение средств

Убедитесь, что у вас есть инструменты, необходимые для развертывания шаблонов.

Развертывание из командной строки

Чтобы развернуть шаблон, вам потребуется Azure PowerShell или Azure CLI. Ознакомьтесь с инструкциями по установке:

После установки Azure PowerShell или Azure CLI впервые выполните вход. Дополнительные сведения см. в разделах для PowerShell или Azure CLI.

Редактор (необязательно)

Шаблоны — это файлы JSON. Чтобы просмотреть или изменить шаблоны, вам нужен хороший редактор JSON. Рекомендуется использовать Visual Studio Code с расширением средств Resource Manager. Если необходимо установить эти средства, см. статью Краткое руководство. Создание шаблонов ARM с помощью Visual Studio Code.

Проверка шаблона

Шаблон развертывает учетную запись хранения, план службы приложений и веб-приложение. Если вы хотите создать шаблон, ознакомьтесь с руководством по шаблонам быстрого запуска. Однако вам не нужно создавать шаблон, чтобы завершить работу с этим руководством.

JSON 
{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "projectName": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11,
      "metadata": {
        "description": "Specify a project name that is used to generate resource names."
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Specify a location for the resources."
      }
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ],
      "metadata": {
        "description": "Specify the storage account type."
      }
    },
    "linuxFxVersion": {
      "type": "string",
      "defaultValue": "php|7.0",
      "metadata": {
        "description": "Specify the Runtime stack of current web app"
      }
    }
  },
  "variables": {
    "storageAccountName": "[format('{0}{1}', parameters('projectName'), uniqueString(resourceGroup().id))]",
    "webAppName": "[format('{0}WebApp', parameters('projectName'))]",
    "appServicePlanName": "[format('{0}Plan', parameters('projectName'))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2023-01-01",
      "name": "[variables('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2022-09-01",
      "name": "[variables('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "B1",
        "tier": "Basic",
        "size": "B1",
        "family": "B",
        "capacity": 1
      },
      "kind": "linux",
      "properties": {
        "perSiteScaling": false,
        "reserved": true,
        "targetWorkerCount": 0,
        "targetWorkerSizeId": 0
      }
    },
    {
      "type": "Microsoft.Web/sites",
      "apiVersion": "2022-09-01",
      "name": "[variables('webAppName')]",
      "location": "[parameters('location')]",
      "kind": "app",
      "properties": {
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanName'))]",
        "siteConfig": {
          "linuxFxVersion": "[parameters('linuxFxVersion')]"
        }
      },
      "dependsOn": [
        "[resourceId('Microsoft.Web/serverfarms', variables('appServicePlanName'))]"
      ]
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName')), '2023-01-01').primaryEndpoints]"
    }
  }
}

Важно!

Имя учетной записи хранения должно быть уникальным, содержать от 3 до 24 символов и состоять только из цифр и букв нижнего регистра. Переменная storageAccountName примера шаблона сочетает максимальное значение параметра projectName, равное 11 символам, со значением uniqueString, равным 13 символам.

Сохраните копию шаблона на локальном компьютере с расширением JSON, например azuredeploy.json. Этот шаблон развертывается далее в этом руководстве.

Вход в Azure

Чтобы начать работу с Azure PowerShell или Azure CLI для развертывания шаблона, выполните вход, используя данные своей учетной записи в Azure.

Azure PowerShell 
Connect-AzAccount

Если у вас несколько подписок Azure, выберите ту, которую хотите использовать. Замените [SubscriptionID/SubscriptionName] и квадратные скобки [] сведениями о подписке:

Azure PowerShell 
Set-AzContext [SubscriptionID/SubscriptionName]

Создать группу ресурсов

При развертывании шаблона необходимо указать группу ресурсов для ресурсов. Перед выполнением команды развертывания создайте группу ресурсов с помощью Azure CLI или Azure PowerShell. Чтобы выбрать между Azure PowerShell и Azure CLI, выберите вкладки в следующем разделе кода. Примеры интерфейса командной строки в этой статье написаны для оболочки bash.

Azure PowerShell 
$projectName = Read-Host -Prompt "Enter a project name that is used to generate resource and resource group names"
$resourceGroupName = "${projectName}rg"

New-AzResourceGroup `
  -Name $resourceGroupName `
  -Location "Central US"

Развертывание шаблона

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

Azure PowerShell 
$projectName = Read-Host -Prompt "Enter the same project name"
$templateFile = Read-Host -Prompt "Enter the template file path and file name"
$resourceGroupName = "${projectName}rg"

New-AzResourceGroupDeployment `
  -Name DeployLocalTemplate `
  -ResourceGroupName $resourceGroupName `
  -TemplateFile $templateFile `
  -projectName $projectName `
  -verbose

Дополнительные сведения о развертывании шаблона с помощью Azure PowerShell см. в статье Развертывание ресурсов с использованием шаблонов ARM и Azure PowerShell.

Очистка ресурсов

Чтобы очистить развернутые ресурсы, удалите группу ресурсов.

  1. На портале Azure в меню слева выберите Группа ресурсов.
  2. В поле Фильтровать по имени введите имя группы ресурсов.
  3. Выберите имя группы ресурсов.
  4. В главном меню выберите Удалить группу ресурсов.

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

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

Развертывание связанного шаблона