Installera eller uppdatera CLI för Azure Developer

Välkommen till AZURE Developer CLI (azd)! Nu ska vi komma igång med att installera och lära oss hur du kör azd.

Börja med att välja din utvecklingsmiljö. Mer information om för- och nackdelar med olika val av utvecklingsmiljöer finns i Azure Developer CLI (azd)-stödda miljöer.

Mer avancerade installationsscenarier och instruktioner finns i Azure Cli Installer-skript för utvecklare.

Obs! När du installerar azdinstalleras följande verktyg inom azd omfånget (vilket innebär att de inte installeras globalt) och tas bort om azd avinstalleras:

Installera azd

winget install microsoft.azd

Uppdatera azd

winget upgrade microsoft.azd

Avinstallera azd

winget uninstall microsoft.azd

Anmärkning

På Apple Silicon Macs (M1 och M2) azd kräver Rosetta 2. Om Rosetta 2 inte redan är installerat kör du softwareupdate --install-rosetta från terminalen.

Installationsprocessen azd väljer automatiskt rätt binärfil för datorns arkitektur.

Installera azd

brew install azure/azd/azd

Om du använder brew för att uppgradera azd från en version som inte har installerats med brew, ta bort den befintliga versionen av azd med avinstallationsskriptet (om det är installerat på standardplatsen) eller genom att ta bort binärfilen azd manuellt. Detta installerar automatiskt rätt version.

Uppdatera azd

brew upgrade --cask azure/azd/azd

Avinstallera azd

brew uninstall azd

Installera azd

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

Uppdatera azd

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

När du installerar azdinstalleras följande verktyg inom azd omfånget (vilket innebär att de inte installeras globalt) och tas bort om azd avinstalleras:

Avinstallera azd

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

Förutsättningar

Innan du börjar använda azdkontrollerar du att du har:

Installera azd i en utvecklingscontainer

En utvecklingscontainer är en Docker-avbildning som innehåller alla förutsättningar som du behöver för att köra en app på den lokala datorn. Installera azd som en funktion i din utvecklingscontainer via följande steg:

  1. Lägg till funktionen azd i filen devcontainer.json i mappen .devcontainer i rotkatalogen av din mall.

    {
        "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. Återskapa och kör din utvecklingscontainer. I Visual Studio Code använder du kommandopalett för att köra kommandot Rebuild och Reopen in Dev Container.

Installera azd-tillägg automatiskt

Dev azd Container-funktionen stöder ett extensions alternativ för att automatiskt installera en kommaavgränsad lista över azd tillägg under containerversionen. Tillägg som är installerade på det här sättet är tillgängliga så snart containern startar, vilket minskar den manuella installationen och gör det möjligt azd för kommandon att köras med nödvändiga tillägg som redan är installerade.

Om du vill installera tillägg automatiskt lägger du till extensions alternativet i funktionsposten azd i devcontainer.json filen:

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

Värdet extensions är en kommaavgränsad lista med tilläggsnamn azd . Installationen sker under containerbygget, så tilläggen är redo att användas så snart containern startar. När du har ändrat tilläggslistan använder du kommandot Rebuild och Reopen in Dev Container i Visual Studio Code för att återskapa containern med de uppdaterade tilläggen.

Läs mer om azd Dev Container Feature.

Verifiera din installation

azd Kontrollera att installationen har slutförts genom att azd version köra kommandot i en terminal:

azd version

azd skriver ut den aktuella versionen:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Uppdatera CLI för Azure Developer

Du kan uppdatera azd med det inbyggda azd update kommandot (Beta) eller manuellt med samma metod som du använde för att installera det.

Använd azd update (Beta)

Kommandot azd update identifierar hur azd installerades ursprungligen och delegerar automatiskt till lämplig uppdateringsmetod:

Installationsmetod Vad azd update gör
winget Kör winget upgrade Microsoft.Azd
choco Körs choco upgrade azd
Installera skript eller MSI (Windows) Körs install-azd.ps1 med automatisk säkerhetskopiering och återställning
Installera skript (Linux/macOS) Körs install-azd.sh
Homebrew Körs brew upgrade --cask azure/azd/azd
.deb / .rpm Paket Laddar ned och ersätter binärfilen direkt

Kör följande kommando för att uppdatera till den senaste stabila versionen:

azd update

Anmärkning

Kommandot azd update finns för närvarande i Beta. Läs mer om stöd för alfa- och betafunktioner på sidan med funktionsversioner och lanseringsstrategi .

Växla uppdateringskanaler

azd stöder två uppdateringskanaler: stable (standard) och daily. Kanalväxling stöds för skriptbaserade installationer och Homebrew. Om du har installerat azd via winget eller choco, är dagliga versioner inte tillgängliga via dessa pakethanterare – azd update visar vägledning för att installera om via skript först.

Växla till daily kanalen och uppdatera:

azd update --channel daily

Så här växlar du tillbaka till stable kanalen:

azd update --channel stable

När du byter kanal azd uppmanas du att bekräfta innan du fortsätter.

Använda pakethanteraren eller installationsskriptet

Du kan också uppdatera manuellt när som helst med hjälp av samma pakethanterare eller installera skriptkommandon som visas i installationsavsnitten ovan. När azd är inaktuellt visas ett varningsmeddelande med det tillämpliga uppdateringskommandot för installationsmetoden.

Begär hjälp

Information om hur du skickar in en bugg, begär hjälp eller föreslår en ny funktion för Azure Developer CLI finns på sidan troubleshooting and support.

Nästa steg

Vanliga frågor och svar om Azure Developer CLI