Создание минимального шаблона с помощью функции создания интерфейса командной строки разработчика Azure

Функция возможности композиции интерфейса командной строки разработчика Azure (azdcompose) позволяет постепенно создавать ресурсы Azure, необходимые для вашего приложения, без ручного написания кода Bicep. В этой статье вы узнаете, как работать с функцией создания для создания минимального шаблона. Для получения дополнительных концептуальных сведений об этой функции перейдите к статье обзора композиции.

Работа с функцией составления

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

• Используйте код в текущем каталоге (для приложений, предназначенных для Azure Container Apps для хостинга)
• Создание минимального проекта

Шаблоны, инициализированные с помощью потока выбора шаблона , сейчас не поддерживаются. Функция azd compose управляет инфраструктурой для вас и несовместима с шаблонами, в которых уже имеются существующие infra активы папок. Дополнительные сведения см. на странице создания кода Bicep и странице рабочих процессов создания шаблонов для получения более подробной информации.

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

1. В окне терминала перейдите в корневой каталог azd шаблона.

2. Выполните команду azd add, чтобы добавить новый ресурс и запустить рабочий процесс компоновки.

   azd add
   

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

   ? What would you like to add? [Use arrows to move, type to filter]
   > AI
     Database
     Host service
     Key Vault
     Messaging
     Storage account
     ~Existing resource
   

4. Для типа базы данных выберите PostgreSQL.

   ? Which type of database?  [Use arrows to move, type to filter]
     MongoDB
   > PostgreSQL
     Redis
   

5. Введите имя нового ресурса, например azddb.

   ? Input the name of the app database (PostgreSQL)
   

6. Если приложение содержит службы, azd предложит выбрать службу, которая использует этот ресурс.

   ? Select the service(s) that uses this resource
   > [✓]  webfrontend
   

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

   Previewing changes to azure.yaml:
   
   +  azddata:
   +      type: db.postgres
   
      webfrontend:
          type: host.containerapp
          uses:
              - azddb
   +          - azddata
          port: 80
   

8. Выполните команду azd up, чтобы применить все изменения, внесенные с помощью команды azd add. В этом примере azd подготавливает базу данных PostgreSQL в Azure.

9. azd add Выполните команду еще раз, чтобы добавить другие ресурсы, например службу OpenAI.

Изучите файл azure.yaml

azure.yaml — это файл конфигурации, который azd используется для управления приложением. azd управляет службами и ресурсами, состоящими из azd add команды, с помощью соответствующих services и resources узлов. Рассмотрим следующий пример azure.yaml файла, который полностью обновлен с помощью azd add:

name: azdcomposesample
metadata:
  template: azd-init@1.11.0
services:
  webfrontend:
    project: src
    host: containerapp
    language: dotnet
resources:
  webfrontend:
    type: host.containerapp
    port: 80
    uses:
      - azdsql
      - azdchat
  azdsql:
    type: db.postgres
  azdchat:
    type: ai.openai.model
    model:
      name: gpt-4o
      version: "2024-08-06"

• Узел services объявляет:
  • Сопоставление развертывания, названное webfrontend, между веб-приложением .NET в каталоге src и приложениями Azure Container Apps.
• Узел resources объявляет:
  • Приложение контейнера Azure и соответствующее ему сопоставление зависимостей, именуемое webfrontend, между размещенным приложением контейнера .NET и базой данных и службой искусственного интеллекта, от которых оно зависит. Узел uses сопоставляет приложение с другими ресурсами, от которой он зависит.
  • Ресурс Базы данных Azure для PostgreSQL с именем azdsql.
  • Ресурс Azure OpenAI с именем azdchat.

Дальнейшие шаги