Udostępnij za pośrednictwem

Instalowanie lub aktualizowanie interfejsu wiersza polecenia dewelopera Azure

Witamy w Azure Developer CLI (azd)! Zacznijmy od instalowania i nauki, jak uruchomić azd.

Zacznij od wybrania środowiska projektowego. Aby uzyskać więcej informacji na temat zalet i wad różnych opcji środowiska deweloperskiego, zobacz sekcję Azure Developer CLI (azd) obsługiwane środowiska.

Aby uzyskać bardziej zaawansowane scenariusze instalacji i instrukcje, zobacz Skrypty instalacji Azure Developer CLI.

Uwaga: po zainstalowaniu programu azdnastępujące narzędzia są instalowane w azd zakresie (co oznacza, że nie są instalowane globalnie) i są usuwane, jeśli azd zostanie odinstalowany:

  • Interfejs wiersza polecenia GitHub
  • Interfejs wiersza polecenia Bicep

Zainstaluj azd

winget install microsoft.azd

Aktualizacja azd

winget upgrade microsoft.azd

Odinstalowywanie azd

winget uninstall microsoft.azd

Uwaga / Notatka

Na komputerach Mac z układami Apple Silicon (M1 i M2) azd wymaga Rosetty 2. Jeśli program Rosetta 2 nie został jeszcze zainstalowany, uruchom polecenie softwareupdate --install-rosetta z poziomu terminalu.

Proces azd instalacji automatycznie wybierze prawidłowy plik binarny dla architektury maszyny.

Zainstaluj azd

brew install azure/azd/azd

Jeśli używasz brew do uaktualnienia azd z wersji, która nie została zainstalowana przy użyciu brew, usuń istniejącą wersję azd za pomocą skryptu dezinstalacji (jeśli jest zainstalowana w domyślnej lokalizacji) lub ręcznie usuń plik binarny azd. Spowoduje to automatyczne zainstalowanie poprawnej wersji.

Aktualizacja azd

brew upgrade azure/azd/azd

Odinstalowywanie azd

brew uninstall azd

Zainstaluj azd

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

Aktualizacja azd

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

Po zainstalowaniu azd następujące narzędzia są instalowane w zakresie azd (co oznacza, że nie są instalowane globalnie) i są usuwane, jeśli azd zostanie odinstalowany:

Odinstalowywanie azd

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

Wymagania wstępne

Przed rozpoczęciem korzystania z programu azdupewnij się, że masz:

Instalowanie azd w kontenerze deweloperskim

Kontener deweloperski to obraz platformy Docker zawierający wszystkie wymagania wstępne wymagane do uruchomienia aplikacji na komputerze lokalnym. Zainstaluj azd jako funkcję w kontenerze deweloperskim, wykonując następujące kroki:

  1. Dodaj funkcję azd do pliku devcontainer.json w folderze .devcontainer w katalogu głównym szablonu.

    {
    "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. Odbuduj i uruchom swój kontener programistyczny. W Visual Studio Code użyj palety poleceń, aby wykonać polecenie Przebuduj i otwórz ponownie w kontenerze deweloperskim.

Automatyczne instalowanie rozszerzeń azd

Funkcja azd kontenera deweloperskiego obsługuje extensions opcję automatycznego instalowania rozdzielanej przecinkami listy azd rozszerzeń podczas kompilacji kontenera. Rozszerzenia zainstalowane w ten sposób są dostępne natychmiast po uruchomieniu kontenera, co zmniejsza konfigurację ręczną i umożliwia azd uruchamianie poleceń z już zainstalowanymi wymaganymi rozszerzeniami.

Żeby automatycznie zainstalować rozszerzenia, dodaj opcję extensions do wpisu funkcji azd w pliku devcontainer.json.

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

Wartość extensions jest rozdzielaną przecinkami listą azd nazw rozszerzeń. Instalacja odbywa się podczas kompilacji kontenera, więc rozszerzenia są gotowe do użycia natychmiast po uruchomieniu kontenera. Po zmianie listy rozszerzeń użyj polecenia Ponowne kompilowanie i ponowne otwieranie w kontenerze deweloperskim w programie Visual Studio Code, aby ponownie skompilować kontener przy użyciu zaktualizowanych rozszerzeń.

Dowiedz się więcej o funkcji kontenera deweloperskiego azd.

Weryfikowanie instalacji

Sprawdź, azd czy instalacja została ukończona pomyślnie, uruchamiając azd version polecenie w terminalu:

azd version

azd Drukuje bieżącą wersję:

azd version 1.9.5 (commit cd2b7af9995d358aab33c782614f801ac1997dde)

Zaktualizuj Azure Developer CLI

Podczas pracy z nieaktualną wersją azdprogramu zostanie wyświetlone ostrzeżenie o uaktualnieniu do najnowszej wersji. Postępuj zgodnie z instrukcjami w ostrzeżeniu, aby zaktualizować do najnowszej wersji.

Proszenie o pomoc

Aby uzyskać informacje o tym, jak zgłosić usterkę, poprosić o pomoc lub zaproponować nową funkcję dla interfejsu wiersza polecenia dewelopera Azure, odwiedź stronę troubleshooting i pomoc techniczną.

Dalsze kroki

Szybki start — wybieranie i wdrażanie szablonu azd

Czym są szablony CLI dla deweloperów w Azure?

Azure CLI dla Deweloperów - Często zadawane pytania

  • Last updated on