Bagikan melalui

Gambaran umum templat Azure Developer CLI

  • Artikel

Templat Azure Developer CLI (azd) adalah repositori kode standar yang menyertakan kode aplikasi sampel, serta azd file konfigurasi dan infrastruktur. azd templat memungkinkan Anda menyediakan sumber daya Azure, menyebarkan aplikasi Anda, mengonfigurasi alur CI/CD, dan banyak lagi. Anda dapat membuat templat Anda sendiri, atau mulai menggunakan templat yang ada dari repositori templat seperti Awesome AZD. Dalam artikel ini, Anda akan mempelajari tentang konsep berikut:

  • Bagaimana azd templat memungkinkan Anda untuk memprovisikan dan menyebarkan sumber daya aplikasi
  • Bagaimana azd templat disusun
  • Cara memutuskan apakah akan menggunakan templat yang sudah ada atau membuatnya
  • Menjelajahi templat pemula azd yang sudah ada

Mengapa menggunakan templat Azure Developer CLI?

Pengembang sering menghadapi banyak tugas yang memakan waktu dan menantang saat membangun aplikasi lingkungan yang dirancang dan dikonfigurasi dengan benar untuk cloud. Teams harus memperhitungkan banyak kekhawatiran yang berbeda di lingkungan ini, seperti membuat sumber daya, menerapkan konfigurasi, menyiapkan pemantauan dan pengelogan, membangun alur CI/CD, dan tugas lainnya. azd templat mengurangi dan menyederhanakan tanggung jawab ini untuk membantu pengembang dalam perjalanan mereka dari pengembangan lokal ke aplikasi yang berhasil disebarkan di Azure.

Misalnya, Anda bekerja di perusahaan yang mengoperasikan manajemen tiket dan platform komunikasi pelanggan, yang memerlukan sumber daya Azure berikut:

  • Dua instans App Service dan Paket App Service untuk menghosting aplikasi web front-end dan API back-end
  • Instans Key Vault untuk menyimpan rahasia aplikasi yang aman
  • Database Cosmos DB untuk menyimpan data aplikasi secara permanen
  • Sumber daya Azure Monitor seperti dasbor Application Insights
  • Bus Layanan untuk mengelola pesan yang dapat diskalakan
  • Alur CI/CD untuk memastikan perubahan dapat disebarkan dengan andal melalui proses otomatis yang dapat diulang.

Daripada memulai dari bawah ke atas, dengan azd Anda dapat memanfaatkan templat arsitektur yang ada untuk menyediakan dan menyebarkan sebagian besar sumber daya untuk Anda. Tim pengembangan kemudian dapat fokus pada pembangunan aplikasi dan membuat penyesuaian yang lebih kecil pada arsitektur templat.

Cara kerja templat Azure Developer CLI

Templat CLI Pengembang Azure dirancang untuk bekerja dengan azd perintah seperti azd init dan azd up. Templat termasuk file konfigurasi dan infrastruktur sebagai kode (IaC) yang digunakan oleh perintah untuk melakukan tugas seperti menyediakan sumber daya Azure dan menyebarkan kode aplikasi kepada mereka.

Misalnya, alur kerja umum azd menggunakan templat yang sudah ada menyertakan langkah-langkah berikut:

  1. Jalankan azd init perintah dengan --template parameter untuk mengkloning templat yang ada dari GitHub.

    azd init --template todo-nodejs-mongo

  2. Jalankan azd auth login perintah untuk mengautentikasi ke langganan Azure Anda.

    azd auth login

  3. Jalankan azd up perintah untuk menyediakan dan menyebarkan sumber daya templat ke Azure. Perintah ini azd up memanfaatkan file konfigurasi dan infrastruktur sebagai kode (IaC) di templat Anda untuk memprovisikan sumber daya Azure dan menyebarkan aplikasi Anda ke sumber daya tersebut.

    azd up

  4. Setelah lingkungan Anda disiapkan di Azure, Anda dapat memodifikasi fitur aplikasi atau templat sumber daya Azure secara lokal lalu menjalankan azd up lagi untuk memprovisikan perubahan Anda.

Memahami struktur templat Azure Developer CLI

Semua azd templat berbagi struktur file serupa berdasarkan azd konvensi. Aset minimum yang diperlukan umumnya mencakup yang berikut ini:

  • infra folder - Berisi semua infrastruktur Bicep atau Terraform sebagai file kode untuk azd templat. azd menjalankan file-file ini untuk membuat sumber daya Azure yang diperlukan untuk menghosting aplikasi Anda.

  • azure.yaml file - File konfigurasi yang menentukan satu atau beberapa layanan dalam proyek Anda dan memetakannya ke sumber daya Azure yang infra ditentukan dalam folder untuk penyebaran. Misalnya, Anda dapat menentukan layanan API dan layanan front-end web dan memetakannya ke sumber daya Azure yang berbeda untuk penyebaran.

  • .azure folder - Berisi konfigurasi Azure penting dan variabel lingkungan, seperti lokasi untuk menyebarkan sumber daya atau informasi langganan lainnya.

  • src folder - Berisi semua kode sumber aplikasi yang dapat disebarkan. Beberapa azd templat mengecualikan src folder dan hanya menyediakan aset infrastruktur sehingga Anda dapat menambahkan kode aplikasi Anda sendiri.

    Catatan

    Templat yang mengecualikan folder umumnya src dirancang sebagai templat pemula infrastruktur.

