Dalam panduan cepat ini, Anda akan mempelajari cara mengonfigurasi dan menerapkan sumber daya aplikasi di Azure menggunakan templat Azure Developer CLI (azd) serta hanya beberapa perintah azd. templat azd adalah repositori kode standar yang menyertakan kode sumber aplikasi Anda, serta konfigurasi azd dan file infrastruktur untuk menyediakan sumber daya Azure. Untuk mempelajari selengkapnya tentang templat azd dan bagaimana mereka dapat mempercepat proses penyediaan dan penerapan Azure Anda, lihat Apa itu templat CLI Pengembang Azure?.
Memilih dan menyebarkan templat
Untuk langkah-langkah ke depan, Anda akan menggunakan templat berikut untuk memprovisikan dan menyebarkan aplikasi di Azure:
Anda juga dapat memilih templat yang cocok dengan preferensi Anda dari situs galeri templat AZD yang Mengagumkan. Terlepas dari templat mana yang Anda gunakan, Anda akan berakhir dengan kode templat di lingkungan pengembangan Anda dan dapat menjalankan perintah untuk membangun, menyebarkan ulang, dan memantau aplikasi di Azure.
Pilih lingkungan pilihan Anda untuk melanjutkan:
Lingkungan pengembangan lokal adalah pilihan yang bagus untuk alur kerja pengembangan tradisional. Anda akan mengkloning repositori templat ke perangkat Anda dan menjalankan perintah terhadap penginstalan azd lokal.
Prasyarat
Menginisialisasi proyek
Di File Explorer atau terminal, buat direktori kosong baru, dan ubah ke dalamnya.
Jalankan azd init perintah dan tentukan templat yang ingin Anda gunakan sebagai parameter:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Masukkan nama lingkungan saat diminta, seperti azdquickstart, yang menetapkan awalan penamaan untuk grup sumber daya yang akan dibuat untuk menyimpan sumber daya Azure.
Apa itu Nama Lingkungan di azd?
Setelah Anda menentukan lingkungan, azd klon proyek templat ke komputer Anda dan menginisialisasi proyek.
Memprovisikan dan menyebarkan sumber daya aplikasi
Jalankan azd auth login perintah dan azd luncurkan browser bagi Anda untuk menyelesaikan proses masuk.
azd auth login
Jalankan azd up perintah:
azd up
Setelah masuk ke Azure, Anda akan dimintai informasi berikut:
| Parameter |
Deskripsi |
Azure Location |
Lokasi Azure tempat sumber daya Anda akan disebarkan. |
Azure Subscription |
Langganan Azure tempat sumber daya Anda akan disebarkan. |
Pilih nilai yang Anda inginkan dan tekan enter. Perintah azd up menangani tugas berikut untuk Anda menggunakan konfigurasi templat dan file infrastruktur:
- Membuat dan mengonfigurasi semua sumber daya Azure yang diperlukan (
azd provision), termasuk:
- Mengakses kebijakan dan peran untuk akun Anda
- Komunikasi layanan ke layanan dengan Identitas Terkelola
- Mengemas dan menyebarkan kode (
azd deploy)
azd up Ketika perintah berhasil diselesaikan, CLI menampilkan dua tautan untuk melihat sumber daya yang dibuat:
- Aplikasi ToDo API
- Antarmuka aplikasi web ToDo
Catatan
Anda dapat memanggil azd up sebanyak yang Anda inginkan untuk menyediakan dan menyebarkan pembaruan ke aplikasi Anda.
Penyebaran mungkin gagal karena sumber daya tidak dapat disebarkan di wilayah yang dipilih. Karena ini adalah mulai cepat, aman untuk menghapus .azure direktori dan mencoba azd up lagi. Saat diminta, pilih wilayah lain. Dalam skenario yang lebih canggih, Anda dapat mengedit file secara selektif dalam .azure direktori untuk mengubah wilayah.
Azure Developer CLI menyediakan ekstensi Visual Studio Code untuk menyederhanakan bekerja dengan fitur azd. Misalnya, Anda dapat menggunakan antarmuka palet perintah untuk menjalankan azd perintah. Anda perlu menginstal ekstensi Azure Developer CLI untuk Visual Studio Code agar dapat menyelesaikan langkah-langkah berikut.
Menginstal ekstensi CLI Pengembang Azure
Buka Visual Studio Code.
Dari menu Tampilan , pilih Ekstensi.
Di bidang pencarian, masukkan Azure Developer CLI.
Pilih Instal dan tunggu hingga proses penginstalan selesai.
Menginisialisasi aplikasi baru
Buka direktori kosong di Visual Studio Code.
Dari menu Tampilan , pilih Palet Perintah....
Cari perintah Azure Developer CLI (azd): Initialize app (init) dan tekan enter. Perintah ini azd up menginstruksikan azd untuk menyediakan dan menyebarkan sumber daya aplikasi.
Pilih alur kerja Pilih templat .
Cari React Web App dengan API Node.js dan MongoDB pada templat Azure dan tekan enter untuk memilihnya.
Visual Studio Code mengkloning templat azd. Templat menyertakan infrastruktur sebagai file kode di infra folder dan aplikasi sampel di src folder. Infrastruktur sebagai file kode menyediakan sumber daya yang diperlukan pada Azure yang diperlukan oleh aplikasi saat disebarkan.
Cari templat React Web App dengan Python API dan MongoDB pada templat Azure dan tekan enter untuk memilihnya.
Visual Studio Code mengkloning templat azd. Templat menyertakan infrastruktur sebagai file kode di infra folder dan aplikasi sampel di src folder. Infrastruktur sebagai file kode menyediakan sumber daya yang diperlukan pada Azure yang diperlukan oleh aplikasi saat disebarkan.
Cari React Web App dengan C# API dan MongoDB pada templat Azure dan tekan enter untuk memilihnya.
Visual Studio Code menggandakan templat azd. Templat menyertakan infrastruktur sebagai file kode di infra folder dan aplikasi sampel di src folder. Infrastruktur sebagai file kode menyediakan sumber daya yang diperlukan pada Azure yang diperlukan oleh aplikasi saat disebarkan.
Cari Containerized React Web App dengan API Java dan MongoDB pada templat Azure dan tekan enter untuk memilihnya.awesome-azd.
Visual Studio Code mengkloning templat azd. Templat menyertakan infrastruktur sebagai file kode di infra folder dan aplikasi sampel di src folder. Infrastruktur sebagai file kode menyediakan sumber daya yang diperlukan pada Azure yang diperlukan oleh aplikasi saat disebarkan.
Setelah templat dikloning, Visual Studio Code membuka terminal untuk meminta nama lingkungan kepada Anda. Masukkan nama pendek pilihan Anda seperti azdvscode dan tekan enter.
Enter a new environment name: [? for help] azdvscode
Nama lingkungan memengaruhi penamaan sumber daya yang disediakan dalam Azure dan membuat folder di direktori templat .azure untuk menyimpan pengaturan lingkungan tertentu.
Memprovisikan dan menyebarkan sumber daya aplikasi
Buka Palet Perintah dan cari perintah Azure Developer CLI (azd): Package, Provision and Deploy(up) dan tekan enter. Perintah ini azd up menginstruksikan azd untuk menyediakan dan menyebarkan sumber daya aplikasi.
Visual Studio Code membuka jendela terminal untuk menampilkan kemajuan proses provisi dan penyebaran.
azd menggunakan pengaturan langganan dan lokasi yang Anda pilih selama init proses saat menyebarkan sumber daya.
Catatan
Proses provisi dan penyebaran dapat memakan waktu beberapa menit.
Ketika proses penyebaran selesai, pilih tautan di jendela output yang disediakan oleh azd untuk meluncurkan situs Anda di browser.
Codespace adalah opsi yang bagus untuk pengembang yang lebih suka bekerja di lingkungan cloud dalam kontainer dan menghindari penginstalan alat atau dependensi secara lokal.
Siapkan Codespace Anda
- Di atas daftar file, klik Gunakan templat>ini Buka di Codespace.
Dengan Codespaces, semua prasyarat diinstal untuk Anda, termasuk ekstensi azd Visual Studio Code.
Jalankan template
Setelah Codespace Anda dibuat, Klik kanan azure.yaml di direktori root. Dari opsi, pilih up (provisikan sumber daya, dan sebarkan kode ke Azure).
Saat menjalankan azd up perintah, Anda akan diminta untuk memberikan informasi berikut dan masuk menggunakan browser web dan kode autentikasi:
| Parameter |
Deskripsi |
Environment Name |
Awalan untuk grup sumber daya yang akan dibuat untuk menyimpan semua sumber daya Azure. Apa itu Nama Lingkungan di azd? Anda selalu dapat membuat lingkungan baru dengan azd env new. |
Azure Location |
Lokasi Azure tempat sumber daya Anda akan disebarkan. |
Azure Subscription |
Langganan Azure tempat sumber daya Anda akan disebarkan. |
Proses ini mungkin membutuhkan waktu untuk diselesaikan, karena azd up perintah menangani tugas berikut:
- Membuat dan mengonfigurasi semua sumber daya Azure yang diperlukan (
azd provision).
- Mengonfigurasi kebijakan dan peran akses untuk akun Anda.
- Melakukan komunikasi antar-layanan dengan Identitas Terkelola.
- Mengemas dan menyebarkan kode (
azd deploy).
Setelah Anda memberikan parameter yang diperlukan dan perintah azd up selesai, terminal CodeSpaces menampilkan dua tautan portal Azure untuk melihat sumber daya yang dibuat:
- Aplikasi ToDo API
- Antarmuka aplikasi web ToDo
Apa yang terjadi?
Setelah berhasil menyelesaikan azd up perintah:
- Sumber daya Azure yang direferensikan dalam file
README.md templat telah diprovisikan ke langganan Azure yang Anda tentukan setelah Anda menjalankan azd up. Anda sekarang dapat melihat sumber daya Azure tersebut melalui portal Azure.
- Aplikasi ini telah dibangun dan disebarkan ke Azure. Dengan menggunakan output URL dari perintah
azd up, Anda dapat mengakses aplikasi yang sepenuhnya berfungsi.
Catatan
- Anda dapat memanggil
azd up sebanyak yang Anda suka untuk menyediakan dan menyebarkan aplikasi Anda.
- Menjalankan dan mendebug yang memerlukan peluncuran peramban web saat ini tidak didukung karena ada batasan yang sudah diketahui dengan GitHub Codespaces. Untuk pengalaman yang lebih baik, sebaiknya gunakan Codespace di Desktop.
DevContainer adalah gambar Docker yang menyertakan semua prasyarat yang Anda butuhkan untuk bekerja dengan azd templat di komputer lokal Anda. Mereka adalah pilihan yang bagus untuk pengembang yang lebih menyukai lingkungan kontainer yang masih berjalan di perangkat lokal alih-alih layanan cloud seperti GitHub Codespaces.
Prasyarat
Menginisialisasi proyek
Buka terminal, buat direktori kosong baru, dan ubah ke dalamnya.
Jalankan perintah berikut untuk menginisialisasi proyek:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Saat menjalankan azd init perintah, Anda akan diminta untuk memberikan informasi berikut:
| Parameter |
Deskripsi |
Environment Name |
Awalan untuk grup sumber daya yang akan dibuat untuk menyimpan semua sumber daya Azure. Apa itu Nama Lingkungan di azd? Anda selalu dapat membuat lingkungan baru dengan azd env new. |
Buka DevContainer
- Buka proyek di Visual Studio Code.
- Tekan F1 dan pilih:
Remote-Containers: Rebuild and Reopen in Container
Jalankan up perintah
Jalankan perintah berikut:
azd up
Saat menjalankan azd up perintah, Anda akan diminta untuk memberikan informasi berikut:
| Parameter |
Deskripsi |
Azure Location |
Lokasi Azure tempat sumber daya Anda akan disebarkan. |
Azure Subscription |
Langganan Azure tempat sumber daya Anda akan disebarkan. |
Perintah azd up mungkin membutuhkan waktu untuk berjalan saat menyelesaikan langkah-langkah berikut:
- Membuat dan mengonfigurasi semua sumber daya Azure yang diperlukan (
azd provision), termasuk:
- Mengakses kebijakan dan peran untuk akun Anda
- Komunikasi layanan ke layanan dengan Identitas Terkelola
- Mengemas dan menyebarkan kode (
azd deploy)
Setelah Anda memberikan parameter yang diperlukan dan perintah azd up selesai, CLI menampilkan dua tautan portal Azure untuk melihat sumber daya yang dibuat:
- Aplikasi ToDo API
- Antarmuka aplikasi web ToDo
Catatan
Anda dapat menjalankan azd up sebanyak yang Anda suka untuk menyediakan dan menyebarkan aplikasi Anda ke wilayah yang sama dan dengan nilai konfigurasi yang sama dengan yang Anda berikan pada eksekusi pertama.
Membersihkan sumber daya
Saat Anda tidak lagi memerlukan sumber daya yang dibuat dalam artikel ini, jalankan perintah berikut untuk mematikan aplikasi:
azd down
Jika Anda ingin menyebarkan ulang ke wilayah lain, hapus .azure direktori sebelum berjalan azd up lagi. Dalam skenario yang lebih canggih, Anda dapat mengedit file secara selektif dalam .azure direktori untuk mengubah wilayah.
Meminta bantuan
Untuk informasi tentang cara mengajukan bug, meminta bantuan, atau mengusulkan fitur baru untuk Azure Developer CLI, silakan kunjungi halaman troubleshooting dan dukungan.
Langkah berikutnya