A Azure fejlesztői parancssori felület telepítése vagy frissítése

Üdvözli a Azure fejlesztői parancssori felület (azd)! Lássunk hozzá a telepítéshez és a futtatás azdelsajátításához.

Először válassza ki a fejlesztési környezetet. A különböző fejlesztési környezetek előnyeiről és hátrányairól további információt a Azure Fejlesztői cli (azd) által támogatott környezetek című témakörben talál.

További speciális telepítési forgatókönyvek és utasítások: Azure Developer CLI Installer Scripts.

Megjegyzés: Amikor telepíti a azd, a következő eszközök a azd hatókörében lesznek telepítve (ami azt jelenti, hogy nincsenek globálisan telepítve), és eltávolításra kerülnek, ha az azd eltávolításra kerül.

azd telepítése

winget install microsoft.azd

Frissítés azd

winget upgrade microsoft.azd

Eltávolítás azd

winget uninstall microsoft.azd

Megjegyzés:

Apple Silicon Mac (M1 és M2) azd esetén Rosetta 2 szükséges. Ha a Rosetta 2 még nincs telepítve, futtassa softwareupdate --install-rosetta a terminálról.

A azd telepítési folyamat automatikusan kiválasztja a megfelelő bináris fájlt a gép architektúrájához.

azd telepítése

brew install azure/azd/azd

Ha a brew eszközt használja a azd nélküli telepítésből származó brew verzió frissítésére, távolítsa el az aktuálisan telepített azd verziót az eltávolító szkripttel (ha az alapértelmezett helyre van telepítve), vagy manuálisan törölje a azd bináris fájlt. Ez automatikusan telepíti a megfelelő verziót.

Frissítés azd

brew upgrade --cask azure/azd/azd

Eltávolítás azd

brew uninstall azd

azd telepítése

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

Frissítés azd

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

Telepítéskor a azd a következő eszközök a azd hatókörön belül kerülnek telepítésre (ami azt jelenti, hogy nincsenek globálisan telepítve), és azd eltávolítása esetén eltávolításra kerülnek.

Eltávolítás azd

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

Előfeltételek

A azd használata előtt, győződjön meg arról, hogy az alábbiak rendelkezésre állnak:

Telepítsd azd fejlesztői tárolóba

A fejlesztői tároló egy Docker-rendszerkép, amely tartalmazza az alkalmazás helyi gépen való futtatásához szükséges összes előfeltételt. Telepítse azd szolgáltatásként a fejlesztői tárolóban az alábbi lépések végrehajtásával:

  1. Adja hozzá a azd funkciót a devcontainer.json.devcontainer sablon gyökerénél található mappában lévő fájlhoz.

    {
        "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. Építse újra és futtassa a fejlesztői tárolót. A Visual Studio Code parancspaletta használatával hajtsa végre az "Újraépítés és újranyitás fejlesztői konténerben" parancsot.

Azd-bővítmények automatikus telepítése

A azd Dev Container Feature támogat egy extensions opciót, amely automatikusan telepíti a azd bővítményeket tartalmazó vesszővel elválasztott listát a tároló felépítése során. Az ilyen módon telepített bővítmények a tároló elindításakor azonnal elérhetők, csökkentve a manuális beállítást, és lehetővé teszik azd a parancsok futtatását a már telepített szükséges bővítményekkel.

Bővítmények automatikus telepítéséhez adja hozzá a extensions opciót a azd funkcióbejegyzéshez a devcontainer.json fájlban:

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

Az extensions érték a bővítménynevek vesszővel tagolt listája azd . A telepítés a tároló összeállítása során történik, így a bővítmények a tároló indításakor azonnal használatra készek. A bővítmények listájának módosítása után használja a Rebuild and Reopen in Dev Container parancsot a Visual Studio Code a tároló frissített bővítményekkel való újraépítéséhez.

További információ a azd Fejlesztői tároló szolgáltatásról.

A telepítés ellenőrzése

Ellenőrizze, hogy a azd telepítés sikeresen befejeződött-e a azd version parancs terminálon való futtatásával:

azd version

azd az aktuális verziót nyomtatja ki:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

A Azure fejlesztői parancssori felületének frissítése

A beépített azd parancsot (bétaverzió) vagy a telepítéshez használt módszert használva néhány egyszerű lépéssel frissítheti a azd update alkalmazást.

Használja azd update (bétaverzió)

A azd update parancs észleli az eredeti telepítés módját azd , és automatikusan delegálja a megfelelő frissítési módszert:

Telepítési módszer Mit csinál azd update?
winget Futtatja winget upgrade Microsoft.Azd
choco Futtatja choco upgrade azd
Szkript vagy MSI telepítése (Windows) Automatikus biztonsági mentéssel és visszaállítással futtatható install-azd.ps1
Szkript telepítése (Linux/macOS) Futtatja install-azd.sh
Homebrew Futtatja brew upgrade --cask azure/azd/azd
.deb / .rpm Csomag Közvetlenül letölti és lecseréli a bináris fájlt

Futtassa a következő parancsot a legújabb stabil verzióra való frissítéshez:

azd update

Megjegyzés:

A azd update parancs jelenleg bétaverzióban érhető el. További információ az alfa- és bétaverziós funkciók támogatásáról a funkciók verziószámozási és kiadási stratégiájának oldalán.

Frissítési csatornák váltása

azd Két frissítési csatornát támogat: stable (alapértelmezett) és daily. A csatornaváltás a szkriptalapú telepítések és a Homebrew esetében támogatott. Ha a azd vagy winget csomagkezelőkön keresztül telepítette, a napi buildek nem érhetők el ezek segítségével – a choco útmutatást ad az elsőként szkripttel történő újratelepítéshez.

A csatornára való váltáshoz és a daily frissítéshez:

azd update --channel daily

Visszaváltás a stable csatornára:

azd update --channel stable

Csatornák azd váltása esetén a folytatás előtt megerősítést kér.

A csomagkezelő használata vagy szkript telepítése

Bármikor manuálisan is frissíthet ugyanazokkal a csomagkezelővel, vagy telepítheti a fenti telepítési szakaszokban látható szkriptparancsokat. Ha azd elavult, figyelmeztető üzenetet jelenít meg a telepítési módszerre vonatkozó frissítési paranccsal.

Segítség kérése

Ha további információt szeretne megtudni arról, hogyan nyújthat be hibát, kérhet segítséget vagy javasolhat új funkciót a Azure fejlesztői parancssori felületéhez, látogasson el a troubleshooting és támogatás oldalra.

Következő lépések