azd tool ile Azure geliştirme araçlarını yönetme

Azure Geliştirici CLI'sı (azd), Azure uygulamaları oluşturmak ve göndermek için kullanılan yaygın araçların durumunu bulmak, yüklemek, yükseltmek ve denetlemek için yerleşik bir azd tool komut grubu içerir. Her platformdaki altta yatan paket yöneticilerini (örneğin winget, brew, apt, npm ve VS Code code CLI) tutarlı bir alt komut kümesinin arkasında birleştirir ve hem etkileşimli kullanım hem de otomasyonu destekler.

Yaygın kullanım örnekleri azd tool şunlardır:

  • Önerilen tüm Azure geliştirme araçlarını tek bir komutla yeni bir makineye yükleme.
  • Bir ekip veya CI aracıları kümesi genelinde geliştirme ortamını standartlaştırma.
  • Belirli bir makineye hangi Azure araçlarının (ve hangi sürümlerin) yüklendiğini denetleme.
  • Yüklü araçlar için güncelleştirmeleri denetleme ve uygulama.
  • Etkileşimli olmayan bayraklar ve JSON çıkışı kullanan işlem hatlarında betik oluşturma aracı kurulumu.

Yerleşik araçlar

Yerleşik kayıt defteri aşağıdaki araçları içerir. Belirli bir iş akışına hangi araçların uygulanacağını belirlemek için kategori ve öncelik sütunlarını kullanın.

Kimlik Name Category Priority Tipik yükleme stratejisi
az-cli Azure CLI cli Recommended winget / brew / apt
github-copilot-cli GitHub Copilot CLI cli Recommended winget / brew / npm
vscode-azure-tools Azure Araçları (VS Code) extension Recommended code CLI
vscode-bicep Bicep (VS Code) extension Recommended code CLI
vscode-github-copilot GitHub Copilot (VS Code) extension Optional code CLI
azure-mcp-server Azure MCP Sunucusu server Optional npm
azd-ai-extensions azd Yapay Zeka Uzantıları library Optional azd extension

Tam yükleme stratejisi, işletim sistemine ve makinede kullanılabilen paket yöneticilerine bağlıdır.

Uyarı

VS Code uzantıları, CLI'nın code üzerinde PATHkullanılabilir olmasını gerektirir. code kullanılamıyorsa, araçlar yüklü değil olarak görünür ve bunları azd tool aracılığıyla yükleyemezsiniz.

Komutlara genel bakış

Komut azd tool grubu aşağıdaki alt komutları içerir.

Command Description
azd tool Yüklü ve mevcut araçları gösteren etkileşimli bir akış başlatır ve tek adımda hangi araçların yükleneceğini sorar.
azd tool list Yükleme durumu, sürüm, kategori ve öncelik dahil olmak üzere tüm kayıtlı araçları listeler.
azd tool show <id> Platform başına yükleme stratejileri ve proje web sitesi de dahil olmak üzere belirli bir araç için ayrıntılı bilgileri gösterir.
azd tool check Yüklü araçları kullanılabilir güncelleştirmeler için denetler.
azd tool install [ids...] id kullanarak bir veya daha fazla araç yükler.
azd tool upgrade [ids...] Bir veya daha fazla yüklü aracı yükseltir.

Tüm komutlar, betiklerde ve işlem hatlarında kullanıma uygun --output json makine tarafından okunabilen çıktıyı destekler.

Ortak bayraklar

Aşağıdaki bayraklar install ve upgrade üzerinde kullanılabilir:

  • --all: Uygun olan her aracı yükler veya yükselter. için install, bu komut önerilen tüm araçları içerir. upgrade için bu komut, güncelleştirmesi bulunan tüm yüklü araçları içerir.
  • --dry-run: Herhangi bir değişiklik yapmadan gerçekleştireceği eylemlerin azd önizlemesini görüntüler.

Aşağıdaki seçenekler istem davranışını denetler:

  • --no-prompt: Etkileşimli istemleri gizler. Betiklerde kullanışlıdır.
  • AZD_NON_INTERACTIVE=true: ortam değişkeni ile eşdeğerdir --no-prompt.
  • AZD_SKIP_FIRST_RUN=true: İlk çalıştırma araç denetimi istemini devre dışı bırakır.

