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

Ukończone

Interfejs wiersza polecenia dla deweloperów platformy Azure (azd) jest tworzony wokół poleceń przyjaznych dla deweloperów i podstawowych szablonów aplikacji. azd udostępnia zestaw poleceń, które ułatwiają dołączanie aplikacji na platformie Azure i zarządzanie nią przy użyciu standardowych 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 zacząć korzystać z azd, pracując nad jednym z istniejących i rozszerzalnych przykładowych szablonów lub tworząc własne.

Eksplorowanie poleceń azd

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 przepływ pracy azd korzystający z istniejącego szablonu obejmuje następujące kroki:

1. Uruchom polecenie azd init z parametrem --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 ma minimalną liczbę poleceń z niewielką liczbą parametrów, co ułatwia użytkowanie. Oto niektóre z najczęściej używanych poleceń azd:

• azd init — inicjowanie nowej aplikacji.
• . Przydziel zasoby platformy Azure i wdrażaj projekt za pomocą jednego polecenia.
• udostępnienie zasobów — Przydzielaj zasoby platformy Azure dla aplikacji.
• azd deploy — wdrażanie kodu aplikacji na platformie Azure.
• azd pipeline — (beta) Zarządzaj i konfiguruj swoje potoki wdrażania.
• azd auth - Uwierzytelnianie za pomocą Azure.
• azd config — zarządzanie ustawieniami narzędzia azd (na przykład domyślną subskrypcją Azure, lokalizacją).
• azd down — Usuwanie zasobów platformy Azure dla aplikacji.

Eksplorowanie szablonów azd

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 muszą aprowizować zasoby platformy Azure i opcjonalnie wdrożyć kod źródłowy 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 szablonu azd — istnieje już duża biblioteka szablonów azd obejmujących typowe lokalne stosy aplikacji, scenariusze i architektury. Możesz przeglądać wiele szablonów w bibliotece szablonów awesome-azd na witrynie . Jeśli znajdziesz szablon, który odpowiada na lokalny stos aplikacji lub pożądaną architekturę, możesz użyć go jako punkt wyjścia. Następnie zastąp katalog kodu źródłowego i zmodyfikuj pliki konfiguracji lub infrastruktury, aby spełniały Twoje potrzeby.

• Przekonwertuj własną aplikację na szablon azd — możesz również przekonwertować istniejącą aplikację na azd template, postępując zgodnie z przewodnikiem Ustaw projekt zgodny z przewodnikiem azd. 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 przy użyciu azd init.

  • 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.

  • Wdrożenie & za pomocą azd up.

    

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

• infra folder — zawiera całą infrastrukturę Bicep lub Terraform jako pliki kodu 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 Co to jest infrastruktura jako kod? moduł szkoleniowy.

• azure.yaml plik — 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 i zmienne środowiskowe platformy Azure, 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 szablony azd udostępniają tylko zasoby infrastruktury i pozostawiają pusty katalog src, aby dodać własny kod aplikacji.

  

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

• .devcontainer folder — umożliwia skonfigurowanie środowiska kontenera deweloperskiego dla aplikacji. Typowe podejście środowiska programistycznego, które nie jest specyficzne dla azd.
• .github folder — przechowuje pliki przepływu pracy CI/CD dla GitHub Actions, domyślnego dostawcy CI/CD dla azd.
• .azdo folder — jeśli zdecydujesz się użyć Azure Pipelines do CI/CD, zdefiniuj pliki konfiguracji przepływu pracy w tym folderze.