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 --cask 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 Rebuild en Reopen 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

U kunt bijwerken azd met behulp van de ingebouwde azd update opdracht (bèta) of handmatig met dezelfde methode die u hebt gebruikt om deze te installeren.

Gebruik azd update (bèta)

Met het azd update-commando wordt gedetecteerd hoe azd oorspronkelijk is geïnstalleerd en wordt automatisch gedelegeerd naar de juiste updatemethode.

Installatiemethode Wat azd update doet?
winget Wordt uitgevoerd winget upgrade Microsoft.Azd
choco Loopt choco upgrade azd
Script of MSI installeren (Windows) Wordt uitgevoerd install-azd.ps1 met automatische back-up en herstel
Script installeren (Linux/macOS) Loopt install-azd.sh
Homebrew Loopt brew upgrade --cask azure/azd/azd
.deb / .rpm Pakket Het binaire bestand rechtstreeks downloaden en vervangen

Voer de volgende opdracht uit om bij te werken naar de nieuwste stabiele versie:

azd update

Opmerking

De azd update opdracht bevindt zich momenteel in de bètaversie. Lees meer over ondersteuning voor alfa- en bètafuncties op de pagina met functieversiebeheer en releasestrategie .

Updatekanalen overschakelen

azd ondersteunt twee updatekanalen: stable (standaard) en daily. Kanaal omschakeling wordt ondersteund voor script-gebaseerde installaties en Homebrew. Als u azd installeerde via winget of choco, dan zijn dagelijkse builds niet beschikbaar via deze pakketbeheerders. azd update geeft eerst richtlijnen weer over het eerst opnieuw installeren via script.

Ga als volgende te werk om over te schakelen naar het daily kanaal en bij te werken:

azd update --channel daily

Ga terug naar het stable kanaal:

azd update --channel stable

Wanneer u van kanaal wisselt, azd wordt u om bevestiging gevraagd voordat u doorgaat.

Uw pakketbeheer gebruiken of script installeren

U kunt ook op elk gewenst moment handmatig bijwerken met behulp van hetzelfde pakketbeheer of scriptopdrachten installeren die worden weergegeven in de bovenstaande installatiesecties. Wanneer azd deze verouderd is, wordt er een waarschuwingsbericht weergegeven met de toepasselijke updateopdracht voor uw installatiemethode.

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

Quickstart: een azd-sjabloon selecteren en implementeren

Wat zijn Azure Cli-sjablonen voor ontwikkelaars?

veelgestelde vragen over Azure Developer CLI

  • Last updated on