azd templat juga secara opsional menyertakan satu atau beberapa folder berikut:

  • .github folder - Menyimpan file alur kerja CI/CD untuk GitHub Actions, penyedia CI/CD default untuk azd.
  • .azdo folder - Jika Anda memutuskan untuk menggunakan Azure Pipelines untuk CI/CD, tentukan file konfigurasi alur kerja di folder ini.
  • .devcontainer folder - Memungkinkan Anda menyiapkan lingkungan Dev Container untuk aplikasi Anda.

Misalnya, templat umum azd mungkin cocok dengan struktur folder berikut:

Cuplikan layar memperlihatkan struktur templat Azure Developer CLI.

Mulai dengan templat yang sudah ada atau buat templat Anda sendiri

Ada dua pendekatan utama untuk bekerja dengan azd templat:

  • Mulailah dengan templat yang sudah ada azd .
    • Ini adalah pilihan yang baik jika Anda baru saja memulai azd atau jika Anda mencari templat untuk dibangun untuk aplikasi baru dengan arsitektur dan kerangka kerja serupa.
  • Mengonversi proyek yang sudah ada menjadi azd templat.
    • Ini adalah pilihan yang baik ketika Anda sudah memiliki aplikasi yang ada tetapi Anda ingin membuatnya kompatibel dengan azd kemampuan.

Bagian berikut ini menyediakan informasi selengkapnya tentang dua opsi ini.

Mulai dengan templat yang sudah ada

Pilihan azd templat yang luas tersedia di galeri templat azd yang mengagumkan. Templat ini menyediakan infrastruktur dan kode aplikasi untuk berbagai skenario pengembangan, kerangka kerja bahasa, dan layanan Azure. Jika Anda menemukan templat yang selaras dengan tumpukan aplikasi lokal atau arsitektur yang diinginkan, Anda dapat memperluas dan mengganti kode templat dengan kode Anda sendiri

Misalnya, templat berikut azd menyediakan titik awal untuk arsitektur dan kerangka kerja aplikasi umum:

Templat Host aplikasi Tumpukan teknologi
React Web App dengan C# API dan MongoDB di Azure Azure App Service Azure Cosmos DB untuk NoSQL, Bicep
React Web App dengan C# API dan SQL Database di Azure Azure App Service Azure SQL Database, Bicep
Static React Web App + Functions dengan C# API dan SQL Database di Azure Azure Static Web Apps, Azure Functions Azure SQL Database, Bicep

Membuat templat baru azd untuk aplikasi Anda

Anda juga dapat mengonversi aplikasi yang ada menjadi azd templat untuk meningkatkan repositori dengan kemampuan provisi dan penyebaran. Pendekatan ini memungkinkan kontrol terbanyak dan menghasilkan solusi yang dapat digunakan kembali untuk pekerjaan pengembangan di masa mendatang pada aplikasi. Langkah-langkah tingkat tinggi untuk membuat templat Anda sendiri adalah sebagai berikut:

  • Inisialisasi templat proyek dengan azd init.
  • Buat infrastruktur Bicep atau Terraform sebagai file kode di infra folder.
  • azure.yaml Perbarui file untuk mengikat layanan aplikasi bersama dengan sumber daya Azure.
  • Provisi & sebarkan dengan azd up.

Sumber daya berikut ini menyediakan informasi selengkapnya tentang membuat templat Anda sendiri:

Panduan untuk menggunakan azd templat

Harap dicatat bahwa setiap templat yang Anda gunakan dengan Azure Developer CLI dilisensikan oleh pemiliknya masing-masing (yang mungkin atau mungkin bukan Microsoft) berdasarkan perjanjian yang menyertai templat. Anda bertanggung jawab untuk menentukan lisensi apa yang berlaku untuk templat apa pun yang Anda pilih untuk digunakan.

Microsoft tidak bertanggung jawab atas templat non-Microsoft apa pun dan tidak menyaring templat ini untuk masalah keamanan, privasi, kompatibilitas, atau performa. Templat yang Anda gunakan dengan Azure Developer CLI, termasuk yang disediakan dari Microsoft, tidak didukung oleh program atau layanan dukungan Microsoft apa pun. Templat yang disediakan Microsoft disediakan AS IS tanpa jaminan apa pun.

Langkah berikutnya

Memilih dan menyebarkan templat