gambaran umum pengembangan templat Azure Developer CLI (azd)

Azure templat Developer CLI (azd) mengemas konfigurasi, infrastruktur, dan kode aplikasi opsional yang diperlukan untuk menyediakan dan menyebarkan solusi pada Azure. Anda dapat menggunakan templat untuk aplikasi, proyek khusus infrastruktur, atau titik awal yang dapat digunakan kembali untuk proyek mendatang.

Note

Sebelum memulai, baca templat Azure Developer CLI untuk mendapatkan deskripsi lengkap tentang struktur templat, aset wajib dan opsional, asosiasi layanan dengan sumber daya, dan bagaimana perintah azd menggunakan setiap file.

Alur kerja pengembangan templat

Alur kerja berikut ini berlaku apakah Anda membuat templat atau menginisialisasi templat yang sudah ada:

Diagram alur kerja pengembangan templat CLI Pengembang Azure. Di sebelah kiri, kotak berlabel "Pilih titik awal" berisi dua opsi: "Mulai dengan templat baru" dan "Mulai dari templat yang sudah ada." Kedua opsi mengarah ke "Jelajahi dan edit file templat." Dari sana, jalur opsional mengarah ke "Perluas templat," dan jalur utama terus "Jalankan azd up." Langkah "Perluas template" juga mengarahkan ke "Jalankan azd up." Terakhir, "Jalankan azd up" berujung pada "Kelola atau bagikan templat."

• Pilih titik awal:Mulailah dengan templat baru dengan integrasi GitHub Copilot, asisten pengkodian AI lain, atau penulisan langsung. Atau, mulai dari templat yang ada dari Microsoft, organisasi Anda, atau komunitas pengembang.
• Jelajahi dan edit file: Tinjau bagaimana azure.yaml, file Bicep atau Terraform, kode aplikasi, dan konfigurasi pendukung bekerja bersama. Lihat Menjelajahi dan mengedit file templat.
• Perluas dan berevolusi sesuai kebutuhan: Menambahkan, mengganti, menghapus, atau mendesain ulang komponen aplikasi dan infrastruktur. Ikuti panduan Perluas templat untuk contoh menyeluruh yang menambahkan sumber daya Azure dan menghubungkannya ke aplikasi.
• Provisi dan sebarkan: Jalankan azd up untuk menyediakan infrastruktur dan menyebarkan layanan aplikasi apa pun. Untuk informasi selengkapnya, lihat Menjelajahi azd up alur kerja.
• Pertahankan atau bagikan: Lanjutkan mengedit templat saat proyek Anda berkembang. Jika Anda berencana untuk membagikannya, uji di direktori yang bersih dan dengan lingkungan baru azd terlebih dahulu.

Note

Sepanjang alur kerja ini, Anda dapat membuat, mengedit, atau mengganti file templat sendiri atau dengan bantuan dari asisten pengodian AI. Hasilnya adalah sekumpulan aset standar yang sama dan dapat azd diedit.

Blok penyusun templat

Setiap azd templat mendukung solusi yang berbeda, tetapi sebagian besar templat menggabungkan jenis aset yang sama:

• Konfigurasi proyek: Berkas azure.yaml mengidentifikasi proyek, layanan yang dapat disebarkan, direktori sumber, target hosting, serta hook atau alur kerja opsional.
• Infrastruktur sebagai kode: file Bicep atau Terraform menentukan sumber daya Azure, penetapan peran, jaringan, dan pengaturan aplikasi yang diperlukan solusi.
• Sumber aplikasi: Templat dapat menyertakan satu atau beberapa aplikasi yang dapat disebarkan, atau hanya dapat berisi infrastruktur.
• Konfigurasi lingkungan: Parameter meneruskan nilai khusus lingkungan ke dalam penyebaran, dan output infrastruktur menjadi nilai di lingkungan aktif azd .

Templat untuk aplikasi mungkin menggunakan struktur folder berikut:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

Struktur yang tepat bervariasi menurut proyek. Sumber aplikasi, modul infrastruktur, dan file alur bersifat opsional, dan azure.yaml mengidentifikasi jalur yang azd menggunakan. Aset ini bekerja sama sepanjang siklus hidup pengembangan templat.

Langkah berikutnya

Mulai dengan templat baru

Minta bantuan

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