Mengonfigurasi dan menggunakan sumber templat

Azure Developer CLI dirancang di sekitar sistem templat canggih yang menyederhanakan penyebaran dan provisi sumber daya Azure. Saat mengembangkan dengan azd, Anda memiliki opsi untuk membangun templat Anda sendiri, atau memilih dari daftar templat yang dapat dikonfigurasi. Dalam artikel ini, Anda mempelajari cara bekerja dengan daftar templat dan mengonfigurasi penginstalan lokal azd Anda untuk mendukung sumber daftar templat yang berbeda.

Memahami sumber templat

Sumber templat azd menunjuk ke file konfigurasi JSON yang menjelaskan daftar templat yang tersedia dan metadata pentingnya, seperti nama, deskripsi, dan lokasi kode sumber templat (biasanya repositori GitHub). Saat Anda mengaktifkan sumber templat, templat yang ditentukannya tersedia untuk azd melalui perintah lain. Misalnya, cuplikan JSON sumber templat di bawah ini menentukan dua templat:

[
  {
    "name": "Starter - Bicep",
    "description": "A starter template with Bicep as infrastructure provider",
    "repositoryPath": "azd-starter-bicep",
    "tags": ["bicep"]
  },
  {
    "name": "Starter - Terraform",
    "description": "A starter template with Terraform as infrastructure provider",
    "repositoryPath": "azd-starter-terraform",
    "tags": ["terraform"]
  }
]

Setiap entri templat dalam file konfigurasi JSON menyertakan properti berikut:

  • nama: Nama tampilan templat.
  • deskripsi: Ringkasan singkat tentang fungsi template.
  • repositoriPath: Jalur ke kode sumber templat, yang dapat berupa:
    • URI yang sepenuhnya memenuhi syarat ke repositori Git, seperti "https://dev.azure.com/org/project/_git/repo".
    • "{owner}/{repo}" untuk repositori GitHub.
    • "{repo}" untuk repositori GitHub di bawah organisasi Azure-Samples.
  • tag: Kata kunci yang membantu pengguna memfilter template dengan azd init --filter <tag> dan azd template list --filter <tag>.

Untuk contoh lengkapnya, lihat file JSON ini, yang merupakan sumber templat default yang disertakan dalam azd.

azd memungkinkan Anda mengaktifkan beberapa sumber templat pada satu waktu. Opsi sumber templat berikut saat ini tersedia untuk dipilih:

  • awesome-azd - Daftar templat dari galeri AZD Mengagumkan yang diaktifkan secara default.
  • default - Sekumpulan kecil templat yang dikumpulkan untuk menunjukkan tumpukan teknologi yang berbeda.
  • file - Jalur lokal/jaringan yang menunjuk ke file konfigurasi JSON sumber templat.
  • url - Jalur yang dapat diatasi HTTP yang menunjuk ke file konfigurasi JSON sumber templat.
  • gh - Menunjuk ke repositori GitHub.
  • ade - Menunjuk ke daftar templat Lingkungan Penyebaran Azure. Pelajari selengkapnya tentang dukungan Azure Developer CLI untuk Lingkungan Penyebaran Azure.

Bekerja dengan sumber templat

azd menyediakan beberapa perintah untuk mengonfigurasi sumber templat.

azd template source list Gunakan perintah untuk mencantumkan semua sumber templat yang saat ini dikonfigurasi:

azd template source list

Contoh output dengan dua sumber templat yang dikonfigurasi:

Key          Name         Type         Location

awesome-azd  Awesome AZD  awesome-azd  https://aka.ms/awesome-azd/templates.json
default      Default      resource

azd template source add Gunakan perintah untuk menambahkan sumber templat baru. Perintah ini menerima parameter berikut:

  • kunci: Nama teknis sumber templat.
  • --type, -t: Jenis sumber templat - nilai yang valid adalah file, url, dan gh untuk GitHub.
  • --location, -l: Lokasi sumber templat, yang seharusnya merupakan jaringan lokal atau URI web HTTP(S).
  • --name, -n: Nama tampilan sumber templat (opsional, menggunakan kunci jika tidak diisi).
azd template source add <key> --type <file-or-url-or-gh> --location <your-uri> --name <your-display-name>

azd template source remove Gunakan perintah untuk menghapus sumber templat:

azd template source remove <key>

azd config reset Gunakan perintah untuk mengatur ulang konfigurasi templat kembali ke pengaturan default:

azd config reset

Bekerja dengan daftar templat

Setelah Mengonfigurasi sumber templat, gunakan azd template list perintah untuk mencantumkan templat yang tersedia dari sumber tersebut:

azd template list

Misalnya, penginstalan azd default mencantumkan templat berikut dari sumber templat awesome-azd :

Name                                                         Source       Repository Path

Event Driven Java Application with Azure Service Bus         Awesome AZD  Azure-Samples/ASA-Samples-Event-Driven-Application
Static React Web App with Java API and PostgreSQL            Awesome AZD  Azure-Samples/ASA-Samples-Web-Application
SAP CAP on Azure App Service Quickstart                      Awesome AZD  Azure-Samples/app-service-javascript-sap-cap-quickstart
SAP Cloud SDK on Azure App Service Quickstart (TypeScript)   Awesome AZD  Azure-Samples/app-service-javascript-sap-cloud-sdk-quickstart
Java Spring Apps with Azure OpenAI                           Awesome AZD  Azure-Samples/app-templates-java-openai-springapps
WordPress with Azure Container Apps                          Awesome AZD  Azure-Samples/apptemplate-wordpress-on-ACA
Bicep template to bootstrap Azure Deployment Environments    Awesome AZD  Azure-Samples/azd-deployment-environments
Starter - Bicep                                              Awesome AZD  Azure-Samples/azd-starter-bicep
Starter - Terraform                                          Awesome AZD  Azure-Samples/azd-starter-terraform
...
# Additional templates omitted

Sertakan --source bendera untuk hanya mencantumkan templat dari sumber tertentu:

azd template list --source <source-name>

Untuk menginisialisasi templat dari daftar yang ditampilkan, jalankan perintah azd init dan berikan jalur repositori templat:

azd init --template <path-value>

Bekerja dengan Lingkungan Penyebaran Azure

Azure Developer CLI (azd) juga menyediakan dukungan untuk Lingkungan Penyebaran Azure. Azure Deployment Environment (ADE) adalah kumpulan sumber daya Azure yang telah dikonfigurasi sebelumnya yang disebarkan dalam langganan yang telah ditentukan sebelumnya. Tata kelola Azure diterapkan ke langganan tersebut berdasarkan jenis lingkungan, seperti kotak pasir, pengujian, penahapan, atau produksi. Dengan Lingkungan Penyebaran Azure, Anda dapat menerapkan kebijakan keamanan perusahaan dan menyediakan serangkaian templat infrastruktur sebagai kode (IaC) yang telah ditentukan sebelumnya.

Integrasi ADE berada di luar cakupan artikel ini. Pelajari selengkapnya tentang mengonfigurasi ade dukungan dalam dokumentasi dukungan Azure Developer CLI untuk Lingkungan Penyebaran Azure.

Langkah berikutnya

Dukungan Azure Developer CLI untuk referensi perintah daftar Templat LingkunganPenyebaran Azure

  • Last updated on