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 GitHub Copilot CLI 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 (VS Code) extension Optional code CLI
azure-mcp-server Azure MCP Server 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.

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

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.
  • --dry-run: Pratinjau tindakan azd akan dilakukan tanpa membuat perubahan apa pun.

Opsi berikut mengendalikan perilaku prompt:

  • --no-prompt: Menonaktifkan prompt interaktif. Berguna dalam skrip.
  • AZD_NON_INTERACTIVE=true: Variabel lingkungan yang setara dengan --no-prompt.
  • AZD_SKIP_FIRST_RUN=true: Menonaktifkan permintaan pemeriksaan alat saat pertama kali dijalankan.

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

azd juga menjalankan pemeriksaan pembaruan latar belakang berkala dan menampilkan pemberitahuan yang tidak mengganggu saat versi alat terdaftar yang lebih baru tersedia.

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

Pengalaman penggunaan pertama

Pertama kali perintah alur kerja seperti azd init, , azd upatau azd deploy berjalan, azd melakukan pemeriksaan alat satu kali dan meminta untuk meninjau atau menginstal alat yang direkomendasikan.

Gunakan salah satu opsi berikut untuk melewati atau menonaktifkan perintah eksekusi pertama:

  • Teruskan --no-prompt ke perintah alur kerja.
  • Atur variabel AZD_SKIP_FIRST_RUN=truelingkungan .
  • Jalankan di lingkungan CI yang terdeteksi. azd secara otomatis melewati perintah ketika CI, , TF_BUILDatau GITHUB_ACTIONS diatur.

Skenario CI dan non-interaktif

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

  • Gunakan argumen posisi id dengan install dan upgrade untuk menghindari pilihan interaktif.
  • Tambahkan --no-prompt atau atur AZD_NON_INTERACTIVE=true untuk menekan perintah.
  • Gunakan --output json untuk mengambil hasil terstruktur untuk langkah-langkah hilir.
  • Andalkan deteksi otomatis CI, yang menonaktifkan prompt saat pertama kali dijalankan dan notifikasi pembaruan di latar belakang.

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

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

Konten terkait

  • Last updated on