Руководство по Устранение неполадок развертывания шаблонов Resource ManagerTutorial: Troubleshoot Resource Manager template deployments

Узнайте, как устранять неполадки при развертывании шаблонов Resource Manager.Learn how to troubleshoot Resource Manager template deployment errors. В этом руководстве вы настроите две ошибки в шаблоне и узнаете, как использовать журналы операций и историю развертывания для решения ошибок.In this tutorial, you set up two errors in a template, and learn how to use the activity logs and deployment history to resolve the issues.

Существует два типа ошибок, связанных с развертыванием шаблона.There are two types of errors that are related to template deployment:

  • Ошибки проверки возникают в сценариях, которые можно определить перед развертыванием.Validation errors arise from scenarios that can be determined before deployment. Это синтаксические ошибки в шаблоне или попытки развертывания ресурсов, которые приведут к превышению квот для подписки.They include syntax errors in your template, or trying to deploy resources that would exceed your subscription quotas.
  • Ошибки развертывания возникают из-за условий, возникающих во время развертывания.Deployment errors arise from conditions that occur during the deployment process. Это попытки получить доступ к ресурсу, который развертывается параллельно.They include trying to access a resource that is being deployed in parallel.

Ошибки обоих типов возвращают код ошибки, с помощью которого можно устранить неполадки развертывания.Both types of errors return an error code that you use to troubleshoot the deployment. Ошибки обоих типов отображаются в журнале действий.Both types of errors appear in the activity log. Однако ошибки проверки не отображаются в журнале развертывания, так как при их наличии развертывание не запускается.However, validation errors don't appear in your deployment history because the deployment never started.

В рамках этого руководства рассматриваются следующие задачи:This tutorial covers the following tasks:

  • Создание проблемного шаблонаCreate a problematic template
  • Устранение ошибок проверкиTroubleshoot validation errors
  • Устранение ошибок развертыванияTroubleshoot deployment errors
  • Очистка ресурсовClean up resources

Если у вас еще нет подписки Azure, создайте бесплатную учетную запись Azure, прежде чем начинать работу.If you don't have an Azure subscription, create a free account before you begin.

Примечание

Эта статья была изменена и теперь содержит сведения о новом модуле Az для Azure PowerShell.This article has been updated to use the new Azure PowerShell Az module. Вы по-прежнему можете использовать модуль AzureRM, исправления ошибок для которого будут продолжать выпускаться как минимум до декабря 2020 г.You can still use the AzureRM module, which will continue to receive bug fixes until at least December 2020. Дополнительные сведения о совместимости модуля Az с AzureRM см. в статье Introducing the new Azure PowerShell Az module (Знакомство с новым модулем Az для Azure PowerShell).To learn more about the new Az module and AzureRM compatibility, see Introducing the new Azure PowerShell Az module. Инструкции по установке модуля Az см. в статье об установке Azure PowerShell.For Az module installation instructions, see Install Azure PowerShell.

Предварительные требованияPrerequisites

Для работы с этой статьей необходимо иметь следующее.To complete this article, you need:

Создание проблемного шаблонаCreate a problematic template

Откройте шаблон Создайте стандартную учетную запись хранения из Шаблонов быстрого запуска Azure и настройте две ошибки шаблона.Open a template called Create a standard storage account from Azure QuickStart Templates, and setup two template issues.

  1. В Visual Studio Code выберите Файл>Открыть файл.From Visual Studio Code, select File>Open File.

  2. Скопируйте приведенный ниже URL-адрес и вставьте его в поле Имя файла.In File name, paste the following URL:

    https://raw.githubusercontent.com/Azure/azure-quickstart-templates/master/101-storage-account-create/azuredeploy.json
    
  3. Чтобы открыть файл, выберите Открыть.Select Open to open the file.

  4. Измените строку apiVersion на следующую.Change the apiVersion line to the following line:

    "apiVersion1": "2018-07-02",
    
    • apiVersion1 является недопустимым именем элемента.apiVersion1 is invalid element name. Это ошибка проверки.It is a validation error.
    • Версия API должна быть "2018-07-01".The API version shall be "2018-07-01". Это ошибка развертывания.It is a deployment error.
  5. Выберите Файл>Сохранить как, чтобы сохранить файл в качестве azuredeploy.json на локальном компьютере.Select File>Save As to save the file as azuredeploy.json to your local computer.

Устранение ошибки проверкиTroubleshoot the validation error

Дополнительные сведения о процедуре развертывания шаблона см. в этом разделе.Refer to the Deploy the template section to deploy the template.

