Bagikan melalui

Membangun templat minimal menggunakan fitur pembuatan Azure Developer CLI

Fitur komposabilitas (azdcompose) Azure Developer CLI () memungkinkan Anda menyusun sumber daya Azure yang diperlukan untuk aplikasi Anda secara progresif tanpa menulis kode Bicep secara manual. Dalam artikel ini, Anda akan belajar cara bekerja dengan fitur compose untuk membangun templat minimal. azd Kunjungi artikel ikhtisar penyusunan untuk informasi lebih lanjut tentang konsep fitur ini.

Nota

Fitur azd komposisi saat ini dalam tahap alfa dan tidak boleh digunakan dalam aplikasi produksi. Perubahan pada fitur alfa dalam rilis berikutnya dapat mengakibatkan perubahan yang merusak. Kunjungi halaman versi dan strategi rilis fitur azd serta halaman tahapan fitur untuk informasi selengkapnya. Gunakan tombol Umpan Balik di kanan atas untuk berbagi umpan balik tentang compose fitur dan artikel ini.

Gunakan fitur susun

Akses fitur penyusunan melalui perintah azdazd add. Perintah azd add berfungsi dengan templat yang dibuat menggunakan alur kerja berikut azd init :

  • Gunakan kode di direktori saat ini (untuk aplikasi yang menargetkan Azure Container Apps untuk hosting)
  • Membuat proyek minimal

Templat yang diinisialisasi melalui alur Pilih templat saat ini tidak didukung. Fitur azd mengkomposisi mengelola infrastruktur untuk Anda dan tidak kompatibel dengan templat yang memiliki aset folder infra yang sudah ada. Kunjungi artikel Buat kode Bicep dan halaman alur kerja pembuatan templat untuk informasi selengkapnya.

Selesaikan langkah-langkah berikut untuk menambahkan sumber daya baru ke templat Anda tanpa menulis kode apa pun:

  1. Di jendela terminal, navigasikan ke akar templat Anda azd .

  2. Jalankan azd add perintah untuk menambahkan sumber daya baru dan memulai alur kerja tulis:

    azd add

  3. Pilih salah satu sumber daya yang didukung untuk ditambahkan ke aplikasi Anda. Untuk contoh ini, pilih 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. Untuk jenis database, pilih PostgreSQL.

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

  5. Masukkan nama untuk sumber daya baru, seperti azddb.

    ? Input the name of the app database (PostgreSQL)

  6. Jika aplikasi Anda berisi layanan, azd meminta Anda untuk memilih layanan yang menggunakan sumber daya ini.

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

  7. azd menghasilkan pratinjau perubahan yang diperlukan pada azure.yaml file. Tekan Enter untuk menerima dan menerapkan perubahan.

    Previewing changes to azure.yaml:

+  azddata:
+      type: db.postgres

   webfrontend:
       type: host.containerapp
       uses:
           - azddb
+          - azddata
       port: 80

  8. Jalankan perintah azd up untuk menerapkan perubahan apa pun yang dibuat melalui perintah azd add. Dalam contoh ini, azd menyediakan database PostgreSQL di Azure.

  9. Jalankan azd add perintah lagi untuk menambahkan sumber daya lain, seperti layanan OpenAI.

Jelajahi file azure.yaml

azure.yaml adalah file konfigurasi yang azd digunakan untuk mengelola aplikasi Anda. azd mengelola layanan dan sumber daya yang dibentuk melalui perintah azd add menggunakan simpul services dan resources yang sesuai. Pertimbangkan contoh berikut tentang file azure.yaml yang diperbarui sepenuhnya melalui 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"
  • Simpul services menyatakan:
    • Pemetaan penyebaran bernama webfrontend antara aplikasi web .NET di src direktori dan Azure Container Apps.
  • Simpul resources menyatakan:
    • Aplikasi kontainer Azure dan pemetaan dependensi yang cocok dinamai webfrontend antara aplikasi kontainer .NET yang dihosting dan database dan layanan AI yang bergantung padanya. Simpul uses memetakan aplikasi ke sumber daya lain yang bergantung padanya.
    • Sumber daya Azure Database for PostgreSQL bernama azdsql.
    • Sumber daya Azure OpenAI bernama azdchat.

Langkah selanjutnya

Menghasilkan kode Bicep menggunakan fitur komposisi