Mengelola alat pengembangan Azure dengan azd tool

Azure Developer CLI (azd) mencakup grup perintah azd tool bawaan untuk menemukan, menginstal, meningkatkan, dan memeriksa status alat umum yang digunakan untuk membangun dan mengirim aplikasi Azure. Ini membungkus manajer paket bawaan di setiap platform (seperti winget, brew, apt, npm, dan CLI code VS Code) melalui serangkaian subperintah yang konsisten, serta mendukung penggunaan interaktif dan otomatisasi.

Kasus penggunaan umum untuk azd tool meliputi:

• Menginstal semua alat pengembangan Azure yang direkomendasikan pada komputer baru dengan satu perintah.
• Menstandarkan lingkungan pengembangan di seluruh tim atau sekumpulan agen CI.
• Mengaudit alat Azure mana (dan versi mana) yang diinstal pada komputer tertentu.
• Memeriksa dan menerapkan pembaruan ke alat yang diinstal.
• Menyiapkan alat skrip dalam pipeline menggunakan flag noninteraktif dan keluaran JSON.

Alat bawaan

Registri bawaan mencakup alat berikut. Gunakan kolom kategori dan prioritas untuk menentukan alat mana yang berlaku untuk alur kerja tertentu.

Id	Name	Category	Priority	Strategi penginstalan umum
az-cli	Azure CLI	cli	Recommended	winget / brew / apt
github-copilot-cli	CLI GitHub Copilot	cli	Recommended	winget / brew / npm
vscode-azure-tools	Alat Azure (VS Code)	extension	Recommended	code CLI
vscode-bicep	Bicep (Visual Studio Code)	extension	Recommended	code CLI
vscode-github-copilot	GitHub Copilot (Visual Studio Code)	extension	Optional	code CLI
azure-mcp-server	Azure Server MCP	server	Optional	npm
azd-ai-extensions	azd Ekstensi AI	library	Optional	azd extension

Strategi penginstalan yang tepat tergantung pada sistem operasi dan manajer paket yang tersedia pada komputer.

Note

Ekstensi VS Code memerlukan CLI code agar tersedia di PATH. Jika code tidak tersedia, alat menunjukkan sebagai tidak diinstal dan Anda tidak dapat menginstalnya melalui azd tool.

Gambaran umum perintah

Grup perintah azd tool mencakup subperintah berikut.

Perintah	Description
azd tool	Memulai alur interaktif yang menunjukkan alat yang terinstal dan tersedia serta meminta alat untuk diinstal dalam satu langkah.
azd tool list	Mencantumkan semua alat terdaftar, termasuk status penginstalan, versi, kategori, dan prioritas.
azd tool show <id>	Menampilkan informasi terperinci untuk alat tertentu, termasuk strategi penginstalan per platform dan situs web proyek.
azd tool check	Memeriksa alat yang terinstal untuk pembaruan yang tersedia.
azd tool install [ids...]	Menginstal satu atau beberapa alat dengan id.
azd tool upgrade [ids...]	Memutakhirkan satu atau beberapa alat yang terpasang.
azd tool uninstall [ids...]	Menghapus satu atau beberapa alat. Hilangkan ids untuk memilih alat secara interaktif. Mendukung penghapusan massal, --dry-run, dan --output json.

Semua perintah mendukung --output json untuk output yang dapat dibaca mesin dan cocok untuk skrip dan pipeline.

Untuk keterampilan alat, output JSON mencantumkan setiap keterampilan untuk setiap agen dan menyertakan agent bidang. Contohnya:

{
  "skills": [
    {
      "id": "my-skill",
      "agent": "copilot"
    }
  ]
}

Bendera umum

Bendera berikut tersedia di install dan upgrade:

• --all: Menginstal atau meningkatkan setiap alat yang memenuhi syarat. Untuk install, perintah ini mencakup semua alat yang direkomendasikan. Untuk upgrade, perintah ini mencakup semua alat terinstal yang memiliki pembaruan yang tersedia.

installPerintah , upgrade, dan uninstall mendukung --dry-run tindakan pratinjau tanpa membuat perubahan.

Opsi berikut mengendalikan perilaku prompt:

• azd dapat berjalan secara otomatis dalam mode non-interaktif saat mendeteksi lingkungan agen CI/CD atau AI.
• --no-prompt: Secara eksplisit menonaktifkan prompt interaktif.
• AZD_NON_INTERACTIVE=true: Secara eksplisit menonaktifkan prompt interaktif.
• AZD_NON_INTERACTIVE=false: Secara eksplisit tetap mengaktifkan prompting, bahkan di lingkungan CI/CD atau agen AI yang terdeteksi.
• Nilai --no-prompt dan AZD_NON_INTERACTIVE yang ditentukan secara eksplisit mengesampingkan deteksi otomatis lingkungan.

Contoh kasus penggunaan: menyiapkan mesin pengembangan

Untuk menyiapkan kumpulan lengkap alat pengembangan Azure yang direkomendasikan pada komputer baru, jalankan perintah berikut:

azd tool install --all

Perintah ini menginstal setiap alat yang ditandai sebagai recommended dalam registri dengan menggunakan manajer paket yang sesuai untuk platform saat ini. Untuk mempratinjau tindakan penginstalan tanpa membuat perubahan, tambahkan --dry-run:

azd tool install --all --dry-run

Untuk menjaga alat terinstal tetap terkini, jalankan perintah berikut:

