Delen via


De Azure Developer CLI installeren of bijwerken

Welkom bij de Azure Developer CLI (azd)! Laten we aan de slag gaan met het installeren en leren uitvoeren azd.

Selecteer eerst uw ontwikkelomgeving. Zie Azure Developer CLI (azd) ondersteunde omgevingen voor meer informatie over de voor- en nadelen van de verschillende ontwikkelomgevingen.

Zie Azure Developer CLI Installer Scripts voor meer geavanceerde installatiescenario's en instructies.

Opmerking: Wanneer u azd installeert, worden de volgende tools geïnstalleerd binnen het azd bereik (wat betekent dat ze niet wereldwijd worden geïnstalleerd) en worden ze verwijderd als azd wordt verwijderd.

azd installeren

winget install microsoft.azd

azd bijwerken

winget upgrade microsoft.azd

Verwijderen azd

winget uninstall microsoft.azd

Opmerking

Voor Apple Silicon Macs (M1 en M2) azd is Rosetta 2 vereist. Als Rosetta 2 nog niet is geïnstalleerd, voer dan softwareupdate --install-rosetta uit in de terminal.

Het azd installatieproces kiest automatisch het juiste binaire bestand voor de architectuur van uw computer.

azd installeren

brew install azure/azd/azd

Als u brew gebruikt om azd te upgraden van een versie die niet is geïnstalleerd met behulp van brew, verwijdert u de bestaande versie van azd met het uninstall-script (indien geïnstalleerd op de standaardlocatie) of door het azd binaire bestand handmatig te verwijderen. Hiermee wordt automatisch de juiste versie geïnstalleerd.

azd bijwerken

brew upgrade azure/azd/azd

Verwijderen azd

brew uninstall azd

azd installeren

curl -fsSL https://aka.ms/install-azd.sh | bash

azd bijwerken

curl -fsSL https://aka.ms/install-azd.sh | bash

Wanneer u azd installeert, worden de volgende hulpprogramma's binnen de azd-scope geïnstalleerd (dat wil zeggen dat ze niet wereldwijd worden geïnstalleerd) en worden ze verwijderd als azd wordt gedeïnstalleerd:

Verwijderen azd

curl -fsSL https://aka.ms/uninstall-azd.sh | bash

Vereiste voorwaarden

Voordat u azd gaat gebruiken, zorg ervoor dat u het volgende heeft:

Installeren azd in een dev-container

Een dev-container is een Docker-image met alle benodigdheden die je nodig hebt om een app te draaien op je lokale machine. Installeer azd als een functie in uw dev-container via de volgende stappen:

  1. Voeg de azd functie toe aan het devcontainer.json bestand in de .devcontainer map in de hoofdmap van uw sjabloon.

    {
        "name": "Azure Developer CLI",
        "image": "mcr.microsoft.com/devcontainers/python:3.10-bullseye",
        "features": {
            // See https://containers.dev/features for list of features
            "ghcr.io/devcontainers/features/docker-in-docker:2": {
            },
            "ghcr.io/azure/azure-dev/azd:latest": {}
        }
        // Rest of file omitted...
    } 
    
  2. Bouw uw dev-container opnieuw en voer deze uit. Gebruik in Visual Studio Code het opdrachtpalet om de opdracht Rebuild and Reopen in Dev Container uit te voeren.

Azd-extensies automatisch installeren

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.

Uw installatie controleren

Controleer of de azd installatie is voltooid door de azd version opdracht uit te voeren in een terminal:

azd version

azd de huidige versie afdrukken:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

De Azure Developer CLI bijwerken

Wanneer u werkt met een verouderde versie van azd, ziet u een waarschuwing om een upgrade uit te voeren naar de nieuwste versie. Volg de instructies in de waarschuwing om bij te werken naar de nieuwste versie.

Hulp aanvragen

Ga naar de pagina roubleshooting en ondersteuning voor informatie over het indienen van een bug, hulp vragen of een nieuwe functie voorstellen voor de Azure Developer CLI.

Volgende stappen

veelgestelde vragen over Azure Developer CLI