Развертывание локальной среды Azure с помощью шаблона развертывания Azure Resource Manager

2025-07-07

В этой статье описано, как использовать шаблон Azure Resource Manager на портале Azure для развертывания Azure Local в вашей среде. В статье также содержатся предварительные требования и шаги подготовки, необходимые для начала развертывания.

Внимание

Развертывание шаблона Azure Resource Manager для систем Azure Local предназначено для масштабных развертываний. Целевая аудитория этого развертывания — ЭТО ИТ-администраторы, которые имеют опыт развертывания локальных экземпляров Azure. Сначала рекомендуется развернуть систему с помощью портала Azure, а затем выполнить последующие развертывания с помощью шаблона Resource Manager.

Предварительные условия

Завершение регистрации компьютеров с помощью Azure Arc и назначение разрешений развертывания. Убедитесь, что:
- Все компьютеры выполняют одну и ту же версию ОС.
- Все компьютеры имеют одинаковую конфигурацию сетевого адаптера.

Для локальных версий Azure 2411.3 и более ранних версий обязательно выберите шаблон create-cluster-2411.3 для развертывания.

Для локальных версий Azure 2503 и более поздних версий обязательно выберите шаблон создания кластера для развертывания.

Шаг 1. Подготовка ресурсов Azure

Выполните следующие действия, чтобы подготовить ресурсы Azure, необходимые для развертывания:

Создание учетной записи службы и секрета клиента

Для проверки подлинности системы необходимо создать служебный принципал и соответствующий секрет клиента для Arc Resource Bridge (ARB).

Создание субъекта-службы для ARB

Выполните действия, описанные в статье "Создать приложение Microsoft Entra и представителя службы для доступа к ресурсам через портал Azure" для создания представителя службы и назначения ролей. Кроме того, используйте процедуру PowerShell для создания субъекта-службы Azure с помощью Azure PowerShell.

Ниже приведены инструкции.

Войдите в Центр администрирования Microsoft Entra как минимум администратор облачных приложений. Перейдите к Идентификация > Приложения > Регистрация приложений, затем выберите Создать регистрацию.
Укажите имя приложения, выберите тип поддерживаемой учетной записи, и затем нажмите Зарегистрировать.
После создания служебного принципала перейдите на страницу корпоративных приложений. Найдите и выберите УЗС (участник-службы), который вы создали.
В разделе свойств скопируйте идентификатор приложения (клиента) и идентификатор объекта для этого субъекта-службы.

Идентификатор приложения (клиента) используется для параметра , а идентификатор объекта - для параметра arbDeploymentAppID в шаблоне Resource Manager.

Создание клиентского ключа для учетной записи службы ARB

Перейдите к регистрации приложения, которую вы создали, и откройте раздел >, затем — >.
Выберите + Новый клиент секрет.
Добавьте описание секрета клиента и укажите интервал времени, когда срок действия истекает. Нажмите кнопку "Добавить".
Скопируйте значение секрета клиента , так как вы будете его использовать позже.

Замечание

Для идентификатора клиента приложения потребуется секретное значение. Значения секрета клиента не могут просматриваться, за исключением сразу после создания. Не забудьте сохранить это значение во время создания перед выходом со страницы.

Вы используете значение секрета клиента в параметре arbDeploymentAppSecret в шаблоне Resource Manager.

Получение идентификатора объекта для поставщика локальных ресурсов Azure

Этот идентификатор объекта для предоставления локального ресурса Azure (RP) является уникальным для каждого клиента Azure.

В портале Azure найдите и перейдите к Microsoft Entra ID.
Перейдите на вкладку "Обзор" и найдите поставщика ресурсов Microsoft.AzureStackHCI.
Выберите имя субъекта-службы, указанное в списке, и скопируйте идентификатор объекта.

Вы также можете использовать PowerShell для получения идентификатора объекта принципала службы Azure Local RP. Выполните следующую команду в PowerShell:
```
Get-AzADServicePrincipal -DisplayName "Microsoft.AzureStackHCI Resource Provider"
```
Идентификатор объекта применяется в отношении hciResourceProviderObjectID параметра в шаблоне Resource Manager.

Шаг 2. Развертывание с помощью шаблона Azure Resource Manager

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

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

Внимание

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

На портале Azure перейдите на страницу "Главная" и нажмите кнопку "+ Создать ресурс".
Выберите Создать в разделе Развертывание шаблона (развертывание с помощью пользовательских шаблонов).
В нижней части страницы найдите шаблон быстрого запуска или раздел спецификации шаблона . Выберите параметр шаблона быстрого запуска .

В раскрывающемся списке шаблона быстрого запуска (отказ от ответственности) выберите шаблон create-cluster-2411.3 .
По завершении нажмите кнопку "Выбрать шаблон ".
На вкладке "Основы" отображается страница "Пользовательские развертывания ". Можно выбрать различные параметры в раскрывающемся списке или выбрать пункт "Изменить параметры".

Замечание

Пример файла параметров, отображающего формат различных входных данных, например ArcNodeResourceIdazuredeploy.parameters.json.

Используйте поле шаблона быстрого запуска (отказ от ответственности), чтобы отфильтровать соответствующий шаблон. Введите azurestackhci/create-cluster для фильтра.
По завершении нажмите кнопку "Выбрать шаблон ".
На вкладке "Основы" отображается страница "Пользовательские развертывания ". Можно выбрать различные параметры в раскрывающемся списке или выбрать пункт "Изменить параметры".

