Přehled rozšíření Azure Developer CLI

Rozšíření Azure Developer CLI (azd) jsou modulární komponenty, které rozšiřují funkce Azure Developer CLI. Umožňují přidávat nové funkce, automatizovat pracovní postupy a integrovat je s dalšími službami přímo z rozhraní příkazového řádku. Pomocí rozšíření můžete přizpůsobit azd měnícím se potřebám týmu a Azure scénářům.

Poznámka:

Rámec rozšíření azd je všeobecně dostupný. Jednotlivá rozšíření nebo možnosti můžou mít svůj vlastní stav Preview.

Správa zdrojů rozšíření

S rostoucími požadavky můžete zjišťovat, instalovat a aktualizovat rozšíření. Zdroje rozšíření zpracovávají distribuci a správu.

  • Zdroje přípon jsou manifesty založené na souborech nebo adresách URL, které poskytují seznamy dostupných azd rozšíření.
  • Můžete přidat vlastní zdroje rozšíření, které se připojují k privátním, místním nebo veřejným registrům.
  • Zdroje rozšíření jsou ekvivalentním konceptem ke zdrojům NuGet nebo Node Správce balíčků (NPM) a musí dodržovat oficiální schéma registru rozšíření.

azd podporuje několik způsobů řešení rozšíření:

  • Oficiální zdrojový registr rozšíření je předem nakonfigurovaný a je hostován azd na https://aka.ms/azd/extensions/registryadrese .
  • Zdroje založené na adrese URL odkazují na vzdálené manifesty registru, které váš tým hostuje pro veřejnou nebo privátní distribuci.
  • Zdroje založené na souborech odkazují na manifesty místního registru pro offline použití nebo místní vývoj.
  • Vývoj a noční registry jsou zdroje výslovného souhlasu pro probíhající práci a automaticky sestavená rozšíření první strany. Používejte je pro testovací scénáře místo produkčních pracovních postupů.
  • Soubory balíčku s vlastním obsahem poskytují přenosné .zip balíčky pro přímou instalaci z místního souboru nebo adresy URL HTTPS, pokud nechcete hostovat registr.

azd vynucuje přísnou validaci názvů vlastních zdrojů rozšíření. Názvy musí obsahovat 1 až 64 malých písmen ASCII nebo číslic. Mezi písmena nebo číslice můžete zahrnout pomlčky (-) a podtržítka (_). Názvy musí začínat a končit písmenem nebo číslicí. azd vrátí chybu pro neplatné názvy; nenormalizuje je. Názvy azd a bundle jsou vyhrazené a nelze je použít pro vlastní zdroje. Název zdroje musí být platný, pokud ho použijete s --source.

Předkonfigurovaný azd zdroj je oficiální registr. Nemůžete ho odebrat ani změnit jeho umístění.

Pokud se chcete přihlásit k vývojovému registru, spusťte následující příkaz:

# 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"

Upozornění

Rozšíření hostovaná v registru pro vývoj jsou nepodepsaná, nejsou pokryta podpora Azure a je možné je bez předchozího upozornění změnit nebo odebrat.

Příkazy zdroje rozšíření

Ke správě zdrojů rozšíření pro instalaci azd použijte následující příkazy.

Výpis nainstalovaných zdrojů rozšíření

azd extension source list

Přidání nového zdroje rozšíření

azd extension source add -n <name> -t url -l <registry-url>
  • -l, --location: Umístění zdroje rozšíření.
  • -n, --name: Název zdroje rozšíření. Použijte platný vlastní název zdroje.
  • -t, --type: Typ zdroje rozšíření. Podporované typy jsou soubor a adresa URL.

Odebrání zdroje rozšíření

azd extension source remove <name>

Předkonfigurovaný azd zdroj nejde odebrat.

Pokud aktualizace hlásí chybu načtení zdroje způsobenou zastaralým neplatným názvem zdroje v ~/.azd/config.json, odeberte problematický zdroj pomocí azd extension source remove a pak ho znovu přidejte s platným názvem.

Správa rozšíření

Jakmile povolíte rozšíření a nakonfigurujete zdroje rozšíření, nainstalujte rozšíření, která přidají nové funkce do azd. Příklad práce s rozšířeními najdete v tématu Rychlý start – použití rozšíření AI.