azd tool check
azd tool upgrade --all

Mencantumkan alat yang terinstal dan tersedia

Jalankan azd tool list untuk menampilkan setiap alat terdaftar, status penginstalannya, dan versi yang diinstal:

$ azd tool list

  Id                     Name                      Category    Priority      Status          Version
  ─────────────────────  ────────────────────────  ──────────  ────────────  ──────────────  ────────
  az-cli                 Azure CLI                 cli         recommended   Installed       2.67.0
  github-copilot-cli     GitHub Copilot CLI        cli         recommended   Not Installed
  vscode-azure-tools     Azure Tools (VS Code)     extension   recommended   Installed       0.9.0
  vscode-bicep           Bicep (VS Code)           extension   recommended   Installed       0.30.0
  vscode-github-copilot  GitHub Copilot (VS Code)  extension   optional      Not Installed
  azure-mcp-server       Azure MCP Server          server      optional      Not Installed
  azd-ai-extensions      azd AI Extensions         library     optional      Not Installed

Untuk mengembalikan data yang sama dengan JSON untuk pembuatan skrip, jalankan:

azd tool list --output json

Menampilkan detail untuk alat

Jalankan azd tool show <id> untuk memeriksa alat tertentu, termasuk strategi penginstalan yang berlaku untuk setiap platform yang didukung dan situs web proyek:

azd tool show az-cli

Menginstal satu atau beberapa alat

Berikan satu atau beberapa nilai alat id untuk menginstal alat tertentu:

azd tool install az-cli vscode-bicep

Untuk menginstal setiap alat yang direkomendasikan, gunakan --all:

azd tool install --all

Untuk mempratinjau perintah penginstalan tanpa menjalankannya, tambahkan --dry-run:

azd tool install az-cli --dry-run

Menjalankan azd tool tanpa subperintah akan memulai proses interaktif yang menampilkan alat yang terinstal, memungkinkan Anda memilih alat tambahan, dan menginstalnya dalam satu langkah.

Periksa pembaruan

Jalankan azd tool check untuk memindai alat yang terinstal untuk pembaruan yang tersedia:

azd tool check

Alat peningkatan

Tingkatkan alat tertentu dengan memberikan nilai id-nya:

azd tool upgrade az-cli github-copilot-cli

Tingkatkan semua yang memiliki pembaruan yang tersedia:

azd tool upgrade --all

Pratinjau paket peningkatan tanpa menerapkannya:

azd tool upgrade --all --dry-run

Hapus instalan alat

Hapus satu atau beberapa alat dengan meneruskan nilainya id .

azd tool uninstall az-cli azure-mcp-server

Pratinjau penghapusan tanpa membuat perubahan:

azd tool uninstall vscode-bicep --dry-run

Jalankan azd tool uninstall tanpa ID alat untuk memilih alat secara interaktif. Untuk menghapus keterampilan dari agen AI tertentu, gunakan --agent.

azd tool uninstall my-skill --agent copilot

Tambahkan --output json saat Anda memerlukan hasil penghapusan dalam skrip atau alur.

Pengalaman penggunaan pertama

Untuk menemukan dan menginstal alat pengembangan Azure yang direkomendasikan, jalankan azd tool secara eksplisit. Tidak seperti versi sebelumnya, perintah alur kerja seperti azd init, , azd updan azd deploy tidak lagi memicu perintah pemeriksaan alat otomatis.

Gunakan salah satu opsi berikut untuk melewati perintah interaktif saat menjalankan azd tool perintah:

• Teruskan --no-prompt pada perintah.
• Atur variabel AZD_NON_INTERACTIVE=truelingkungan .
• Jalankan di lingkungan agen CI/CD atau AI yang terdeteksi. azd dapat secara otomatis melewati perintah interaktif.

Untuk tetap mengaktifkan prompt di lingkungan CI/CD atau agen AI yang terdeteksi, atur AZD_NON_INTERACTIVE=false. Nilai --no-prompt dan AZD_NON_INTERACTIVE yang ditentukan secara eksplisit mengesampingkan deteksi otomatis.

Skenario CI dan non-interaktif

azd tool Grup perintah mendukung alur dan skrip melalui opsi berikut:

• Gunakan argumen posisi id dengan install, upgrade, dan uninstall untuk menghindari pilihan interaktif.
• Tambahkan --no-prompt, atur AZD_NON_INTERACTIVE=true, atau mengandalkan deteksi otomatis di lingkungan agen CI/CD atau AI untuk menekan perintah.
• Atur AZD_NON_INTERACTIVE=false untuk menonaktifkan deteksi otomatis dan tetap mengaktifkan prompt di lingkungan CI/CD atau agen AI.
• Nilai --no-prompt dan AZD_NON_INTERACTIVE yang ditentukan secara eksplisit mengesampingkan deteksi otomatis.
• Gunakan --output json untuk mengambil hasil terstruktur untuk langkah-langkah hilir.

Contoh berikut menginstal Azure CLI dan ekstensi Bicep dalam langkah alur:

azd tool install az-cli vscode-bicep --no-prompt --output json

Konten terkait

• Apa itu Azure Developer CLI?
• Install atau perbarui Azure Developer CLI
• Gambaran umum perintah Azure Developer CLI
• Kelola konfigurasi CLI Pengembang Azure
• Bekerja dengan ekstensi Azure Developer CLI