Overzicht van Azure Developer CLI-extensies

Azure Developer CLI-extensies (azd) zijn modulaire onderdelen die de functionaliteit van de Azure Developer CLI uitbreiden. Hiermee kunt u nieuwe mogelijkheden toevoegen, werkstromen automatiseren en rechtstreeks vanuit de CLI integreren met andere services. Gebruik extensies om aan te passen azd aan veranderende teambehoeften en Azure scenario's.

Opmerking

Het azd extensieframework is algemeen beschikbaar. Afzonderlijke extensies of mogelijkheden hebben mogelijk hun eigen preview-status.

Extensiebronnen beheren

U kunt extensies detecteren, installeren en bijwerken naarmate uw vereisten toenemen. Bronnen voor extensies regelen distributie en beheer.

  • Extensiebronnen zijn manifesten op basis van bestanden of URL's die lijsten met beschikbare azd extensies bieden.
  • U kunt aangepaste extensiebronnen toevoegen die verbinding maken met privé-, lokale of openbare registers.
  • Extensiebronnen zijn een equivalent concept voor NuGet- of Node Pakketbeheer-feeds (NPM) en moeten voldoen aan het officiële schema van het extensieregister.

azd ondersteunt verschillende manieren om extensies op te lossen:

  • Het officiële extensiebronregister is vooraf geconfigureerd azd en wordt gehost op https://aka.ms/azd/extensions/registry.
  • Bronnen op basis van URL's verwijzen naar externe registermanifesten die uw team host voor openbare of privédistributie.
  • Bronnen op basis van bestanden verwijzen naar lokale registermanifesten voor offlinegebruik of lokale ontwikkeling.
  • De ontwikkelings - en nachtregisters zijn opt-in bronnen voor werk in uitvoering en automatisch ingebouwde extensies van eerste partijen. Gebruik ze voor testscenario's in plaats van productiewerkstromen.
  • Zelfstandige bundelbestanden bieden draagbare .zip pakketten voor directe installatie wanneer u geen register wilt hosten.

Aangepaste extensiebronnamen moeten 1 tot 64 kleine ASCII-letters of cijfers bevatten. U kunt afbreekstreepjes () en onderstrepingstekens (-_) tussen letters of cijfers opnemen. Namen moeten beginnen en eindigen met een letter of cijfer. azd retourneert een fout voor ongeldige namen; Het normaliseert ze niet. De namen azd en zijn gereserveerd en bundle kunnen niet worden gebruikt voor aangepaste bronnen.

De vooraf geconfigureerde azd bron is het officiële register. U kunt deze niet verwijderen of de locatie ervan wijzigen.

Als u zich wilt aanmelden voor het ontwikkelingsregister, voert u de volgende opdracht uit:

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

Waarschuwing

Extensies die worden gehost in het ontwikkelaarsregister, zijn niet ondertekend, niet gedekt door ondersteuning voor Azure en kunnen zonder kennisgeving worden gewijzigd of verwijderd.

Opdrachten voor extensiebron

Gebruik de volgende opdrachten om extensiebronnen voor uw azd installatie te beheren.

Geïnstalleerde extensiebronnen weergeven

azd extension source list

Een nieuwe extensiebron toevoegen

azd extension source add -n <name> -t url -l <registry-url>
  • -l, --location: De locatie van de extensiebron.
  • -n, --name: De naam van de extensiebron. Gebruik een geldige aangepaste bronnaam.
  • -t, --type: Het type extensie-bron. Ondersteunde typen zijn bestanden en URL's.

Een extensiebron verwijderen

azd extension source remove <name>

U kunt de vooraf geconfigureerde azd bron niet verwijderen.

Als een upgrade een fout bij het laden van een bron rapporteert die wordt veroorzaakt door een verouderde ongeldige bronnaam, ~/.azd/config.jsonverwijdert u de offending-bron met azd extension source removeen voegt u deze opnieuw toe met een geldige naam.

Extensies beheren

