Jelajahi konfigurasi Azure Developer CLI

Azure Developer CLI (azd) memungkinkan Anda mengelola azd konfigurasi menggunakan sekumpulan azd config perintah. Pengaturan konfigurasi ini mencakup default yang berguna seperti langganan dan lokasi Azure Anda, serta pengaturan yang digunakan oleh perintah atau fitur lainazd. Anda juga bisa mendapatkan dan mengatur nilai kustom Anda sendiri dan menggunakannya dalam skrip atau fungsionalitas kustom.

Dalam artikel ini, Anda belajar tentang:

• Konsep utama tentang konfigurasi CLI Pengembang Azure
• Cara menggunakan azd config perintah
• Bagaimana azd config terintegrasi dengan fitur lain azd

Menelusuri file konfigurasi Azure Developer CLI

Saat anda pertama kali menginstal Azure Developer CLI, file bernama config.json ditambahkan di lokasi berikut:

• $HOME/.azd di Linux dan macOS
• %USERPROFILE%\.azd pada Windows

Tip

Direktori konfigurasi dapat diganti dengan menetapkan path di dalam variabel lingkungan AZD_CONFIG_DIR.

Pengaturan dalam file ini mengelola fungsionalitas seperti:

• Langganan atau lokasi Azure default yang akan digunakan saat Anda memprovisikan atau menyebarkan sumber daya
• Fitur alfa mana yang diaktifkan
• Lokasi sumber templat mana yang dikonfigurasi
• Nilai kustom yang ditetapkan oleh pengguna untuk skrip atau tujuan lainnya

Secara default, config.json file hanya berisi beberapa konfigurasi untuk lokasi sumber templat default azd . Saat Anda menggunakan berbagai fitur Azure Developer CLI, beberapa nilai diisi config.json secara otomatis. Misalnya, pertama kali Anda menjalankan azd up perintah, langganan dan lokasi yang Anda pilih untuk provisi dan penyebaran disimpan di bagian defaults file.

File sederhana config.json mungkin menyerupai berikut ini:

{
  "defaults": {
    "location": "eastus2",
    "subscription": "your-subscription-id"
  },
  "template": {
    "sources": {
      "awesome-azd": {
        "key": "awesome-azd",
        "location": "https://aka.ms/awesome-azd/templates.json",
        "name": "Awesome AZD",
        "type": "awesome-azd"
      },
      "default": {
        "key": "default",
        "name": "default"
      }
    }
  }
}

Bekerja dengan perintah konfigurasi

Azure Developer CLI menyediakan sekumpulan perintah untuk mengelola pengaturan dalam config.json file secara manual:

• azd config get: Ambil nilai konfigurasi.
• azd config list-alpha: Tampilkan daftar fitur yang tersedia dalam tahap alfa.
• azd config reset: Reset konfigurasi ke default.
• azd config set: Atur konfigurasi.
• azd config show: Tampilkan semua nilai konfigurasi.
• azd config unset: Batalkan pengaturan konfigurasi.

Perintah ini dieksplorasi lebih lanjut di bagian berikut. Anda juga dapat mengunjungi halaman referensi perintah CLI Pengembang Azure untuk mempelajari selengkapnya tentang azd perintah.

Menampilkan konfigurasi

Lihat konten config.json seluruh file saat ini kapan saja dengan menjalankan azd config show perintah:

azd config show

Contoh output:

{
  "defaults": {
    "location": "eastus2",
    "subscription": "your-subscription-id"
  },
  "template": {
    "sources": {
      "awesome-azd": {
        "key": "awesome-azd",
        "location": "https://aka.ms/awesome-azd/templates.json",
        "name": "Awesome AZD",
        "type": "awesome-azd"
      },
      "default": {
        "key": "default",
        "name": "default"
      }
    }
  }
}

Tampilkan nilai konfigurasi tertentu menggunakan azd config get <key> perintah :

azd config get defaults

Contoh output:

"defaults": {
    "location": "eastus2",
    "subscription": "your-subscription-id"
}

Mengaktifkan atau menonaktifkan fitur alfa adalah tugas konfigurasi umum, jadi azd juga menyertakan perintah kenyamanan untuk melihat status fitur alfa saat ini:

azd config list-alpha

Contoh output:

Name: aca.persistDomains
Description: Do not change custom domains when deploying Azure Container Apps.
Status: Off

Name: aca.persistIngressSessionAffinity
Description: Do not change Ingress Session Affinity when deploying Azure Container Apps.
Status: Off

Name: aks.helm
Description: Enable Helm support for AKS deployments.
Status: On

Name: aks.kustomize
Description: Enable Kustomize support for AKS deployments.
Status: Off

Name: azd.operations
Description: Extends provisioning providers with azd operations.
Status: Off

Name: deployment.stacks
Description: Enables Azure deployment stacks for ARM/Bicep based deployments.
Status: Off

Name: llm
Description: Enables the use of LLMs in the CLI.
Status: Off

Mendapatkan dan menetapkan konfigurasi

Anda dapat mengambil, menetapkan, atau menghapus nilai dalam file config.json menggunakan perintah azd config. Beberapa konfigurasi tertentu digunakan oleh fitur dan perintah lain azd , seperti saat mengaktifkan fitur alfa atau mengatur sumber templat, tetapi Anda juga dapat mengatur nilai kustom Anda sendiri.

Mengelola konfigurasi yang digunakan oleh azd

azd config set <key> <value> Gunakan perintah untuk menambahkan pengaturan konfigurasi ke config.json file.

Misalnya, untuk mengaktifkan fitur LLM yang digunakan oleh integrasi GitHub Copilot:

azd config set alpha.llm on

Nota

Memilih Siapkan menggunakan GitHub Copilot (Pratinjau) saat azd init akan mengaktifkan pengaturan ini secara otomatis. Gunakan . sintaks untuk melintasi struktur objek JSON saat Anda mendapatkan dan mengatur nilai konfigurasi.

Verifikasi pengaturan diaktifkan menggunakan azd config get <key> perintah , seperti berikut ini:

azd config get alpha.llm

Contoh output:

"on"

Dalam skenario ini, Anda juga dapat menjalankan azd config get alpha untuk melihat seluruh objek JSON dalam config.json file:

azd config get alpha

Contoh output:

{
  "llm": "on"
}

Mengelola konfigurasi kustom

Anda juga dapat menetapkan nilai konfigurasi kustom untuk digunakan di hook azd dan skrip milik pelanggan. Nilai konfigurasi ini menyediakan alternatif untuk menggunakan variabel lingkungan.

Untuk mengatur nilai konfigurasi kustom:

azd config get customVal hello-world

Dapatkan nilai konfigurasi kustom:

azd config get customVal

Contoh output:

hello-world

Mengatur ulang konfigurasi

Anda dapat mengatur ulang file CLI config.json Pengembang Azure kembali ke defaultnya menggunakan azd config reset perintah , yang menghapus konten file:

azd config reset

Saat Anda menjalankan azd config show setelah reset, Anda hanya akan melihat objek kosong:

{}

Langkah berikutnya

Gambaran umum pengembangan templat