Руководство. Использование шаблонов Azure Resource ManagerTutorial: Utilize the Azure Resource Manager template reference

Узнайте, как найти информацию о схеме шаблона и использовать ее для создания шаблонов Azure Resource Manager.Learn how to find the template schema information, and use the information to create Azure Resource Manager templates.

В этом руководстве вы используете базовый шаблон из шаблонов быстрого запуска Azure.In this tutorial, you use a base template from Azure Quickstart templates. С помощью шаблонов справочной документации можно настроить шаблон, чтобы создать зашифрованную учетную запись хранения.Using template reference documentation, you customize the template to create an encrypted Storage account.

Справочник по шаблонам Resource Manager: развернуть зашифрованную учетную запись хранения

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

  • Открытие шаблона быстрого запускаOpen a Quickstart template
  • Общие сведения о шаблонеUnderstand the template
  • Поиск ссылки на шаблонFind the template reference
  • Изменение шаблонаEdit the template
  • Развертывание шаблонаDeploy the template

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

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

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

Открытие шаблона быстрого запускаOpen a Quickstart template

Шаблоны быстрого запуска Azure — это репозиторий для шаблонов Resource Manager.Azure QuickStart Templates is a repository for Resource Manager templates. Вместо создания шаблона с нуля можно найти пример шаблона и настроить его.Instead of creating a template from scratch, you can find a sample template and customize it. Шаблон, используемый в этом кратком руководстве, называется Create a standard storage account (Создание стандартной учетной записи хранения).The template used in this quickstart is called Create a standard storage account. Шаблон определяет ресурс учетной записи службы хранилища Azure.The template defines an Azure Storage account resource.

  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. Выберите Файл>Сохранить как, чтобы сохранить файл в качестве azuredeploy.json на локальном компьютере.Select File>Save As to save the file as azuredeploy.json to your local computer.

Изучение схемыUnderstand the schema

  1. Из VS Code сверните шаблон до корневого уровня.From VS Code, collapse the template to the root level. Имеется простейшая структура со следующими элементами.You have the simplest structure with the following elements:

    Простейшая структура шаблона Resource Manager

    • Параметр $schema указывает расположение файла схемы JSON, который описывает версию языка шаблона.$schema: specify the location of the JSON schema file that describes the version of the template language.
    • Параметр contentVersion задает этому элементу любое значение, чтобы документировать важные изменения в шаблоне.contentVersion: specify any value for this element to document significant changes in your template.
    • Параметр parameters указывает значения, которые предоставляются при выполнении развертывания для настройки развертывания ресурсов.parameters: specify the values that are provided when deployment is executed to customize resource deployment.
    • Параметр variables указывает значения, используемые в виде фрагментов JSON в шаблоне для упрощения выражений на языке шаблона.variables: specify the values that are used as JSON fragments in the template to simplify template language expressions.
    • Параметр resources указывает типы ресурсов, которые развертываются или обновляются в группе ресурсов.resources: specify the resource types that are deployed or updated in a resource group.
    • Параметр outputs указывает значения, возвращаемые после развертывания.outputs: specify the values that are returned after deployment.
  2. Разверните раздел resources.Expand resources. Вы увидите определенный ресурс Microsoft.Storage/storageAccounts.There is a Microsoft.Storage/storageAccounts resource defined. Этот шаблон создает незашифрованную учетную запись хранения.The template creates a non-encrypted Storage account.

    Определение учетной записи хранения в шаблоне Resource Manager

Поиск ссылки на шаблонFind the template reference

  1. Перейти к справочнику по шаблонам Azure.Browse to Azure Template reference.

  2. В поле Фильтр по названию введите учетные записи хранения.In the Filter by title box, enter storage accounts.

  3. Последовательно выберите "Справочник", "Справочник по шаблонам", "Хранилище", <"Версия">"Учетные записи хранения", как показано на приведенном ниже снимке экрана.Select Reference/Template reference/Storage/<Version>/Storage Accounts as shown in the following screenshot:

    Учетная запись хранения ссылки на шаблон Resource Manager

    Если вы не знаете, какую выбрать версию, используйте последнюю.If you don't know which version to choose, use the latest version.

  4. Найдите информацию о шифровании в определениях.Find the encryption-related definition information.

    "encryption": {
      "services": {
        "blob": {
          "enabled": boolean
        },
        "file": {
          "enabled": boolean
        }
      },
      "keySource": "string",
      "keyvaultproperties": {
        "keyname": "string",
        "keyversion": "string",
        "keyvaulturi": "string"
      }
    },
    

    На той же веб-странице следующее описание подтверждает, что объект encryption используется для создания зашифрованной учетной записи хранения.On the same web page, the following description confirms the encryption object is used to create an encrypted storage account.

    Ссылка на шаблон Resource Manager: шифрование учетной записи хранения

    Ключом шифрования можно управлять двумя способами.And there are two ways for managing the encryption key. Вы можете использовать ключи шифрования с шифрованием службы хранилища, управляемые корпорацией Майкрософт, или собственные ключи шифрования.You can use Microsoft-managed encryption keys with Storage Service Encryption, or you can use your own encryption keys. Для простоты этого руководства мы используем параметр Microsoft.Storage, так что вам не нужно создавать Azure Key Vault.To keep this tutorial simple, you use the Microsoft.Storage option, so you don't have to create an Azure Key Vault.

    Ссылка на шаблон Resource Manager: объект шифрования учетной записи хранения

    Объект шифрования должен выглядеть следующим образом:Your encryption object shall look like:

    "encryption": {
        "services": {
            "blob": {
                "enabled": true
            },
            "file": {
              "enabled": true
            }
        },
        "keySource": "Microsoft.Storage"
    }
    

Изменение шаблонаEdit the template

В Visual Studio Code измените шаблон, чтобы элемент ресурсов выглядел так:From Visual Studio Code, modify the template so that the resources element looks like:

Зашифрованные ресурсы учетной записи хранения шаблона Resource Manager

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

Дополнительные сведения о развертывании шаблона см. в кратком руководстве по Visual Studio Code.Refer to the Deploy the template section in the Visual Studio Code quickstart for the deployment procedure.

На следующем рисунке показаны команды CLI для вывода созданной учетной записи хранения. Это означает, что для хранилища BLOB-объектов включено шифрование.The following screenshot shows the CLI command for listing the newly created storage account, which indicates encryption has been enabled for the blob storage.

Зашифрованная учетная запись хранения 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

В этом руководстве описано, как использовать справочник по шаблонам для настройки существующего шаблона.In this tutorial, you learned how to use template reference to customize an existing template. Узнайте, как создать несколько экземпляров учетной записи храненияTo learn how to create multiple storage account instances, see: