Instalowanie lub aktualizowanie interfejsu wiersza polecenia dewelopera Azure

Witamy w Azure Developer CLI (Interfejs wiersza polecenia dewelopera Azure) (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 Azure Developer CLI (azd) i obsługiwane przez niego środowiska.

Aby uzyskać bardziej zaawansowane scenariusze instalacji i instrukcje, zobacz skrypty instalacyjne 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 --cask 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ń do wykonania polecenia Odbuduj i ponownie otwórz 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 Rebuild i Otwórz ponownie w kontenerze deweloperskim w Visual Studio Code, aby ponownie skompilować kontener przy użyciu zaktualizowanych rozszerzeń.

Dowiedz się więcej o azd Dev Container Feature.

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)

Aktualizowanie interfejsu wiersza polecenia dewelopera Azure

Możesz zaktualizować azd przy użyciu wbudowanego azd update polecenia (beta) lub ręcznie przy użyciu tej samej metody, która została użyta do jej zainstalowania.

Użyj azd update (wersja beta)

Polecenie azd update automatycznie wykrywa, w jaki sposób azd zostało pierwotnie zainstalowane i deleguje odpowiednią metodę aktualizacji.

Metoda instalacji Co azd update robi
winget Uruchamia winget upgrade Microsoft.Azd
choco Uruchamia choco upgrade azd
Instalowanie skryptu lub MSI (Windows) Uruchamia install-azd.ps1 z automatyczną kopią zapasową i przywracaniem
Skrypt instalacji (Linux/macOS) Uruchamia install-azd.sh
Homebrew Uruchamia brew upgrade --cask azure/azd/azd
.deb / .rpm Pakiet Bezpośrednie pobieranie i zastępowanie pliku binarnego

Uruchom następujące polecenie, aby zaktualizować do najnowszej stabilnej wersji:

azd update

Uwaga / Notatka

Polecenie azd update jest obecnie w wersji beta. Przeczytaj więcej na temat wsparcia wersji alpha i beta na stronie wersjonowania funkcji i strategii wydań.

Przełączanie kanałów aktualizacji

azd obsługuje dwa kanały aktualizacji: stable (ustawienie domyślne) i daily. Przełączanie kanału jest obsługiwane w przypadku instalacji opartych na skryptach i oprogramowania Homebrew. Jeśli zainstalowałeś azd za pośrednictwem winget lub choco, codzienne kompilacje nie są dostępne przez tych menedżerów pakietów — azd update wyświetli wskazówki dotyczące ponownej instalacji za pośrednictwem skryptu.

Aby przełączyć się do kanału daily i zaktualizować:

azd update --channel daily

Aby przełączyć się z powrotem do kanału stable :

azd update --channel stable

Podczas przełączania kanałów azd monituje o potwierdzenie przed kontynuowaniem.

Używanie menedżera pakietów lub skryptu instalacji

Można również aktualizować ręcznie w dowolnym momencie przy użyciu tego samego menedżera pakietów lub poleceń skryptu instalacji pokazanych w powyższych sekcjach instalacji. Gdy azd jest nieaktualna, wyświetla komunikat ostrzegawczy z odpowiednim poleceniem aktualizacji dla metody instalacji.

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

Co to są szablony interfejsu wiersza polecenia Azure dla deweloperów?

Azure CLI dla Deweloperów — często zadawane pytania

  • Last updated on