Dukungan Azure Developer CLI untuk Lingkungan Penyebaran Azure

Azure Developer CLI (azd) 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.

Prasyarat

Untuk bekerja dengan Lingkungan Penyebaran Azure menggunakan azd, verifikasi bahwa Anda menyelesaikan prasyarat berikut:

Mengaktifkan dukungan Lingkungan Penyebaran Azure

Anda dapat mengonfigurasi azd untuk menyediakan dan menyebarkan sumber daya ke lingkungan penyebaran Anda menggunakan perintah standar seperti azd up atau azd provision. Untuk mengaktifkan dukungan untuk Lingkungan Penyebaran Azure, jalankan perintah berikut:

azd config set platform.type devcenter

Ketika platform.type diatur ke devcenter, semua azd status lingkungan jarak jauh dan penyediaan memanfaatkan komponen pusat dev baru. Konfigurasi ini juga berarti bahwa infra folder di templat lokal Anda diabaikan. Sebagai gantinya, azd gunakan salah satu templat infrastruktur yang ditentukan dalam katalog pusat pengembangan Anda untuk provisi sumber daya.

Anda juga dapat menonaktifkan dukungan pusat pengembangan melalui perintah berikut:

azd config unset platform

Bekerja dengan Lingkungan Penyebaran Azure

Saat fitur pusat dev diaktifkan, perilaku default beberapa perintah azd umum berubah untuk bekerja dengan lingkungan jarak jauh ini. Fitur pusat pengembangan diperluas pada fungsionalitas yang disediakan oleh dukungan lingkungan jarak jauh azdstandar.

azd init

Pengalaman perintah azd init dalam mode pusat pengembangan menunjukkan semua templat ADE yang kompatibel dengan azd untuk pilihan dari katalog yang dikonfigurasi. Selama proses init, setelah azd mengkloning kode templat, file azure.yaml akan secara otomatis diperbarui untuk menyertakan bagian platform dengan konfigurasi yang dipilih berdasarkan templat yang dipilih. Konfigurasi ini mencakup nama pusat dev, katalog, dan definisi lingkungan.

azd init

azd up

Paket azd up perintah, provisi, dan penyebaran aplikasi Anda ke Lingkungan Penyebaran Azure. Namun, tahap azd up provisi perintah menggunakan templat infrastruktur sebagai kode yang dikumpulkan di pusat dev jarak jauh Anda, sementara tahap penyebaran menyebarkan kode sumber di templat Anda azd . Saat mode pusat dev diaktifkan, azd mengabaikan infra folder di templat lokal azd Anda dan hanya menyediakan sumber daya menggunakan templat pusat pengembangan. Perintah ini juga akan meminta nilai yang diperlukan, seperti proyek Lingkungan Penyebaran Azure atau jenis lingkungan.

azd up

daftar templat azd

Perintah ini azd template list menampilkan templat infrastruktur yang tersedia di katalog pusat pengembangan Anda, daripada menampilkan templat dari galeri AZD Awesome default. Catalogs menyediakan sekumpulan templat infrastruktur sebagai kode yang dikumpulkan dan disetujui yang dapat digunakan tim pengembangan Anda untuk membuat lingkungan.

azd template list

Cuplikan layar memperlihatkan galeri templat yang diperbarui.

provisi azd

Perintah azd provision membuat lingkungan pusat dev baru. Perintah meminta nilai yang hilang, seperti jenis lingkungan atau proyek. Saat perintah berjalan, perintah menggunakan templat infrastruktur terkait untuk menyediakan kumpulan sumber daya Azure yang benar untuk lingkungan tersebut. Saat mode pusat dev diaktifkan, azd mengabaikan infra folder di templat lokal azd Anda dan hanya menyediakan sumber daya menggunakan templat pusat pengembangan.

azd provision

azd env list (daftar lingkungan azd)

Perintah azd env list menampilkan daftar lingkungan yang sama dengan yang akan Anda lihat di portal pengembang.

azd env list

Menandai sumber daya untuk Lingkungan Penyebaran Azure

azd provisi untuk Lingkungan Penyebaran Azure bergantung pada templat yang dikumpulkan dari katalog pusat pengembangan. Templat dalam katalog mungkin atau mungkin tidak menetapkan tag ke sumber daya Azure yang disediakan bagi Anda untuk mengaitkan layanan aplikasi Anda dalam file azure.yaml. Jika templat tidak menetapkan tag, Anda dapat mengatasi masalah ini dengan salah satu dari dua cara:

  • Bekerja sama dengan administrator katalog pusat pengembangan Anda untuk memastikan sumber daya Azure yang disediakan menyertakan tag untuk mengaitkannya dengan layanan yang ditentukan dalam file azure.yaml Anda.

  • Tentukan resourceName dalam file azure.yaml Anda alih-alih menggunakan tag:

    services:
    api:
        project: ./src/api
        host: containerapp
        language: js
        resourceName: sample-api-containerapp
    web:
        project: ./src/web
        host: containerapp
        language: js
        resourceName: sample-web-containerapp

Mengonfigurasi pengaturan pusat dev

Anda dapat menentukan pengaturan azd untuk pusat pengembangan Anda di beberapa tempat. Pengaturan digabungkan dari lokasi ini untuk membuat kumpulan konfigurasi akhir dalam urutan prioritas berikut:

  1. Variabel lingkungan
  2. Konfigurasi lingkungan Azd
  3. Konfigurasi proyek
  4. Konfigurasi pengguna

azd akan secara otomatis meminta nilai konfigurasi apa pun yang hilang dari sumber ini. Masing-masing opsi konfigurasi ini dirinci di bagian berikut.

Variabel lingkungan

azd menemukan dan menggunakan variabel lingkungan berikut:

  • AZURE_DEVCENTER_NAME
  • AZURE_DEVCENTER_PROJECT
  • AZURE_DEVCENTER_CATALOG
  • AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
  • AZURE_DEVCENTER_ENVIRONMENT_TYPE
  • AZURE_DEVCENTER_ENVIRONMENT_USER

Menentukan konfigurasi

Tentukan konfigurasi untuk pusat dev Anda di cakupan lingkungan azd dalam file .azure/<env>/config.json:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Cakupan proyek

Tentukan konfigurasi untuk pusat dev Anda di cakupan proyek azd dalam simpul platform file azure.yaml:

name: todo-nodejs-mongo-aca
metadata:
    template: todo-nodejs-mongo-aca@0.0.1-beta
platform:
    type: devcenter
    config:
        catalog: SampleCatalog
        environmentDefinition: Todo
        name: sample-devcenter
        project: SampleProject
services:
    api:
        project: ./src/api
        host: containerapp
        language: js
    web:
        project: ./src/web
        host: containerapp
        language: js

Cakupan pengguna

Tentukan konfigurasi untuk pusat dev Anda di cakupan pengguna dalam file ~/<user_profile>/.azd/config.json:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}
  • Last updated on