Mulai dengan templat Azure Developer CLI (azd) baru

Anda dapat menggunakan metode penulisan yang berbeda untuk membangun file standar dalam templat Azure Developer CLI (azd) baru:

  • Gunakan integrasi GitHub Copilot di azd init. Alur kerja bawaan menganalisis file proyek yang ada atau membantu Anda merencanakan proyek baru, membuat aset templat, dan menjalankan validasi pra-penyebaran.
  • Gunakan asisten pengkodian AI lain. Minta asisten untuk membuat azure.yaml file, infrastruktur sebagai kode, aplikasi, dan file pendukung yang sama tanpa terintegrasi langsung dengan azd init.
  • Tulis file secara langsung. Buat dan edit sendiri aset templat saat Anda menginginkan kontrol penuh atau tidak menggunakan asisten pengkodian AI.

Artikel ini berfokus terutama pada alur kerja GitHub Copilot bawaan karena memberikan pengalaman terpandu yang terintegrasi dengan azd. Terlepas dari metode penulisan, tinjau dan validasi setiap file sebelum penyebaran.

Penting

Integrasi GitHub Copilot di azd init masih dalam pratinjau. Fitur pratinjau dapat berubah sebelum ketersediaan umum. Untuk informasi selengkapnya, lihat azd penerapan versi fitur dan strategi rilis.

Aset yang dihasilkan adalah file templat standar yang dapat azd diedit. Setelah inisialisasi, Anda dapat memperbaruinya secara langsung atau dengan asisten pengkodian AI apa pun.

Prasyarat untuk GitHub Copilot

Untuk menggunakan alur kerja Copilot bawaan, Anda memerlukan:

  • Azure Developer CLI 1.23.11 atau yang lebih baru.
  • Langganan GitHub Copilot aktif.
  • Git, yang azd init menggunakan untuk memeriksa pohon kerja sebelum memodifikasi file.
  • Sesi terminal interaktif.

Jika Anda belum diautentikasi dengan GitHub Copilot, azd meminta Anda untuk masuk.

Jalankan azd version untuk memeriksa versi CLI Pengembang Azure yang terinstal.

Note

azd init Alur kerja memulai sesi agen Copilot GitHub khusus di terminal. Tidak menggunakan atau melanjutkan sesi GitHub Copilot Chat yang aktif di Visual Studio Code.

Membangun dengan GitHub Copilot

  1. Buka terminal di direktori tempat Anda ingin membuat templat.

    Note

    Direktori dapat berisi aplikasi yang ada, proyek infrastruktur, atau file awal untuk solusi baru. Jika direktori berisi perubahan yang tidak dilakukan, azd meminta Anda untuk mengonfirmasi sebelum melanjutkan. Terapkan atau simpan perubahan penting terlebih dahulu.

  2. Jalankan azd init:

    azd init

  3. Pilih Siapkan menggunakan GitHub Copilot (Pratinjau).

    Perintah inisialisasi menyerupai contoh berikut:

    ? How do you want to initialize your app?
   Scan current directory
   Select a template
> Set up with GitHub Copilot (Preview)

  4. Tinjau akses alat yang diminta, dan berikan akses ke alat yang diperlukan untuk alur kerja. Copilot menggunakan azd dan Azure kemampuan pengembangan untuk memeriksa proyek, membuat file, dan memvalidasi hasilnya.

  5. Pilih model dan tingkat penalaran jika azd meminta Anda untuk mengonfigurasinya.

    Pada eksekusi pertama, perintah menggunakan label berikut. Pilihan model dan penalaran yang tersedia bergantung pada akun GitHub Copilot Anda dan model yang dipilih:

    ? Select AI model
? Select reasoning effort level

  6. Jelaskan apa yang ingin Anda buat. Sertakan persyaratan yang relevan seperti:

    • Apakah templat menyertakan kode aplikasi, hanya infrastruktur, atau keduanya.
    • Bahasa dan kerangka kerja aplikasi, jika diketahui.
    • Layanan Azure dan platform hosting yang akan digunakan.
    • Apakah akan menggunakan Bicep atau Terraform.
    • Persyaratan keamanan, jaringan, penskalaan, dan wilayah.

    Contohnya:

    Build an infrastructure-only azd template that provisions an Azure Container Apps
environment, Azure Container Registry, and Log Analytics workspace with Bicep.
Use managed identity and least-privilege role assignments. Parameterize the location
and environment name so the template can be reused.

  7. Jawab pertanyaan arsitektur atau konfigurasi apa pun dari Copilot. Agen menyiapkan proyek untuk Azure, menghasilkan aset templat, dan menjalankan validasi pra-penyebaran.

  8. Tinjau struktur keseluruhan file yang dibuat atau diubah oleh Copilot. Konfirmasikan bahwa templat menyertakan konfigurasi proyek yang diharapkan, direktori infrastruktur, sumber aplikasi, dan aset pendukung untuk solusi Anda.

    Misalnya, templat khusus infrastruktur yang dihasilkan mungkin berisi file kunci berikut:

    azure.yaml
infra/
├── main.bicep
├── main.parameters.json
└── modules/
   ├── container-apps-environment.bicep
   └── container-registry.bicep

    Untuk panduan terperinci tentang meninjau konten konfigurasi dan infrastruktur, lihat Menjelajahi dan mengedit file templat.

Sediakan dan terapkan templat

Setelah Anda menyetujui file yang dihasilkan, jalankan perintah berikut:

azd up

Perintah membuat atau memilih sebuah lingkungan azd, menyediakan sumber daya Azure, mengemas layanan aplikasi apa pun, lalu menyebarkannya. Untuk perincian perintah terperinci, lihat Menjelajahi azd up alur kerja.

Gunakan metode penulisan lain

Asisten pengkodian AI lainnya tidak terhubung langsung ke azd init alur kerja, tetapi mereka dapat membuat aset templat standar yang sama. Anda juga dapat menulis setiap aset secara langsung.

Buat aset ini sendiri, atau minta asisten pengkodian lain untuk menganalisis kebutuhan Anda dan membuatnya:

  • File azure.yaml yang menentukan proyek dan layanan yang dapat disebarkan.
  • File Bicep atau Terraform yang memprovisikan sumber daya Azure yang diperlukan.
  • Output sumber daya dan variabel lingkungan aplikasi.
  • Dockerfiles, konfigurasi penyebaran, dan skrip pendukung jika diperlukan.

Untuk menyediakan titik awal minimal sebelum menggunakan agen lain, jalankan:

azd init --minimal

Jika Anda menggunakan asisten pengodean lain, instruksikan asisten tersebut untuk mengikuti skema azure.yaml, praktik keamanan infrastruktur Azure, dan konvensi templat yang dijelaskan dalam templat Azure Developer CLI. Jika Anda menulis file secara langsung, gunakan referensi yang sama dengan panduan implementasi Anda. Tinjau dan validasi semua file sebelum Anda menjalankan azd up.

Konten terkait

Minta bantuan

Untuk informasi tentang cara mengajukan bug, meminta bantuan, atau mengusulkan fitur baru untuk Azure Developer CLI, silakan kunjungi halaman troubleshooting dan dukungan.

  • Last updated on