Buat Bicep menggunakan fitur komposisi

Fitur penyusunan Azure Developer CLI (azd) menyederhanakan proses membangun, menyebarkan, dan mengelola aplikasi cloud. Dengan menggunakan azd compose, Anda dapat menentukan dan mengelola infrastruktur dan kode aplikasi untuk proyek Anda dengan cara terpadu. Panduan ini menjelaskan cara menghasilkan kode Bicep dari azd compose fitur, memungkinkan Anda menyesuaikan infrastruktur cloud untuk memenuhi persyaratan spesifik Anda.

Cara azd compose mengelola status infrastruktur

Fitur ini azd compose melacak status infrastruktur Anda dalam memori selama proses komposisi. Pendekatan ini memungkinkan Anda untuk secara berulang menentukan dan menyempurnakan aplikasi dan infrastruktur Anda tanpa segera menghasilkan file atau memodifikasi direktori proyek Anda.

Saat Anda menjalankan perintah azd infra synth, status dalam memori dikonversi menjadi file Bicep di folder infra. Pada titik ini, status infrastruktur beralih dari dikelola dalam memori ke direpresentasikan sebagai kode, memungkinkan penyesuaian lebih lanjut.

Petunjuk / Saran

Gunakan azd compose untuk membuat prototipe infrastruktur Anda dengan cepat sebelum berkomitmen pada perubahan berbasis file dengan azd infra synth.

Membuat kode Bicep

Untuk menjelajahi atau menyesuaikan kode Bicep yang digunakan secara internal oleh azd untuk menyediakan sumber daya yang dibuat oleh azd add, jalankan perintah berikut:

azd infra gen

Nota

azd infra synth Perintah dari versi azd sebelumnya sekarang merupakan alias dari azd infra generate, dan akan terus berfungsi. Namun, pesan peringatan ditampilkan dan perintah mungkin dihapus dalam rilis mendatang azd .

Perintah ini menghasilkan file Bicep yang sesuai di infra folder aplikasi Anda.

Mengelola pembaruan dengan generasi Bicep

Saat Anda menjalankan perintah azd infra gen, Anda keluar dari alur kerja azd compose dan proses init yang disederhanakan. Mulai saat ini, setiap perubahan yang Anda buat pada file Bicep yang dihasilkan tidak lagi dilacak oleh azd compose. Jika Anda mengubah file Bicep dan kemudian menjalankan azd infra gen lagi, perubahan manual Anda akan ditimpa oleh kode yang baru dibuat.

Berikut tampilan alur kerja umumnya:

  1. Anda menggunakan azd add untuk menambahkan sumber daya Azure baru ke proyek Anda. Sumber daya ini dikelola secara internal oleh azd.
  2. Setelah selesai menambahkan sumber daya, Anda menjalankan azd infra gen untuk menghasilkan file Bicep untuk sumber daya tersebut di folder proyek infra . Pada tahap ini, sumber daya tidak lagi dikelola oleh azd compose alur kerja.
  3. Sekarang Anda dapat memperbarui file Bicep secara manual saat terus mengembangkan aplikasi.
  4. Jika Anda menambahkan lebih banyak azd infra gen sumber daya atau menjalankan infra lagi, konten folder akan diregenerasi, dan perubahan manual apa pun akan hilang.

Untuk alasan ini, fitur pembuatan paling cocok untuk skenario berikut:

  • Membuat sekumpulan sumber daya Azure awal untuk proyek Anda, lalu mengelola pembaruan lebih lanjut sendiri dengan mengedit file Bicep.
  • Mengelola sumber daya Azure Anda sepenuhnya melalui fitur pengaturan tanpa menjalankan azd infra gen.

Langkah selanjutnya