Menambahkan dukungan Azure Developer CLI ke aplikasi Anda menggunakan kode di direktori aplikasi Anda

Artikel
09/13/2024

Azure Developer CLI (azd) menyediakan dua alur kerja yang berbeda untuk menginisialisasi templat untuk digunakan dengan aplikasi Anda, yang meliputi:

Gunakan kode di direktori saat ini: Pendekatan ini menganalisis aplikasi Anda dan membuat otomatis infrastruktur dan sumber daya konfigurasi yang didukung.
Pilih templat: Pendekatan ini memungkinkan Anda mengintegrasikan templat yang sudah ada dengan aplikasi Anda, atau menggunakan templat yang sudah ada sebagai titik awal untuk aplikasi baru.

Kedua pendekatan ini dieksplorasi dalam dokumen gambaran umum Buat templat Azure Developer CLI.

Dalam artikel ini, Anda mempelajari cara menambahkan dukungan untuk Azure Developer CLI (azd) ke aplikasi Anda melalui menggunakan kode dalam pendekatan direktori saat ini. azd Kunjungi tambahkan dukungan ke aplikasi Anda menggunakan dokumen templat yang ada untuk informasi selengkapnya tentang pendekatan alternatif. Anda juga dapat mengunjungi templat Pelatihan - membangun dan menyebarkan azd untuk informasi selengkapnya tentang membangun azd templat.

Gunakan kode dalam direktori saat ini

Anda dapat mengikuti langkah-langkah di depan menggunakan proyek Anda sendiri. Namun, jika Anda lebih suka mengikuti menggunakan aplikasi sampel, kloning repositori pemula berikut ke direktori kosong di komputer Anda:
```
git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart
```
Buka terminal ke direktori akar proyek.
Jalankan azd init perintah untuk menginisialisasi templat.
```
azd init
```
Saat diminta, pilih opsi untuk Menggunakan kode di direktori saat ini. azd menganalisis proyek dan menyediakan ringkasan layanan yang terdeteksi dan sumber daya hosting Azure yang direkomendasikan.
Pilih Konfirmasi dan lanjutkan menginisialisasi aplikasi saya. azd menghasilkan aset berikut dalam direktori akar proyek:
- File azure.yaml dengan definisi layanan yang sesuai.
- Folder infra dengan file infrastruktur sebagai kode untuk memprovisikan dan menyebarkan proyek ke Azure.
- .azure Folder dengan variabel lingkungan yang .env diatur dalam file.
Detail selengkapnya tentang proses deteksi dan pembuatan ini disediakan nanti di artikel.
File yang dihasilkan berfungsi apa adanya untuk aplikasi sampel yang disediakan dan mungkin juga untuk aplikasi Anda sendiri. Jika perlu, file yang dihasilkan dapat dimodifikasi agar sesuai dengan kebutuhan Anda. Misalnya, Anda mungkin perlu memodifikasi lebih lanjut file infrastruktur sebagai kode di infra folder jika aplikasi Anda bergantung pada sumber daya Azure di luar yang diidentifikasi oleh azd.
Jalankan azd up perintah untuk memprovisikan dan menyebarkan aplikasi Anda ke Azure.
```
azd up
```
Saat diminta, pilih langganan dan lokasi yang diinginkan untuk memulai proses provisi dan penyebaran.
Saat proses selesai, klik tautan di azd output untuk membuka aplikasi di browser.

Menjelajahi langkah-langkah inisialisasi

Saat Anda memilih Gunakan kode di alur kerja direktori saat ini, azd init perintah menganalisis proyek Anda dan membuat kode secara otomatis berdasarkan apa yang ditemukannya. Bagian di bawah ini menjelaskan detail cara kerja proses ini dan teknologi mana yang saat ini didukung.

Detection

Perintah mendeteksi azd init file proyek untuk bahasa yang didukung yang terletak di direktori proyek dan subdirektori Anda. azd juga memindai dependensi paket untuk mengumpulkan informasi tentang kerangka kerja web atau database yang digunakan aplikasi Anda. Jika diperlukan, Anda dapat menambahkan atau mengedit komponen yang terdeteksi secara manual seperti yang disajikan dalam prompt ringkasan konfirmasi.