Nadat u extensies hebt ingeschakeld en uw extensiebronnen hebt geconfigureerd, installeert u extensies om nieuwe mogelijkheden toe te voegen aan azd. Zie Quickstart voor een voorbeeld van het werken met extensies : gebruik de AI-extensie.

Extensies van lijsten

azd extension list [flags]
  • --installed Geeft een lijst met geïnstalleerde extensies weer.
  • --source Alleen een lijst met extensies van de opgegeven bron. De bronnaam moet een geldige geregistreerde bronnaam zijn.
  • --tags Filtert extensies op tags, zoals AI of testen.

Een extensie installeren

azd extension install <extension-names> [flags]

Vervang <extension-name> door de naam van de extensie die u wilt installeren.

  • -v, --version Hiermee geeft u de versiebeperking op die moet worden toegepast bij het installeren van extensies.
  • -s, --source Hiermee geeft u de bron van de extensie die wordt gebruikt voor installaties. De bronnaam moet een geldige geregistreerde bronnaam zijn.

Een extensie upgraden

azd extension upgrade <extension-name>
  • --all Alle eerder geïnstalleerde extensies worden geüpgraded wanneer dat is gespecificeerd.
  • -v, --version Hiermee wordt een opgegeven extensie bijgewerkt met behulp van een versiebeperking, indien opgegeven.
  • -s, --source Hiermee geeft u de bron van de extensie die wordt gebruikt voor installaties. De bronnaam moet een geldige geregistreerde bronnaam zijn.

Een extensie verwijderen

azd extension uninstall <extension-name>
  • --all Verwijdert alle geïnstalleerde extensies wanneer deze zijn opgegeven.

Vereiste extensies in een project declareren

Projecten kunnen vereiste extensies declareren, azure.yaml zodat azd u de uitbreidingsversies kunt oplossen en installeren die het project nodig heeft. Voeg uitbreidingsvereisten toe onder requiredVersions.extensions, en gebruik latest, een exacte versie of een ondersteunde semantische versiebeperking.

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

Gebruik vereisten op projectniveau wanneer een sjabloon afhankelijk is van door extensies geleverde servicehosts, levenscyclushandlers, validatieproviders of opdrachten. Zie voor de volledige details requiredVersionsvan schema- en versiebeperkingen.

Meer informatie over uitbreidingsintegratiepunten

Extensies kunnen op verschillende manieren worden geïntegreerd azd :

  • Voeg opdrachtnaamruimten toe met metagegevens, help en voorbeelden.
  • Geef configuratieschema's en IntelliSense-metagegevens voor projectbestanden op.
  • Registreer gebeurtenis-handlers voor levenscyclus voor werkstromen zoals inrichten, verpakken en implementeren.
  • Providers toevoegen voor aangepaste inrichting, validatie, servicedoelen en ondersteuning voor taal of framework.
  • Maak de MCP-servermogelijkheden (Model Context Protocol) beschikbaar voor agents en ontwikkelhulpprogramma's.

Zie De concepten voor uitbreidingsontwikkeling voor implementaties.

Azd-extensies gebruiken in dev-containers

De azd functie Dev Container ondersteunt een extensions optie voor het automatisch installeren van azd een door komma's gescheiden lijst met extensies tijdens de containerbuild. Extensies die op deze manier zijn geïnstalleerd, zijn beschikbaar zodra de container wordt gestart, waardoor handmatige installatie wordt verminderd en opdrachten kunnen azd worden uitgevoerd met de vereiste extensies die al zijn geïnstalleerd.

Als u extensies automatisch wilt installeren, voegt u de optie toe aan de extensionsazd functievermelding in uw devcontainer.json bestand:

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

De extensions waarde is een door komma's gescheiden lijst met azd extensienamen. De installatie vindt plaats tijdens de containerbuild, zodat de extensies klaar zijn voor gebruik zodra de container wordt gestart. Nadat u de lijst met extensies hebt gewijzigd, gebruikt u de opdracht Opnieuw opbouwen en opnieuw openen in Dev Container in Visual Studio Code om de container opnieuw te bouwen met de bijgewerkte extensies.

Meer informatie over de azd Dev Container Feature.

Volgende stappen

  • Last updated on