Что такое ARM Templates?

Azure Resource Manager (ARM) Templates — это JSON файлы, которые определяют инфраструктуру и конфигурацию для Azure проектов. ARM Templates позволяют декларативно описать ресурсы Azure и их зависимости, обеспечивая воспроизводимые и консистентные развертывания в облаке Microsoft Azure.

Основные возможности ARM Templates

Declarative syntax — описание желаемого состояния инфраструктуры
Idempotency — безопасное повторное выполнение развертывания
Dependency management — автоматическое управление зависимостями
Parallel deployment — параллельное создание ресурсов
Validation — проверка шаблона перед развертыванием
Modularity — связанные и вложенные шаблоны

Структура ARM Template

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    // Входные параметры
  },
  "variables": {
    // Переменные для вычислений
  },
  "functions": {
    // Пользовательские функции
  },
  "resources": [
    // Ресурсы Azure для создания
  ],
  "outputs": {
    // Возвращаемые значения
  }
}

Пример ARM Template

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storageAccountName": {
      "type": "string",
      "metadata": {
        "description": "Name of the storage account"
      }
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]",
      "metadata": {
        "description": "Location for all resources"
      }
    },
    "storageAccountType": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_ZRS",
        "Premium_LRS"
      ],
      "metadata": {
        "description": "Storage account type"
      }
    }
  },
  "variables": {
    "storageAccountName": "[toLower(parameters('storageAccountName'))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-04-01",
      "name": "[variables('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageAccountType')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true,
        "minimumTlsVersion": "TLS1_2",
        "allowBlobPublicAccess": false
      }
    }
  ],
  "outputs": {
    "storageAccountName": {
      "type": "string",
      "value": "[variables('storageAccountName')]"
    },
    "primaryEndpoint": {
      "type": "string",
      "value": "[reference(resourceId('Microsoft.Storage/storageAccounts', variables('storageAccountName'))).primaryEndpoints.blob]"
    }
  }
}

Развертывание ARM Templates

# Azure CLI
# Создание resource group
az group create --name myResourceGroup --location "East US"

# Развертывание шаблона
az deployment group create \
  --resource-group myResourceGroup \
  --template-file template.json \
  --parameters storageAccountName=mystorageaccount

# Развертывание с файлом параметров
az deployment group create \
  --resource-group myResourceGroup \
  --template-file template.json \
  --parameters @parameters.json

# Проверка шаблона без развертывания
az deployment group validate \
  --resource-group myResourceGroup \
  --template-file template.json \
  --parameters storageAccountName=mystorageaccount

# Просмотр развертываний
az deployment group list --resource-group myResourceGroup

PowerShell команды

# Подключение к Azure
Connect-AzAccount

# Создание resource group
New-AzResourceGroup -Name "myResourceGroup" -Location "East US"

# Развертывание шаблона
New-AzResourceGroupDeployment `
  -ResourceGroupName "myResourceGroup" `
  -TemplateFile "template.json" `
  -storageAccountName "mystorageaccount"

# Тестирование шаблона
Test-AzResourceGroupDeployment `
  -ResourceGroupName "myResourceGroup" `
  -TemplateFile "template.json" `
  -storageAccountName "mystorageaccount"

# Просмотр развертываний
Get-AzResourceGroupDeployment -ResourceGroupName "myResourceGroup"

Linked Templates пример

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "projectName": {
      "type": "string"
    }
  },
  "variables": {
    "linkedTemplateUri": "https://mystorageaccount.blob.core.windows.net/templates/storage-template.json"
  },
  "resources": [
    {
      "type": "Microsoft.Resources/deployments",
      "apiVersion": "2019-10-01",
      "name": "linkedTemplate",
      "properties": {
        "mode": "Incremental",
        "templateLink": {
          "uri": "[variables('linkedTemplateUri')]",
          "contentVersion": "1.0.0.0"
        },
        "parameters": {
          "storageAccountName": {
            "value": "[concat(parameters('projectName'), 'storage')]"
          }
        }
      }
    }
  ]
}

Bicep как альтернатива

Microsoft разработал Bicep как более простую альтернативу ARM Templates:

// storage.bicep
param storageAccountName string
param location string = resourceGroup().location
param storageAccountType string = 'Standard_LRS'

resource storageAccount 'Microsoft.Storage/storageAccounts@2021-04-01' = {
  name: toLower(storageAccountName)
  location: location
  sku: {
    name: storageAccountType
  }
  kind: 'StorageV2'
  properties: {
    supportsHttpsTrafficOnly: true
    minimumTlsVersion: 'TLS1_2'
    allowBlobPublicAccess: false
  }
}

output storageAccountName string = storageAccount.name
output primaryEndpoint string = storageAccount.properties.primaryEndpoints.blob

Когда использовать ARM Templates

Управление Azure инфраструктурой как кодом
Автоматизация развертывания в Azure
Создание воспроизводимых сред
CI/CD пайплайны для Azure ресурсов
Governance и compliance в Azure
Disaster recovery планы

Преимущества ARM Templates

Нативная интеграция с Azure
Декларативный подход
Автоматическое управление зависимостями
Параллельное развертывание ресурсов
Встроенная валидация
Интеграция с Azure DevOps и GitHub Actions

Ограничения ARM Templates

Работает только с Azure (vendor lock-in)
JSON синтаксис может быть многословным
Ограниченная логика по сравнению с программными языками
Сложность отладки больших шаблонов
Не все Azure сервисы поддерживаются сразу

Best Practices

Используй параметры для переиспользования шаблонов
Создавай модульные шаблоны с linked templates
Добавляй metadata и описания
Используй переменные для сложных выражений
Версионируй шаблоны в системе контроля версий
Тестируй шаблоны в dev окружении
Рассмотри использование Bicep для новых проектов

FAQ

Подходят ли ARM Templates для продакшена?

Да, ARM Templates широко используются в production средах и являются рекомендуемым Microsoft способом управления Azure инфраструктурой.

В чем разница между ARM Templates и Bicep?

Bicep — это более простой DSL, который компилируется в ARM Templates. Bicep предоставляет лучший опыт разработки с более читаемым синтаксисом.

Можно ли управлять существующими ресурсами?

Да, можно импортировать существующие Azure ресурсы в ARM Templates или использовать incremental deployment mode для управления частью ресурсов.

Что такое ARM Templates?

Azure Resource Manager шаблоны для декларативного развертывания ресурсов