Jak działa interfejs wiersza polecenia dla deweloperów platformy Azure

Ukończone

Interfejs wiersza polecenia dla deweloperów platformy Azure (azd) jest oparty na poleceniach przyjaznych dla deweloperów i podstawowych szablonach aplikacji. azd Udostępnia zestaw poleceń, które ułatwiają dołączanie aplikacji i zarządzanie nią na platformie Azure przy użyciu ustandaryzowanych szablonów projektów. Te szablony obejmują wszystkie niezbędne zasoby kodu źródłowego i konfiguracji do aprowizowania i wdrażania aplikacji na platformie Azure. Możesz rozpocząć pracę z azd jednym z istniejących i rozszerzalnych przykładowych szablonów lub tworząc własne.

Eksplorowanie azd poleceń

Interfejs wiersza polecenia dla deweloperów platformy Azure zawiera przystępny zestaw poleceń mapujących na typowe etapy przepływu pracy programowania, takie jak aprowizowanie i wdrażanie zasobów. Niektóre azd polecenia, takie jak azd up również obsługują wiele etapów jednocześnie, aby jeszcze bardziej usprawnić te zadania.

Na przykład typowy azd przepływ pracy korzystający z istniejącego szablonu obejmuje następujące kroki:

1. Uruchom polecenie z parametrem , azd init --template aby sklonować istniejący szablon i ustawić nazwę środowiska po wyświetleniu monitu.

   azd init --template todo-nodejs-mongo
   

2. Uruchom polecenie , azd auth login aby zalogować się do subskrypcji platformy Azure.

   azd auth login
   

3. Uruchom polecenie , azd up aby aprowizować i wdrażać zasoby szablonu na platformie Azure.

   azd up
   

4. Po skonfigurowaniu środowiska na platformie Azure możesz lokalnie zmodyfikować funkcje aplikacji lub szablony zasobów platformy Azure, a następnie uruchomić azd up ponownie, aby aprowizować zmiany.

Inne azd polecenia są dostępne do wykonywania innych zadań i rozwijania tego przepływu pracy. azd jest przeznaczony do obsługi minimalnej liczby poleceń z kilkoma parametrami w celu ułatwienia użycia. Oto niektóre z najbardziej typowych azd poleceń:

• azd init — inicjowanie nowej aplikacji.
• azd up — aprowizuj zasoby platformy Azure i wdróż projekt za pomocą jednego polecenia.
• azd provision — aprowizuj zasoby platformy Azure dla aplikacji.
• azd deploy — wdrażanie kodu aplikacji na platformie Azure.
• potok azd — (beta) Zarządzanie potokami wdrażania i konfigurowanie ich.
• azd auth — uwierzytelnianie za pomocą platformy Azure.
• azd config — zarządzaj konfiguracjami azd (na przykład domyślną subskrypcją platformy Azure, lokalizacją).
• azd down — usuwanie zasobów platformy Azure dla aplikacji.

Eksplorowanie azd szablonów

Polecenia interfejsu wiersza polecenia dla deweloperów platformy Azure są przeznaczone do pracy ze standardowymi szablonami projektów. Każdy szablon to repozytorium kodu zgodne z określonymi konwencjami plików i folderów. Szablony zawierają zasoby azd wymagane do aprowizowania zasobów platformy Azure i opcjonalnie wdrażania kodu źródłowego aplikacji. Niektóre szablony mogą nie zawierać kodu źródłowego aplikacji zgodnie z założeniem, że dodajesz własne. Po uruchomieniu polecenia takiego jak azd upnarzędzie używa zasobów szablonu projektu do wykonywania różnych kroków przepływu pracy, takich jak aprowizowanie lub wdrażanie zasobów na platformie Azure.

Istnieją dwa główne podejścia do pracy z szablonami azd :

• Rozszerzanie istniejącego azd szablonu — istnieje już duża biblioteka szablonów azd , która obejmuje typowe lokalne stosy aplikacji, scenariusze i architektury. Wiele szablonów można przeglądać w witrynie biblioteki szablonów awesome-azd. Jeśli znajdziesz szablon mapujący na lokalny stos aplikacji lub żądaną architekturę, możesz użyć go jako punktu początkowego. Następnie zastąp katalog kodu źródłowego i zmodyfikuj pliki konfiguracji lub infrastruktury, aby spełniały Twoje potrzeby.

• Przekonwertuj własną azd aplikację na szablon — możesz również przekonwertować istniejącą aplikację na azd template element, postępując zgodnie z przewodnikiem Ustaw projekt zgodny z azd przewodnikiem. Tworzenie własnego szablonu jest często bardziej pracowite początkowo, ale pozwala na największą kontrolę i tworzy rozwiązanie wielokrotnego użytku na potrzeby przyszłych prac programistycznych nad aplikacją. Podstawowe kroki tworzenia własnego szablonu są następujące:

  • Zainicjuj szablon projektu za pomocą azd initpolecenia .

  • Utwórz infrastrukturę jako pliki kodu przy użyciu narzędzia Bicep lub Terraform.

  • Zaktualizuj plik, azure.yaml aby powiązać usługi app services wraz z zasobami platformy Azure.

  • Aprowizuj i wdróż za pomocą polecenia azd up.

    

Niezależnie od wybranego podejścia wynikowa struktura szablonu jest taka sama. Wszystkie azd szablony obejmują następujące zasoby:

• infra folder — zawiera całą infrastrukturę Bicep lub Terraform jako pliki kodu dla szablonu azd . Infrastruktura jako kod umożliwia definiowanie zasobów infrastruktury i konfiguracji w plikach definicji deklaratywnych, które niezawodnie generują te same środowiska za każdym razem, gdy są wdrażane. Narzędzie Terraform działa na wielu platformach w chmurze, podczas gdy Bicep jest specyficzny dla platformy Azure. azd Wykonuje te pliki w celu utworzenia zasobów platformy Azure wymaganych do hostowania aplikacji. Więcej informacji na temat infrastruktury jako kodu można dowiedzieć się w module szkoleniowym Co to jest infrastruktura jako kod?

• azure.yaml file — plik konfiguracji, który definiuje co najmniej jedną usługę w projekcie i mapuje je na zasoby platformy Azure na potrzeby wdrożenia. Można na przykład zdefiniować usługę interfejsu API i usługę frontonu internetowego z atrybutami, które mapują je na różne zasoby platformy Azure na potrzeby wdrożenia.

• .azure folder — zawiera podstawowe konfiguracje platformy Azure i zmienne środowiskowe, takie jak lokalizacja wdrażania zasobów lub innych informacji o subskrypcji.

• src folder — Zawiera cały kod źródłowy aplikacji, który można wdrożyć. Niektóre azd szablony udostępniają tylko zasoby infrastruktury i pozostaw src katalog pusty, aby dodać własny kod aplikacji.

  

Większość azd szablonów zawiera również co najmniej jeden z następujących folderów:

• .devcontainer folder — umożliwia skonfigurowanie środowiska deweloperskiego kontenera dla aplikacji. Typowe podejście środowiska programistycznego, które nie jest specyficzne dla azdusługi .
• .github folder — przechowuje pliki przepływu pracy ciągłej integracji/ciągłego wdrażania dla funkcji GitHub Actions, domyślnego dostawcy ciągłej integracji/ciągłego wdrażania dla usługi azd.
• .azdo folder — jeśli zdecydujesz się użyć usługi Azure Pipelines na potrzeby ciągłej integracji/ciągłego wdrażania, zdefiniuj pliki konfiguracji przepływu pracy w tym folderze.