Seznam rozšíření

azd extension list [flags]
  • --installed Zobrazí seznam nainstalovaných rozšíření.
  • --source Zobrazí pouze seznam rozšíření ze zadaného zdroje. Název zdroje musí být platný registrovaný název zdroje.
  • --tags Filtruje rozšíření podle značek, jako je AI nebo test.

Instalace rozšíření

azd extension install <extension-names> [flags]

Nahraďte <extension-name> názvem rozšíření, které chcete nainstalovat.

  • -v, --version Určuje přesnou verzi, která se má nainstalovat. Tato možnost nepřijímá rozsahy verzí ani omezení a nelze ji použít při instalaci samostatné sady (.zip cesta k souboru nebo adresa URL).
  • -s, --source Určuje zdroj rozšíření používaný pro instalace. Název zdroje musí být platný registrovaný název zdroje.

Pokud chcete nainstalovat samostatnou sadu z adresy URL HTTPS, zadejte umístění sady jako název rozšíření:

azd extension install https://example.com/extensions/example.zip
  • --all Upgraduje všechna dříve nainstalovaná rozšíření po zadání.
  • -v, --version Pokud je k dispozici, upgraduje zadané rozšíření na přesnou verzi. Tato možnost nepřijímá rozsahy verzí ani omezení.
  • -s, --source Určuje zdroj rozšíření používaný pro instalace. Název zdroje musí být platný registrovaný název zdroje.
  • --no-dependency-updates Zabrání aktualizacím závislostí při zadání.

Odinstalace rozšíření

azd extension uninstall <extension-name>
  • --all Odebere všechna nainstalovaná rozšíření po zadání.

Deklarace požadovaných rozšíření v projektu

Projekty mohou v azure.yaml deklarovat požadovaná rozšíření, aby azd mohlo určit a nainstalovat verze rozšíření, které projekt potřebuje. Přidejte požadavky na rozšíření pod položku requiredVersions.extensions, a použijte latest, konkrétní verzi nebo podporované omezení sémantického verzování.

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

Použijte požadavky na úrovni projektu, když šablona závisí na hostitelských službách, obslužných rutinách pro životní cyklus, poskytovatelích validace nebo příkazech poskytovaných rozšířením. Úplné podrobnosti o schématu a omezeních verze naleznete v requiredVersions.

Vysvětlení bodů integrace rozšíření

Rozšíření se mohou integrovat s azd několika způsoby:

  • Přidejte obory názvů příkazů s metadaty, nápovědou a příklady.
  • Zadejte schémata konfigurace a metadata IntelliSense pro soubory projektu.
  • Zaregistrujte obslužné rutiny událostí v životním cyklu pro pracovní postupy, jako je zřizování, vytvoření balíčku a nasazení.
  • Přidejte zprostředkovatele pro vlastní zřizování, ověřování, cíle služeb a podporu jazyka nebo architektury.
  • Zpřístupnění funkcí serveru MCP (Model Context Protocol) pro agenty a vývojářské nástroje

Pokyny k implementaci najdete v tématu Koncepty vývoje rozšíření.

Použití rozšíření azd v vývojových kontejnerech

azd Funkce vývojového kontejneru podporuje extensions možnost automatické instalace seznamu rozšíření oddělených azd čárkami během sestavení kontejneru. Rozšíření nainstalovaná tímto způsobem jsou dostupná hned po spuštění kontejneru, což snižuje ruční instalaci a umožňuje azd spouštění příkazů s již nainstalovanými požadovanými rozšířeními.

Pokud chcete rozšíření automaticky nainstalovat, přidejte extensions do azd položky funkce v devcontainer.json souboru možnost:

{
    "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"
        }
    }
}

Hodnota extensions je čárkami oddělený seznam azd názvů přípon. Instalace probíhá během sestavení kontejneru, takže rozšíření jsou připravená k použití hned po spuštění kontejneru. Po změně seznamu rozšíření použijte příkaz Znovu sestavit a znovu otevřít ve vývojovém kontejneru v aplikaci Visual Studio Code k znovu sestavení kontejneru s aktualizovanými rozšířeními.

Přečtěte si další informace o funkci vývojového kontejneru azd.

Další kroky

  • Last updated on