Membuat gambaran umum templat Azure Developer CLI

Azure Developer CLI (azd) menggunakan templat untuk menyediakan dan menyebarkan sumber daya aplikasi ke cloud. Pengembang dapat menambahkan dukungan untuk azd perintah dan fitur dengan mengonversi aplikasi mereka ke templat. Artikel ini menyediakan gambaran umum kontekstual tentang berbagai opsi untuk membuat azd templat. Setelah Anda memahami konsep dalam artikel ini, kunjungi sumber daya berikut untuk panduan implementasi yang lebih rinci:

• Gunakan templat yang sudah ada untuk aplikasi Anda.
• Membuat templat dari kode aplikasi Anda
• Pelatihan - membangun dan menyebarkan azd templat

Catatan

Artikel ini mengasumsikan pemahaman umum tentang azd templat. Kunjungi dokumen gambaran umum templat untuk informasi selengkapnya tentang templat.

Konsep pembuatan templat

azd Membuat templat memerlukan penambahan konfigurasi dan aset infrastruktur tertentu ke basis kode yang ada, atau memulai aplikasi baru dari templat yang ada, aset yang sama. Kedua alur kerja dijelaskan di bagian selanjutnya. Semua azd templat berbagi struktur file serupa berdasarkan azd konvensi. Diagram berikut memberikan gambaran umum singkat tentang proses untuk membuat azd templat:

Setiap azd templat memerlukan sumber daya minimum berikut:

• Folder infra yang menyimpan file infrastruktur sebagai kode (Bicep atau Terraform).
• azure.yaml File konfigurasi yang memetakan layanan aplikasi Anda ke sumber daya infrastruktur yang disediakan.

Direktori opsional lainnya juga sering disertakan, seperti folder dengan aset .github untuk membuat alur CI/CD. Kunjungi dokumen gambaran umum templat untuk informasi selengkapnya tentang templat.

Pertimbangkan repositori aplikasi sampel berikut:

Setelah mengonversi aplikasi sampel ini menjadi azd templat, repositori aplikasi yang sama berisi yang berikut ini:

Sumber daya aplikasi asli tidak berubah, tetapi aset baru ditambahkan yang azd bergantung pada perintah seperti azd up:

• Folder infra ditambahkan yang menyertakan file Bicep untuk membuat sumber daya Azure.
• File azure.yaml konfigurasi ditambahkan untuk memetakan kode aplikasi di src direktori ke penyediaan sumber daya Azure.
• Folder .azure dibuat untuk menyimpan azd variabel lingkungan.
• .github Folder (opsional) ditambahkan untuk mendukung alur CI/CD melalui tindakan GitHub.

Alur kerja pembuatan templat

Perintah azd init ini digunakan untuk menginisialisasi azd templat untuk menyediakan dan menyebarkan sumber daya aplikasi di Azure. Perintah meminta Anda untuk memilih antara dua alur kerja yang berbeda untuk menginisialisasi templat yang diuraikan di bagian berikut - Menggunakan kode di direktori saat ini dan Menggunakan templat yang sudah ada.

Jalankan azd init perintah di akar direktori yang ingin Anda konversi ke azd template:

azd init

Gunakan kode dalam direktori saat ini

Opsi ini menginstruksikan azd untuk menganalisis kode di direktori Anda ke identitas teknologi mana yang digunakannya, seperti bahasa pemrograman, kerangka kerja, dan sistem database. azd secara otomatis menghasilkan aset templat untuk Anda, seperti azure.yaml file definisi layanan dan infra folder dengan file infrastruktur sebagai kode. Aset yang dihasilkan adalah titik awal untuk modifikasi tambahan. Gunakan pendekatan ini jika Anda berencana untuk menggunakan layanan Azure umum yang didukung oleh azd fitur perancah.

Kunjungi tutorial Mulai dengan kode aplikasi Anda untuk membuat templat untuk detail tentang cara menerapkan pendekatan ini dan informasi selengkapnya tentang sumber daya Azure yang mendukung deteksi dan perancah otomatis.

Memilih templat

Pilih opsi ini untuk menggunakan templat yang sudah ada yang menentukan banyak sumber daya Azure dan tujuan arsitektur Anda sebagai titik awal. azd akan meminta Anda untuk memilih templat pemula atau templat lain dari galeri awesome-azd . Saat Anda memilih templat, aset templat tersebut ditambahkan ke direktori proyek yang ada untuk digunakan sebagai titik awal. Beberapa templat menyertakan contoh kode aplikasi yang dapat Anda ganti dengan kode Anda sendiri, sementara beberapa (disebut "templat pemula") hanya infrastruktur.

azd init Gunakan perintah untuk menurunkan templat yang ada ke direktori kosong dan gunakan sebagai titik awal untuk aplikasi Anda sendiri. Jika templat menyertakan kode sumber aplikasi, Anda dapat membuat kode tersebut atau mengganti direktori kode sumber dengan kode Anda sendiri.

Kunjungi tutorial Mulai dengan templat yang ada untuk detail tentang cara menerapkan pendekatan ini.

Lihat juga

• Gunakan templat yang sudah ada untuk aplikasi Anda.
• Membuat templat dari kode aplikasi Anda

Meminta bantuan

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

Langkah berikutnya

FAQ Azure Developer CLI