Azure Geliştirici CLI uzantılarına genel bakış

Azure Geliştirici CLI (azd) uzantıları, Azure Geliştirici CLI'sinin işlevselliğini genişleten modüler bileşenlerdir. Yeni özellikler eklemenize, iş akışlarını otomatikleştirmenize ve doğrudan CLI'dan diğer hizmetlerle tümleştirmenize olanak tanır. Gelişen ekip gereksinimlerini ve Azure senaryolarını uyarlamak azd için uzantıları kullanın.

Uyarı

azd Uzantı çerçevesi genel olarak kullanılabilir. Tek tek uzantıların veya özelliklerin kendi önizleme durumları olabilir.

Uzantı kaynaklarını yönetme

Gereksinimleriniz arttıkça uzantıları bulabilir, yükleyebilir ve güncelleştirebilirsiniz. Uzantı kaynakları dağıtım ve yönetimi işler.

  • Uzantı kaynakları, kullanılabilir azd uzantıların listelerini sağlayan dosya veya URL tabanlı bildirimlerdir.
  • Özel, yerel veya genel kayıt defterlerine bağlanan özel uzantı kaynakları ekleyebilirsiniz.
  • Uzantı kaynakları NuGet veya Node Paket Yöneticisi (NPM) akışlarıyla eşdeğer bir kavramdır ve resmi uzantı kayıt defteri şemasına bağlı kalmalıdır.

azd uzantıları çözmenin çeşitli yollarını destekler:

  • Resmi uzantı kaynak kayıt defteri içinde azd önceden yapılandırılmıştır ve adresinde https://aka.ms/azd/extensions/registrybarındırılır.
  • URL tabanlı kaynaklar , ekibinizin genel veya özel dağıtım için barındırdığı uzak kayıt defteri bildirimlerine başvurur.
  • Dosya tabanlı kaynaklar , çevrimdışı kullanım veya yerel geliştirme için yerel kayıt defteri bildirimlerine başvurur.
  • Geliştirme ve gece sürümü depoları, devam eden geliştirmeler ve otomatik olarak oluşturulan birinci taraf uzantılar için isteğe bağlı kaynaklardır. Bunları üretim iş akışları yerine test senaryoları için kullanın.
  • Bağımsız paket dosyaları , kayıt defteri barındırmak istemediğinizde yerel bir dosyadan veya HTTPS URL'sinden doğrudan yükleme için taşınabilir .zip paketler sağlar.

azd özel uzantı kaynak adları için katı doğrulama uygular. Adlar 1 ile 64 arasında küçük harf veya rakam içermelidir. Harfler veya basamaklar arasına kısa çizgi (-) ve alt çizgi (_) ekleyebilirsiniz. Adlar bir harf veya rakamla başlayıp bitmelidir. azd geçersiz adlar için bir hata döndürür; onları normalleştirmez. bundle ve azd adları ayrılmıştır ve özel kaynaklar için kullanılamaz. Kaynak adı, --source ile kullandığınızda geçerli olmalıdır.

Önceden yapılandırılmış azd kaynak, resmi kayıt defteridir. Kaldıramaz veya konumunu değiştiremezsiniz.

Geliştirme kayıt defterini kabul etmek için aşağıdaki komutu çalıştırın:

# Add a new extension source name 'dev' to your `azd` configuration.
azd extension source add -n dev -t url -l "https://aka.ms/azd/extensions/registry/dev"

Dikkat

Geliştirme kayıt defterinde barındırılan uzantılar imzalanmamıştır, Azure desteği kapsamında değildir ve bildirimde bulunmaksızın değiştirilebilir veya kaldırılabilir.

Uzantı kaynağı komutları

Yüklemenizin uzantı kaynaklarını yönetmek için azd aşağıdaki komutları kullanın.

Yüklü uzantı kaynaklarını listeleme

azd extension source list

Yeni uzantı kaynağı ekleme

azd extension source add -n <name> -t url -l <registry-url>
  • -l, --location: Uzantı kaynağının konumu.
  • -n, --name: Uzantı kaynağının adı. Geçerli bir özel kaynak adı kullanın.
  • -t, --type: Uzantı kaynağının türü. Desteklenen türler dosya ve URL'dir.

Uzantı kaynağını kaldırma

azd extension source remove <name>

Önceden yapılandırılmış azd kaynağı kaldıramazsınız.

Bir güncelleştirme, ~/.azd/config.json içindeki eski bir geçersiz kaynak adından kaynaklanan bir kaynak yükleme hatası bildirirse, sorunlu kaynağı azd extension source remove ile kaldırın, ardından geçerli bir adla yeniden ekleyin.

Uzantıları yönetme

Uzantıları etkinleştirip uzantı kaynaklarınızı yapılandırdıktan sonra, azd öğesine yeni özellikler eklemek için uzantıları yükleyin. Uzantılarla çalışma örneği için bkz. Hızlı Başlangıç - yapay zeka uzantısını kullanma.

Liste uzantıları

