pulumi-arm-to-pulumi

О pulumi-arm-to-pulumi

Структурированный рабочий процесс для преобразования или миграции шаблонов Azure ARM (Azure Resource Manager), Bicep или кода Azure в Pulumi, включая импорт существующих ресурсов Azure в систему управления Pulumi. Он предназначен для загрузки при каждом запросе на такую миграцию, преобразование или импорт и будет корректировать любой план миграции, составленный до загрузки данного навыка, с целью приведения его в соответствие с его требованиями.

Критерии успешного выполнения строгие: каждый ресурс ARM должен либо фигурировать в программе Pulumi, либо быть явно обоснован в отчете; результат должен быть структурно корректным и поддаваться успешному предварительному просмотру в Pulumi; при импорте существующих ресурсов предварительный просмотр должен показывать нулевое количество различий (никаких операций создания, обновления, замены или удаления), при этом любые различия должны устраняться с помощью рабочего процесса устранения различий в предварительном просмотре. Всегда формируется формальный отчет о миграции, подходящий для пул-реквеста, который охватывает сопоставление ресурсов ARM и Pulumi, решения по провайдерам, различия в поведении и ручные шаги.

Рабочий процесс протекает последовательно. На этапе сбора информации проверяются учетные данные Azure (с использованием среды ESC и команды `az login`) и анализируется шаблон ARM с помощью jq для извлечения типов ресурсов, параметров, переменных, массивов `dependsOn`, циклов копирования и условий; при необходимости создается перечень ресурсов с помощью команд `az resource list` и `show`. Преобразование кода выполняется вручную, поскольку автоматического конвертера ARM не существует; по умолчанию используется провайдер azure-native, а в качестве резервного — классический провайдер Azure, при этом сохраняются все условные операторы, циклы и зависимости на языке, выбранном пользователем. Опциональный импорт ресурсов использует встроенную опцию import resource с идентификаторами ресурсов Azure, которые следуют предсказуемому пути: подписка, группа ресурсов и провайдер, а затем проверяется на отсутствие различий (zero diffs). Наконец, конфигурация стека настраивается в соответствии с параметрами ARM. В сопутствующих документах arm-conversion-patterns.md и arm-import.md приведены подробные шаблоны сопоставления, а также процедуры импорта и отладки с нулевым количеством различий.

Часто задаваемые вопросы

Существует ли автоматизированный инструмент для преобразования шаблонов ARM?

Нет. В описании навыка указано, что преобразование из ARM в Pulumi требует ручного перевода и что вы несете ответственность за полное преобразование, хотя шаблоны сопоставления служат ориентиром при работе.

Какого провайдера Pulumi следует использовать?

По умолчанию используйте @pulumi/azure-native для полного покрытия API Azure Resource Manager, а в случае отсутствия какой-либо функции в azure-native или необходимости более простой абстракции переключайтесь на классический провайдер @pulumi/azure.

Что означает проверка импорта с нулевым различием?

После импорта существующих ресурсов в предварительном просмотре Pulumi не должно отображаться ни одного создания, обновления, замены или удаления. Любые расхождения устраняются с помощью рабочего процесса разрешения предварительного просмотра, описанного в файле arm-import.md.

Как настраиваются учетные данные Azure?

Через среду ESC, предоставляющую учетные данные, с помощью команды `pulumi env run` с параметром `az login` (участник службы и федеративный токен), а затем проверки с помощью команды `az account show`. Если среда не указана, навык запрашивает, какую среду ESC использовать.

Что предоставляется по завершении миграции?

Официальный отчет о миграции, подходящий для pull-запроса, включая сопоставление ресурсов ARM и Pulumi, решения по провайдерам, различия в поведении, любые пропущенные или ручные шаги, а также инструкции по проверке.

Все файлы