Вы получите сообщение об ошибке следующего содержания.You shall get an error from the shell similar to:

New-AzResourceGroupDeployment : 4:29:24 PM - Error: Code=InvalidRequestContent; Message=The request content was invalid and could not be deserialized: 'Could not find member 'apiVersion1' on object of type 'TemplateResource'. Path 'properties.template.resources[0].apiVersion1', line 36, position 24.'.

Сообщение об ошибке указывает, что проблема связана с apiVersion1.The error message indicates the problem is with apiVersion1.

Чтобы устранить проблему, используйте Visual Studio Code, изменив apiVersion1 на apiVersion, а затем сохраните шаблон.Use Visual Studio Code to correct the problem by changing apiVersion1 to apiVersion, and then save the template.

Устранение ошибки развертыванияTroubleshoot the deployment error

Дополнительные сведения о процедуре развертывания шаблона см. в этом разделе.Refer to the Deploy the template section to deploy the template.

Вы получите сообщение об ошибке следующего содержания.You shall get an error from the shell similar to:

New-AzResourceGroupDeployment : 4:48:50 PM - Resource Microsoft.Storage/storageAccounts 'storeqii7x2rce77dc' failed with message '{
  "error": {
    "code": "NoRegisteredProviderFound",
    "message": "No registered resource provider found for location 'centralus' and API version '2018-07-02' for type 'storageAccounts'. The supported api-versions are '2018-07-01, 2018-03-01-preview, 2018-02-01, 2017-10-01, 2017-06-01, 2016-12-01, 2016-05-01, 2016-01-01, 2015-06-15, 2015-05-01-preview'. The supported locations are 'eastus, eastus2, westus, westeurope, eastasia, southeastasia, japaneast, japanwest, northcentralus, southcentralus, centralus, northeurope, brazilsouth, australiaeast, australiasoutheast, southindia, centralindia, westindia, canadaeast, canadacentral, westus2, westcentralus, uksouth, ukwest, koreacentral, koreasouth, francecentral'."
  }
}'

Ошибку развертывания можно найти на портале Azure с помощью следующей процедуры.The deployment error can be found from the Azure portal using the following procedure:

  1. Войдите на портале Azure.Sign in to the Azure portal.

  2. Откройте Группы ресурсов, а затем введите имя группы ресурсов.Open the resource group by selecting Resource groups and then the resource group name. Отобразится 1 Failed в разделе Развертывание.You shall see 1 Failed under Deployment.

    Устранение неполадок руководства Resource Manager

  3. Выберите Сведения об ошибке.Select Error details.

    Устранение неполадок руководства Resource Manager

    Сообщение об ошибке совпадает с сообщением, показанным ранее.The error message is the same as the one shown earlier:

    Устранение неполадок руководства Resource Manager

Также можно найти ошибки в журналах действий.You can also find the error from the activity logs:

  1. Войдите на портале Azure.Sign in to the Azure portal.

  2. Выберите Монитор > Журнал действий.Select Monitor > Activity log.

  3. Используйте фильтры для поиска журнала.Use the filters to find the log.

    Устранение неполадок руководства Resource Manager

Используйте Visual Studio Code для устранения проблемы, а затем повторно разверните шаблон.Use Visual Studio Code to correct the problem, and then redeploy the template.

Список распространенных ошибок см. в статье Устранение распространенных ошибок развертывания в Azure с помощью Azure Resource Manager.For a list of common errors, see Troubleshoot common Azure deployment errors with Azure Resource Manager.

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

Если ресурсы Azure больше не нужны, их можно удалить. Для этого необходимо удалить группу ресурсов.When the Azure resources are no longer needed, clean up the resources you deployed by deleting the resource group.

  1. На портале Azure в меню слева выберите Группа ресурсов.From the Azure portal, select Resource group from the left menu.
  2. В поле Filter by name (Фильтровать по имени) введите имя группы ресурсов.Enter the resource group name in the Filter by name field.
  3. Выберите имя группы ресурсов.Select the resource group name. В группе ресурсов должно появится шесть ресурсов.You shall see a total of six resources in the resource group.
  4. В главном меню выберите Удалить группу ресурсов.Select Delete resource group from the top menu.

Дополнительная информацияNext steps

В этом руководстве вы узнали, как устранять ошибки развертывания шаблона Resource Manager.In this tutorial, you learned how to troubleshoot Resource Manager template deployment errors. Дополнительные сведения см. в разделе Устранение распространенных ошибок развертывания в Azure с помощью Azure Resource Manager.For more information, see Troubleshoot common Azure deployment errors with Azure Resource Manager.