Instalace nebo aktualizace rozhraní příkazového řádku pro vývojáře Azure

Vítá vás rozhraní příkazového řádku pro vývojáře Azure (azd)! Pojďme začít s instalací a učením se, jak spustit azd.

Začněte výběrem vývojového prostředí. Další informace o výhodách a nevýhodách různých možností vývojového prostředí najdete v tématu Azure Podporovaná prostředí rozhraní příkazového řádku pro vývojáře.

Pokročilejší scénáře a pokyny k instalaci najdete v tématu Azure Skripty instalačního programu rozhraní příkazového řádku pro vývojáře.

Poznámka: Při instalaci azdse v oboru azd nainstalují následující nástroje (což znamená, že nejsou nainstalované globálně) a odeberou se, pokud je azd odinstalován:

Instalujte azd

winget install microsoft.azd

Aktualizace azd

winget upgrade microsoft.azd

Odinstalovat azd

winget uninstall microsoft.azd

Poznámka:

Na Apple Silicon Mac (M1 a M2) vyžaduje azd Rosetta 2. Pokud rosetta 2 ještě není nainstalovaná, spusťte softwareupdate --install-rosetta z terminálu.

Proces azd instalace automaticky zvolí správný binární soubor pro architekturu vašeho počítače.

Instalujte azd

brew install azure/azd/azd

Pokud používáte brew k upgradu azd z verze, která není nainstalována pomocí brew, odstraňte stávající verzi azd pomocí odinstalačního skriptu (pokud je nainstalována ve výchozím umístění) nebo odstraněním binárního souboru azd ručně. Tím se automaticky nainstaluje správná verze.

Aktualizace azd

brew upgrade --cask azure/azd/azd

Odinstalovat azd

brew uninstall azd

Instalujte azd

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

Aktualizace azd

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

Při instalaci azd se v rámci azd nainstalují následující nástroje (což znamená, že nejsou nainstalované globálně) a odeberou se při odinstalaci azd:

Odinstalovat azd

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

Požadavky

Než začnete používat azd, ujistěte se, že máte:

Instalace azd v vývojovém kontejneru

Vývojový kontejner je image Dockeru, která zahrnuje všechny požadavky, které potřebujete ke spuštění aplikace na místním počítači. Nainstalujte azd jako funkci do svého vývojového kontejneru následujícími kroky:

  1. azd Přidejte funkci do devcontainer.json souboru ve .devcontainer složce v kořenovém adresáři šablony.

    {
    "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. Znovu sestavte a spusťte vývoj kontejner. V Visual Studio Code pomocí palety command spusťte příkaz Rebuild and Reopen in Dev Container.

Automatická instalace rozšíření azd

azd Funkce vývojového kontejneru podporuje extensions možnost automatické instalace seznamu rozšíření oddělených azd čárkami během sestavení kontejneru. Rozšíření nainstalovaná tímto způsobem jsou dostupná hned po spuštění kontejneru, což snižuje ruční instalaci a umožňuje azd spouštění příkazů s již nainstalovanými požadovanými rozšířeními.

Pokud chcete rozšíření automaticky nainstalovat, přidejte extensions do azd položky funkce v devcontainer.json souboru možnost:

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

Hodnota extensions je čárkami oddělený seznam azd názvů přípon. Instalace probíhá během sestavení kontejneru, takže rozšíření jsou připravená k použití hned po spuštění kontejneru. Po změně seznamu rozšíření pomocí příkazu Rebuild a Znovu otevřít v vývojovém kontejneru v Visual Studio Code znovu sestavte kontejner s aktualizovanými rozšířeními.

Přečtěte si další informace o funkci azd Dev Container Feature.

Ověření instalace

Ověřte úspěšné azd dokončení instalace spuštěním azd version příkazu v terminálu:

azd version

azd vytiskne aktuální verzi:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Aktualizace rozhraní příkazového řádku pro vývojáře Azure

K aktualizaci azd můžete použít integrovaný azd update příkaz (Beta) nebo ručně použít stejnou metodu, jakou jste použili k instalaci.

Použijte azd update (Beta)

Příkaz azd update zjistí, jak byl azd původně nainstalován a automaticky deleguje na příslušnou metodu aktualizace:

Metoda instalace Co azd update dělá
winget Spustí winget upgrade Microsoft.Azd
choco Spustí choco upgrade azd
Instalace skriptu nebo MSI (Windows) Spouští se install-azd.ps1 s automatickým zálohováním a obnovením.
Instalační skript (Linux/macOS) Spustí install-azd.sh
Homebrew Spustí brew upgrade --cask azure/azd/azd
.deb / .rpm Balíček Přímo stáhne a nahradí binární soubor.

Spuštěním následujícího příkazu aktualizujte nejnovější stabilní verzi:

azd update

Poznámka:

Příkaz azd update je aktuálně v beta verzi. Další informace o podpoře alfa a beta funkcí najdete na stránce verzování funkcí a strategie vydání.

Přepnutí aktualizačních kanálů

azd podporuje dva aktualizační kanály: stable (výchozí) a daily. Přepínání kanálů je podporováno pro instalace založené na skriptech a Homebrew. Pokud jste nainstalovali azd přes winget nebo choco, denní buildy nejsou dostupné prostřednictvím těchto správců balíčků – azd update vám zobrazí pokyny k přeinstalaci pomocí skriptu.

Přepnutí na daily kanál a aktualizace:

azd update --channel daily

Přepnutí zpět na stable kanál:

azd update --channel stable

Při přepínání kanálů se azd před pokračováním zobrazí výzva k potvrzení.

Použití správce balíčků nebo instalace skriptu

Můžete také kdykoli aktualizovat ručně pomocí stejného správce balíčků nebo nainstalovat skriptové příkazy uvedené v předchozích částech instalace. Pokud azd je zastaralý, zobrazí se varovná zpráva s příslušným příkazem update pro vaši metodu instalace.

Požádat o pomoc

Informace o tom, jak nahlásit chybu, požádat o pomoc nebo navrhnout novou funkci pro rozhraní příkazového řádku pro vývojáře Azure, najdete na stránce diagnostika a podpora.

Další kroky

Rychlý start – Výběr a nasazení šablony azd

Co jsou šablony rozhraní příkazového řádku pro vývojáře Azure?

Azure Nejčastější dotazy k rozhraní příkazového řádku pro vývojáře

  • Last updated on