azd extension list [flags]
  • --installed Yüklü uzantıların listesini görüntüler.
  • --source Yalnızca belirtilen kaynaktan uzantıları listeler. Kaynak adı geçerli bir kayıtlı kaynak adı olmalıdır.
  • --tags Uzantıları yapay zeka veya test gibi etiketlere göre filtreler.

Uzantı yükleme

azd extension install <extension-names> [flags]

yerine <extension-name> yüklemek istediğiniz uzantının adını yazın.

  • -v, --version Yüklenecek tam sürümü belirtir. Bu seçenek sürüm aralıklarını veya kısıtlamalarını kabul etmez ve bağımsız paket (.zip dosya yolu veya URL) yüklerken kullanılamaz.
  • -s, --source Yüklemeler için kullanılan uzantı kaynağını belirtir. Kaynak adı geçerli bir kayıtlı kaynak adı olmalıdır.

HTTPS URL'sinden bağımsız bir paket yüklemek için uzantı adı olarak paket konumunu belirtin:

azd extension install https://example.com/extensions/example.zip
  • --all Belirtildiğinde daha önce yüklenmiş olan tüm uzantıları yükselter.
  • -v, --version Sağlanan belirli bir uzantıyı tam sürüme yükselter. Bu seçenek sürüm aralıklarını veya kısıtlamalarını kabul etmez.
  • -s, --source Yüklemeler için kullanılan uzantı kaynağını belirtir. Kaynak adı geçerli bir kayıtlı kaynak adı olmalıdır.
  • --no-dependency-updates Belirtildiğinde bağımlılık güncelleştirmelerini engeller.

Uzantıyı kaldırma

azd extension uninstall <extension-name>
  • --all Belirtildiğinde tüm yüklü uzantıları kaldırır.

Projede gerekli uzantıları bildirme

Projeler içinde azure.yaml gerekli uzantıları bildirebilir, bu nedenle azd projenin ihtiyaç duyduğu uzantı sürümlerini çözümleyebilir ve yükleyebilir. requiredVersions.extensions altına uzantı gereksinimlerini ekleyin ve latest, tam sürüm ya da desteklenen bir semantik sürüm kısıtlaması kullanın.

requiredVersions:
  extensions:
    azure.ai.agents: "latest"
    contoso.azd.tagger: "^2.0.0"

Bir şablon uzantı tarafından sağlanan hizmet konaklarına, yaşam döngüsü işleyicilerine, doğrulama sağlayıcılarına veya komutlara bağlı olduğunda proje düzeyi gereksinimlerini kullanın. Şema ve sürüm kısıtlaması ayrıntılarının tamamı için bkz requiredVersions. .

Uzantı tümleştirme noktalarını anlama

Uzantılar, azd ile çeşitli şekillerde tümleşebilir:

  • Meta veriler, yardım ve örneklerle komut ad alanları ekleyin.
  • Proje dosyaları için yapılandırma şemaları ve IntelliSense meta verileri sağlayın.
  • Sağlama, paketleme ve dağıtma gibi iş akışları için yaşam döngüsü olay işleyicilerini kaydedin.
  • Özel sağlama, doğrulama, hizmet hedefleri ve dil veya çerçeve desteği için sağlayıcılar ekleyin.
  • Aracılar ve geliştirici araçları için Model Bağlam Protokolü (MCP) sunucu özelliklerini kullanıma sunma.

Uygulama yönergeleri için bkz . Uzantı geliştirme kavramları.

Geliştirme kapsayıcılarında azd uzantılarını kullanın

Geliştirme Kapsayıcısı azd Özelliği, kapsayıcı derlemesi sırasında uzantıların extensions virgülle ayrılmış listesini otomatik olarak yükleme seçeneğini desteklerazd. Kapsayıcı başlar başlamaz bu şekilde yüklenen uzantılar kullanılabilir. Bu sayede manuel kurulum azaltılır ve azd komutlarının, gerekli uzantılar önceden yüklenmiş olarak çalıştırılması sağlanır.

Uzantıları otomatik olarak yüklemek için dosyanızdaki extensions özellik girişine azd seçeneğini ekleyindevcontainer.json:

{
    "name": "Azure Developer CLI",
    "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
    "features": {
        "ghcr.io/azure/azure-dev/azd:latest": {
            "extensions": "my-ext-1,my-ext-2"
        }
    }
}

extensions Değer, uzantı adlarının azd virgülle ayrılmış bir listesidir. Yükleme, kapsayıcı oluşturma sırasında gerçekleşir, bu nedenle kapsayıcı başlatıldığında uzantılar hemen kullanıma hazır olur. Uzantı listesini değiştirdikten sonra Visual Studio Code'da Geliştirme Kapsayıcısında Yeniden Oluştur ve Yeniden Aç komutunu kullanarak kapsayıcıyı güncelleştirilmiş uzantılarla yeniden oluşturun.

azd Dev Container Özelliği hakkında daha fazla bilgi edinin.

Sonraki Adımlar

  • Last updated on