Замечание

Пример файла параметров, отображающего формат различных входных данных, например ArcNodeResourceIdazuredeploy.parameters.json.

Редактирование таких параметров, как назначение сети или назначение сети хранения. После заполнения всех параметров сохраните файл параметров.
Выберите соответствующую группу ресурсов для вашей среды.
Прокрутите страницу вниз и убедитесь, что режим развертывания = проверка.
Выберите "Рецензирование и создание".
На вкладке "Просмотр и создание" нажмите кнопку "Создать". Это создает оставшиеся необходимые ресурсы и проверяет развертывание. Проверка занимает около 10 минут.
После завершения проверки выберите "Повторное развертывание".
На экране "Настраиваемое развертывание " выберите "Изменить параметры". Загрузите ранее сохраненные параметры и нажмите кнопку "Сохранить".
В нижней части рабочей области измените окончательное значение в JSON с Проверка на Развертывание, где режим развертывания = Развертывание.
Убедитесь, что все поля для шаблона развертывания Resource Manager заполняются в формате JSON параметров.
Выберите соответствующую группу ресурсов для вашей среды.
Прокрутите страницу вниз и убедитесь, что режим развертывания = развертывание.
Выберите "Рецензирование и создание".
Нажмите кнопку "Создать". Развертывание начинается с использования существующих необходимых ресурсов, созданных на этапе проверки .

Экран развертывания циклит на ресурсе кластера во время развертывания.

После начала развертывания выполняется ограниченная проверка среды, затем проводится полная проверка среды, и начинается облачное развертывание. Через несколько минут можно отслеживать развертывание на портале.
В новом окне браузера перейдите в группу ресурсов для вашей среды. Выберите ресурс кластера.
Выберите развертывание.
Обновите и просмотрите ход развертывания с первого компьютера (также известного как начальный компьютер и является первым компьютером, на котором вы развернули кластер). Развертывание занимает от 2,5 до 3 часов. Несколько шагов занимают 40–50 минут или более.
Этап развертывания, который занимает больше всего времени, — развертывание Moc и стек ARB. Этот шаг занимает 40–45 минут.

Когда задача будет завершена, задача в верхней части списка обновляется со статусом и временем завершения.

Вы также можете просмотреть этот шаблон, созданный сообществом, чтобы развернуть локальный экземпляр Azure с помощью Bicep.

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

Если развертывание завершается сбоем, на странице развертываний появится сообщение об ошибке.

В разделе "Сведения о развертывании" выберите сведения об ошибке.
Скопируйте сообщение об ошибке из колонки "Ошибки ". Вы можете предоставить это сообщение об ошибке в службу поддержки Майкрософт для получения дополнительной помощи.

Известные проблемы при развертывании шаблона ARM

В этом разделе содержатся известные проблемы и обходные пути развертывания шаблона ARM.

Распределение ролей уже существует

Проблема: В этом релизе вы можете увидеть ошибку "Назначение роли уже существует". Эта ошибка возникает, если сначала было предпринято развертывание локального экземпляра Azure через портал, а для развертывания шаблона ARM была использована та же группа ресурсов. Эта ошибка отображается на странице Обзор Сведения о развертывании> для применимого ресурса. Эта ошибка означает, что эквивалентное назначение ролей уже было выполнено другим удостоверением для той же области группы ресурсов, и развертывание шаблона ARM не может выполнить назначение ролей.

Обходной путь: Неудачный ресурс на странице сведений о развертывании указывает имя роли. Если имя ресурса — AzureStackHCIDeviceManagementRole-RoleAssignment , назначение роли завершилось сбоем для роли управления устройствами Azure Stack HCI. Обратите внимание на это имя роли и перейдите к назначениям ролей управления доступом группы > ресурсов (IAM>). Найдите соответствующее имя и удалите существующие назначения ролей. Повторно разверните ваш шаблон.

Идентификатор клиента, идентификатор приложения, идентификатор субъекта и область не могут быть обновлены.

Проблема: Назначение ролей завершается с ошибкой: обновление идентификатора клиента, идентификатора приложения, идентификатора субъекта и области не разрешено. Эта ошибка отображается на странице Обзор Сведения о развертывании> для применимого ресурса. Эта ошибка может появляться, если в той же группе ресурсов имеются задания "зомби-ролей". Например, когда было выполнено предыдущее развертывание и ресурсы, соответствующие этому развертыванию, были удалены, но ресурсы, связанные с назначением ролей, остались нетронутыми.

Обходное решение. Чтобы определить назначения зомби, перейдите на вкладку Управление доступом (IAM) > Назначения ролей > Тип: Неизвестный. Эти назначения указаны как Идентификатор не найден. Не удается найти идентификатор. Удалите такие назначения ролей, а затем повторите развертывание шаблона ARM.

Проблема синхронизации лицензий

Проблема. В этом выпуске при развертывании шаблона ARM может возникнуть проблема с синхронизацией лицензий.

Решение. После завершения этапа проверки система рекомендует не инициировать другое развертывание шаблона ARM в режиме проверки , если система находится в состоянии сбоя развертывания . Запуск другого развертывания сбрасывает системные свойства, что может вызвать проблемы с синхронизацией лицензий.