Logika deteksi saat ini adalah sebagai berikut:

Bahasa yang didukung:
- Python
- JavaScript/TypeScript
- .NET
- Java
Database yang didukung:
- MongoDB
- PostgreSQL
Untuk Python dan JavaScript/TypeScript, kerangka kerja web dan database terdeteksi secara otomatis.
Saat proyek JavaScript/TypeScript menggunakan kerangka kerja web front-end (atau sisi klien), proyek tersebut diklasifikasikan sebagai layanan front-end. Jika layanan Anda menggunakan kerangka kerja web front-end yang saat ini tidak terdeteksi, Anda dapat memilih JQuery untuk memberikan klasifikasi dan perilaku layanan front-end yang setara.

Generation

Setelah Anda mengonfirmasi komponen yang terdeteksi, azd init menghasilkan file infrastruktur sebagai kode yang diperlukan untuk menyebarkan aplikasi Anda ke Azure.

Logika pembuatannya adalah sebagai berikut:

Host yang didukung:
- Azure Container Apps.
Untuk database, pemetaan yang didukung antara teknologi database dan layanan yang digunakan:
- MongoDB: Api Azure CosmosDB untuk MongoDB
- PostgreSQL: Server fleksibel Azure Database for PostgreSQL
- Redis: Add-on Azure Container Apps Redis
Layanan yang menggunakan database akan memiliki variabel lingkungan yang menyediakan koneksi ke database yang telah dikonfigurasi sebelumnya secara default.
Ketika layanan front-end dan back-end terdeteksi, konfigurasi CORS pada host Azure untuk layanan back-end akan diperbarui untuk memungkinkan domain hosting default layanan front-end. Ini dapat dimodifikasi atau dihapus seperlunya dalam file konfigurasi Infrastruktur sebagai Kode.

Menambahkan dukungan untuk kontainer dev

Anda juga dapat membuat templat Anda kompatibel dengan kontainer pengembangan dan Codespace. Kontainer pengembangan memungkinkan Anda menggunakan kontainer sebagai lingkungan pengembangan berfungsi lengkap. Ini dapat digunakan untuk menjalankan aplikasi, untuk memisahkan alat, pustaka, atau runtime yang diperlukan untuk bekerja dengan basis kode, dan untuk membantu integrasi dan pengujian berkelanjutan. Kontainer dev dapat dijalankan secara lokal atau jarak jauh, di cloud privat atau publik. (Sumber: https://containers.dev/)

Untuk menambahkan dukungan untuk kontainer dev:

Buat folder .devcontainer di akar proyek Anda.
Buat devcontainer.json file di .devcontainer dalam folder dengan konfigurasi yang diinginkan. Templat azd pemula menyediakan file sampel devcontainer.json yang dapat Anda salin ke dalam proyek Anda dan memodifikasi sesuai kebutuhan.

Baca selengkapnya tentang bekerja dengan kontainer dev pada dokumentasi Visual Studio Code.

Menambahkan dukungan untuk alur CI/CD

Anda juga dapat menambahkan dukungan untuk CI/CD di templat Anda menggunakan tindakan GitHub atau Azure DevOps menggunakan langkah-langkah berikut:

.github Tambahkan folder untuk tindakan GitHub atau .ado folder untuk Azure DevOps ke akar proyek Anda.
Tambahkan file alur kerja ke folder baru. Templat azd pemula menyediakan file alur kerja Tindakan GitHub Sampel dan file Alur Azure DevOps Sampel untuk setiap platform yang dapat Anda salin ke dalam proyek Anda dan memodifikasi sesuai kebutuhan.
Anda mungkin juga perlu memperbarui main.parameters.json file di folder Anda infra dengan variabel lingkungan yang diperlukan agar alur kerja Anda berjalan.

Bagikan melalui