Örnek kullanım örneği: geliştirme makinesini önyükleme

Yeni bir makinede önerilen Azure geliştirme araçları kümesinin tamamını ayarlamak için aşağıdaki komutu çalıştırın:

azd tool install --all

Bu komut, geçerli platform için uygun paket yöneticisini kullanarak kayıt defterinde olarak recommended işaretlenmiş her aracı yükler. Değişiklik yapmadan yükleme eylemlerinin önizlemesini görüntülemek için ekleyin --dry-run:

azd tool install --all --dry-run

Yüklü araçları güncel tutmak için aşağıdaki komutları çalıştırın:

azd tool check
azd tool upgrade --all

Yüklü ve kullanılabilir araçları listeleme

Her kayıtlı aracı, yükleme durumunu ve yüklü sürümünü görüntülemek için komutunu çalıştırın azd tool list :

$ 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

Aynı verileri betikleme için JSON olarak döndürmek üzere şunu çalıştırın:

azd tool list --output json

Bir aracın ayrıntılarını gösterme

Desteklenen her platforma ve proje web sitesine uygulanan yükleme stratejileri de dahil olmak üzere belirli bir aracı incelemek için komutunu çalıştırın azd tool show <id> :

azd tool show az-cli

Bir veya daha fazla araç yükleme

Belirli araçları yüklemek için bir veya daha fazla araç id değeri belirtin:

azd tool install az-cli vscode-bicep

Önerilen her aracı yüklemek için kullanın --all:

azd tool install --all

Yükleme komutlarını çalıştırmadan önizlemek için ekleyin --dry-run:

azd tool install az-cli --dry-run

Alt komut olmadan çalıştırmak azd tool , yüklü araçları görüntüleyen, ek araçların seçilmesine izin veren ve bunları tek bir adımda yükleyen etkileşimli bir akış başlatır.

Güncelleştirmeleri denetleme

Kullanılabilir güncelleştirmeler için yüklü araçları taramak için komutunu çalıştırın azd tool check :

azd tool check

azd ayrıca belirli aralıklarla arka planda güncelleme denetimi yapar ve kayıtlı araçların daha yeni sürümleri kullanıma sunulduğunda rahatsız etmeyen bildirimler gösterir.

Yükseltme Araçları

Belirli araçları, id değerlerini ileterek yükseltin:

azd tool upgrade az-cli github-copilot-cli

Kullanılabilir bir güncelleştirmeyi içeren her şeyi yükseltin:

azd tool upgrade --all

Yükseltme planını uygulamadan önizleme:

azd tool upgrade --all --dry-run

İlk kullanım deneyimi

, azd initveya azd up gibi azd deploybir iş akışı komutu ilk kez çalıştırıldığında, azd tek seferlik bir araç denetimi gerçekleştirir ve önerilen araçları gözden geçirmeyi veya yüklemeyi ister.

İlk çalıştırma istemini atlamak veya devre dışı bırakmak için aşağıdaki seçeneklerden herhangi birini kullanın:

  • --no-prompt öğesini iş akışı komutuna iletin.
  • ortam değişkenini AZD_SKIP_FIRST_RUN=trueayarlayın.
  • Algılanan bir CI ortamında çalıştırın. azd, CIveya TF_BUILD ayarlandığında istemi GITHUB_ACTIONSotomatik olarak atlar.

CI ve etkileşimli olmayan senaryolar

Komut azd tool grubu, aşağıdaki seçenekler aracılığıyla işlem hatlarını ve betikleri destekler:

  • Etkileşimli seçimi önlemek için id ve install ile konumsal upgrade argümanları kullanın.
  • İstemleri bastırmak için --no-prompt ekleyin veya AZD_NON_INTERACTIVE=true ayarlayın.
  • Sonraki adımlar için yapılandırılmış sonuçları yakalamak üzere --output json kullanın.
  • İlk çalıştırma istemini ve arka plan güncelleştirme bildirimlerini bastıran CI otomatik algılamasına güvenin.

Aşağıdaki örnek, Azure CLI ve Bicep uzantısını bir işlem hattı adımına yükler:

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

İlgili içerik

  • Last updated on