Общие сведения о создании шаблонов CLI для разработчиков Azure

Интерфейс командной строки разработчика Azure (azd) использует templates для подготовки и развертывания ресурсов приложений в облаке. Разработчики могут добавить поддержку azd команд и функций, преобразовав их приложения в шаблоны. В этой статье представлен контекстный обзор различных вариантов создания azd шаблонов. После понимания концепций в этой статье ознакомьтесь со следующими ресурсами, чтобы получить более подробные руководства по реализации:

• Используйте существующий шаблон для приложения.
• Создание шаблона из кода приложения
• Обучение — создание и развертывание azd шаблонов

Основные понятия создания шаблона

azd Для создания шаблона требуется добавление определенных ресурсов конфигурации и инфраструктуры в существующую базу кода или запуск нового приложения из существующего шаблона тех же ресурсов. Оба рабочего процесса описаны в последующих разделах. Все azd шаблоны используют аналогичную структуру файлов на azd основе соглашений. На следующей схеме представлен краткий обзор процесса создания azd шаблона:

Для каждого azd шаблона требуются следующие минимальные ресурсы:

• Папка infra, содержащая файлы инфраструктуры в виде кода (Bicep или Terraform).
• azure.yaml Файл конфигурации, который сопоставляет службы приложений с подготовленными ресурсами инфраструктуры.

Другие необязательные каталоги также часто включаются, например, папка .github с объектами для создания конвейера CI/CD. Для получения дополнительной информации о шаблонах см. документ обзор шаблонов.

Рассмотрим следующий пример репозитория приложений:

После преобразования этого примера приложения в шаблон тот же репозиторий приложений azd содержит следующее:

Исходные ресурсы приложения не изменились, но добавлены новые ресурсы, на которые azd зависит для выполнения таких команд, как azd up.

• Добавлена папка infra, содержащая файлы Bicep для создания ресурсов Azure.
• Добавлен файл конфигурации azure.yaml для сопоставления кода приложения в каталоге src с ресурсами Azure для развертывания.
• Папка .azure была создана для хранения azd переменных среды.
• Добавлена папка .github (необязательно) для поддержки конвейеров CI/CD с помощью действий GitHub.

Рабочие процессы создания шаблонов

Команда azd init используется для инициализации шаблона azd для подготовки и развертывания ресурсов приложения на Azure. Командная строка позволяет выбрать два разных рабочих процесса для инициализации шаблона, описанного в следующих разделах: использование кода в текущем каталоге и использование существующего шаблона.

azd init Выполните команду в корневом каталоге, который вы хотите преобразовать вazd template:

azd init

Использование кода в текущем каталоге

Этот параметр указывает azd проанализировать код в каталоге, чтобы определить, какие технологии он использует, такие как язык программирования, платформа и система баз данных. azd автоматически создает ассеты шаблона для вас, такие как файл определения службы azure.yaml и папку infra с файлами инфраструктуры как кода. Созданные ресурсы являются отправной точкой для дополнительных изменений. Используйте этот подход, если планируется использовать общие службы Azure, поддерживаемые функциями azd структурирования.

Ознакомьтесь с руководством по созданию шаблона, начав с кода вашего приложения, чтобы узнать, как реализовать этот подход, а также получить дополнительные сведения о том, какие ресурсы Azure поддерживают автоматическое обнаружение и создание шаблонов.

Выбор шаблона

Выберите этот параметр, чтобы использовать существующий шаблон, который определяет многие ресурсы Azure и архитектурные цели в качестве отправной точки. azd появится запрос на выбор начального шаблона или другого шаблона из коллекции awesome-azd . При выборе шаблона ресурсы этого шаблона добавляются в существующий каталог проекта для использования в качестве отправной точки. Некоторые шаблоны включают пример кода приложения, который можно заменить собственными, а некоторые (называемые начальными шаблонами) являются только инфраструктурой.

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

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

См. также

• Используйте существующий шаблон для приложения.
• Создание шаблона из кода приложения

Запрос справки

Чтобы получить информацию о том, как сообщить об ошибке, запросить помощь или предложить новую функцию для интерфейса командной строки разработчика Azure (CLI), перейдите на страницу устранения неполадок и поддержки.

Дальнейшие действия