Gambaran umum templat Azure Developer CLI

Templat Azure Developer CLI (azd) adalah repositori kode reguler 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 starter azd yang ada

Mengapa menggunakan templat Azure Developer CLI?

Pengembang sering menghadapi banyak tugas yang memakan waktu dan menantang saat membangun aplikasi sadar 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 azd umum 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 perintah azd up 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.

Menjelajahi struktur templat Azure Developer CLI

azd templat adalah repositori kode standar dengan beberapa aset tambahan disertakan. Semua azd templat berbagi struktur file serupa berdasarkan azd konvensi:

• infra folder - Berisi semua infrastruktur Bicep atau Terraform sebagai file kode untuk templat azd. azd menjalankan file-file ini untuk membuat sumber daya Azure yang diperlukan untuk menghosting aplikasi Anda.
• azure.yaml file - File konfigurasi yang memetakan folder kode sumber dalam proyek Anda ke sumber daya Azure yang didefinisikan dalam folder untuk tujuan penyebaran. Misalnya, Anda dapat menentukan layanan API dan layanan front-end web di folder terpisah 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.

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

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.

Mulai dengan templat yang sudah ada atau buat templat Anda sendiri

Ada dua pendekatan utama untuk bekerja dengan templat azd:

• Mulailah dengan templat yang sudah ada azd .
  • Ini adalah pilihan yang baik jika Anda baru saja memulai azd atau jika Anda mencari templat untuk membangun 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 templat yang beragam 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:

C#

Templat	Penyedia 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

Jawa

Templat	Penyedia aplikasi	Tumpukan teknologi
Aplikasi Web React dengan Java API dan MongoDB di Azure	Azure App Service	API Azure Cosmos DB untuk Mongo, Bicep
Aplikasi Web React Kontainer dengan Java API dan MongoDB di Azure	Azure Container Apps	API Azure Cosmos DB untuk Mongo, Bicep

Node.js

Templat	Penyedia aplikasi	Tumpukan teknologi
Aplikasi Web React dengan API Node.js dan MongoDB di Azure	Azure App Service	Azure Cosmos DB untuk MongoDB, Bicep
Aplikasi Web React dengan API Node.js dan MongoDB (Terraform) di Azure	Azure App Service	Azure Cosmos DB untuk MongoDB, Terraform
Aplikasi Web React Menggunakan Kontainer dengan API Node.js dan MongoDB di Azure	Azure Container Apps	Azure Cosmos DB untuk MongoDB, Bicep
Aplikasi Web Statis React + Functions dengan Node.js API dan MongoDB di Azure	Azure Static Web Apps, Azure Functions	Azure Cosmos DB untuk MongoDB, Bicep
Aplikasi Web React Kubernetes dengan API Node.js dan MongoDB di Azure	Layanan Azure Kubernetes	Azure Cosmos DB untuk MongoDB, Bicep

Ular sawah

Templat	Penyedia aplikasi	Tumpukan teknologi
Aplikasi Web React dengan Python API dan MongoDB di Azure	Azure App Service	Azure Cosmos DB untuk MongoDB, Bicep
Aplikasi Web React dengan Python API dan MongoDB (Terraform) di Azure	Azure App Service	Azure Cosmos DB untuk MongoDB, Terraform
Web App React Terkontainerisasi dengan API Python dan MongoDB di Azure	Azure Container Apps	Azure Cosmos DB untuk MongoDB, Bicep
Static React Web App + Functions dengan Python API dan MongoDB di Azure	Azure Static Web Apps, Azure Functions	Azure Cosmos DB untuk MongoDB, Bicep

Template Dasar (hanya IaC)

Templat	Penyedia aplikasi	Tumpukan teknologi
Bicep Starter	-	Bicep, file konfigurasi dev kontainer, definisi alur CI/CD untuk menguji aplikasi Anda dengan sumber daya di Azure
Terraform Starter	-	File konfigurasi kontainer pengembangan Terraform, definisi alur CI/CD untuk menguji aplikasi Anda terhadap sumber daya aplikasi Anda di Azure

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.
• Perbarui file azure.yaml untuk mengikat layanan aplikasi bersama dengan sumber daya Azure.
• Penyediaan dan penerapan dengan azd up.

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

• Membangun templat Azure Developer CLI pertama Anda
• Buat proyek Anda kompatibel dengan azd panduan

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 selanjutnya

Memilih dan menyebarkan templat