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.

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 ontwikkelingsregisters en nightly-registers zijn opt-inbronnen voor werk in uitvoering en automatisch gebouwde eigen extensies. Gebruik ze voor testscenario's in plaats van productiewerkstromen.
• Zelfstandige bundelbestanden bieden draagbare .zip pakketten voor directe installatie vanuit een lokaal bestand of een HTTPS-URL wanneer u geen register wilt hosten.

azd dwingt strikte validatie af voor aangepaste extensiebronnamen. Namen moeten 1 tot 64 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 bundle zijn gereserveerd en kunnen niet worden gebruikt voor aangepaste bronnen. De bronnaam moet geldig zijn wanneer u deze gebruikt met --source.

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"

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 update een fout bij het laden van een bron meldt die wordt veroorzaakt door een verouderde, ongeldige bronnaam in ~/.azd/config.json, verwijder dan de betreffende bron met azd extension source remove en voeg deze vervolgens 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 exacte versie die moet worden geïnstalleerd. Deze optie accepteert geen versiebereiken of beperkingen en kan niet worden gebruikt bij het installeren van een zelfstandige bundel (.zip bestandspad of URL).
• -s, --source Hiermee geeft u de bron van de extensie die wordt gebruikt voor installaties. De bronnaam moet een geldige geregistreerde bronnaam zijn.

Als u een zelfstandige bundel wilt installeren vanuit een HTTPS-URL, geeft u de bundellocatie op als de extensienaam:

azd extension install https://example.com/extensions/example.zip

• --all Alle eerder geïnstalleerde extensies worden geüpgraded wanneer dat is gespecificeerd.
• -v, --version Hiermee wordt een opgegeven extensie bijgewerkt naar de exacte versie, indien opgegeven. Deze optie accepteert geen versiebereiken of beperkingen.
• -s, --source Hiermee geeft u de bron van de extensie die wordt gebruikt voor installaties. De bronnaam moet een geldige geregistreerde bronnaam zijn.
• --no-dependency-updates Voorkomt updates van afhankelijkheden wanneer opgegeven.

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 opgeven in azure.yaml zodat azd de versies van de extensies die het project nodig heeft kan bepalen en installeren. 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 requiredVersions voor het volledige schema en details over versiebeperkingen.

Meer informatie over uitbreidingsintegratiepunten

Extensies kunnen op verschillende manieren worden geïntegreerd met azd:

• Voeg opdrachtnaamruimten toe met metagegevens, help en voorbeelden.
• Geef configuratieschema's en IntelliSense-metagegevens voor projectbestanden op.
• Registreer handlers voor levenscyclusgebeurtenissen voor workflows 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.

Raadpleeg concepten voor uitbreidingsontwikkeling voor richtlijnen voor de implementatie.

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

• Quickstart: De AI-extensie gebruiken
• Concepten voor uitbreidingsontwikkeling
• Quickstart: Een azd-voorbeeldextensie bouwen
• Leesmij van extensie-framework