W tym szybkim starcie dowiesz się, jak przydzielić i wdrożyć zasoby aplikacji w Azure przy użyciu szablonu wiersza poleceń Azure Developer CLI i kilku poleceń. szablony azd to standardowe repozytoria kodu zawierające kod źródłowy aplikacji, a także pliki konfiguracji i infrastruktury azd w celu aprowizowania zasobów Azure. Aby dowiedzieć się więcej na temat szablonów azd i jak mogą przyspieszyć proces aprowizacji i wdrażania Azure, zobacz Co to są szablony interfejsu wiersza polecenia dewelopera Azure?.
Wybieranie i wdrażanie szablonu
W kolejnych krokach użyjesz następującego szablonu, aby aprowizować i wdrożyć aplikację w Azure:
Możesz również wybrać szablon zgodny z preferencjami w witrynie galerii szablonów Awesome AZD . Niezależnie od tego, którego szablonu używasz, będziesz mieć kod szablonu w środowisku projektowym i będzie można uruchamiać polecenia w celu kompilowania, ponownego wdrażania i monitorowania aplikacji w Azure.
Wybierz preferowane środowisko, aby kontynuować:
Lokalne środowisko programistyczne to doskonały wybór dla tradycyjnych przepływów pracy programowania. Sklonujesz repozytorium szablonu na swoje urządzenie i uruchomisz polecenia w lokalnej instalacji programu azd.
Wymagania wstępne
Inicjowanie projektu
W Eksplorator plików lub terminalu utwórz nowy pusty katalog i przejdź do niego.
azd init Uruchom polecenie i określ szablon, którego chcesz użyć jako parametru:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Wprowadź nazwę środowiska po wyświetleniu monitu, na przykład azdquickstart, która ustawia prefiks nazewnictwa dla grupy zasobów, która zostanie utworzona do przechowywania zasobów Azure.
Co to jest nazwa środowiska w azd?
Po tym, jak określisz środowisko, azd klonuje szablon projektu na Twoją maszynę i inicjuje projekt.
Aprowizuj i wdrażaj zasoby aplikacji
azd auth login Uruchom polecenie i azd uruchom przeglądarkę, aby ukończyć proces logowania.
azd auth login
azd up Uruchom polecenie:
azd up
Po zalogowaniu się do Azure zostanie wyświetlony monit o podanie następujących informacji:
| Parametr |
Opis |
Azure Location |
Lokalizacja Azure, w której zostaną wdrożone zasoby. |
Azure Subscription |
Subskrypcja Azure, w której zostaną wdrożone zasoby. |
Wybierz żądane wartości i naciśnij Enter. Polecenie azd up obsługuje następujące zadania za pomocą plików konfiguracji szablonu i infrastruktury:
- Tworzy i konfiguruje wszystkie niezbędne zasoby Azure (
azd provision), w tym:
- Zasady dostępu i role dla twojego konta
- Komunikacja pomiędzy usługami przy użyciu zarządzanych tożsamości
- Pakuje i wdraża kod (
azd deploy)
Po pomyślnym zakończeniu azd up polecenia interfejs wiersza polecenia wyświetli dwa linki umożliwiające wyświetlenie utworzonych zasobów:
- Aplikacja ToDo API
- Fronton aplikacji internetowej ToDo
Uwaga
Możesz wywołać azd up tyle razy ile chcesz, aby aprowizować i wdrażać aktualizacje aplikacji.
Wdrożenie może zakończyć się niepowodzeniem, ponieważ zasób jest niemożliwy do wdrożenia w wybranym regionie. Ponieważ jest to szybki start, można bezpiecznie usunąć .azure katalog i spróbować azd up ponownie. Po zapytaniu wybierz inny region. W bardziej zaawansowanym scenariuszu można selektywnie edytować pliki w katalogu, .azure aby zmienić region.
CLI dewelopera Azure oferuje rozszerzenie Visual Studio Code, które usprawnia pracę z funkcjami azd. Na przykład można użyć interfejsu palety poleceń do uruchamiania azd poleceń. Aby wykonać kolejne kroki, musisz zainstalować rozszerzenie Azure Developer CLI dla Visual Studio Code.
Instalowanie rozszerzenia interfejsu wiersza polecenia dewelopera Azure
Otwórz Visual Studio Code.
Z menu Widok wybierz pozycję Rozszerzenia.
W polu wyszukiwania wprowadź Azure Developer CLI.
Wybierz pozycję Zainstaluj i poczekaj na zakończenie procesu instalacji.
Inicjowanie nowej aplikacji
Otwórz pusty katalog w Visual Studio Code.
Z menu Widok wybierz pozycję Paleta poleceń....
Wyszukaj polecenie Azure Developer CLI (azd): Initialize app (init) i naciśnij klawisz Enter. Polecenie azd up instruuje azd przygotowania i wdrażania zasobów aplikacji.
Wybierz przepływ pracy Wybierz szablon .
Wyszukaj szablon React Web App with Node.js API and MongoDB on Azure i naciśnij klawisz Enter, aby go wybrać.
Visual Studio Code klonuje szablon azd. Szablon zawiera infrastrukturę jako pliki kodu w infra folderze i przykładową aplikację w folderze src . Pliki infrastruktury jako kod zapewniają wymagane przez aplikację zasoby na Azure, gdy jest wdrażana.
Wyszukaj szablon React Web App z interfejsem API Python i bazą danych MongoDB w szablonie Azure i naciśnij klawisz Enter, aby go wybrać.
Visual Studio Code klonuje szablon azd. Szablon zawiera infrastrukturę jako pliki kodu w infra folderze i przykładową aplikację w folderze src . Infrastruktura jako kod dostarcza zasoby niezbędne w Azure, które są wymagane przez aplikację podczas wdrażania.
Wyszukaj szablon React Web App with C# API and MongoDB on Azure a następnie naciśnij klawisz Enter, aby go wybrać.
Visual Studio Code klonuje szablon azd. Szablon zawiera infrastrukturę jako pliki kodu w infra folderze i przykładową aplikację w folderze src . Pliki infrastruktury jako kod zapewniają niezbędne zasoby na platformie Azure potrzebne aplikacji podczas jej wdrażania.
Wyszukaj szablon Containerized React Web App with Java API and MongoDB on Azure template (Azure
Visual Studio Code klonuje szablon azd. Szablon zawiera infrastrukturę jako pliki kodu w infra folderze i przykładową aplikację w folderze src . Infrastruktura jako kod aprowizjonuje niezbędne zasoby na platformie Azure dla aplikacji podczas jej wdrażania.
Po sklonowanym szablonie Visual Studio Code otworzy terminal, aby wyświetlić monit o podanie nazwy środowiska. Wprowadź krótką nazwę wybranego elementu, na przykład azdvscode i naciśnij Enter.
Enter a new environment name: [? for help] azdvscode
Nazwa środowiska wpływa na sposób nazywania zasobów tworzonych w Azure i tworzy folder w katalogu szablonów .azure, aby przechowywać niektóre ustawienia środowiska.
Aprowizuj i wdrażaj zasoby aplikacji
Otwórz paletę poleceń i wyszukaj polecenie Azure Developer CLI (azd): Package, Provision and Deploy(up) i naciśnij klawisz Enter. Polecenie azd up instruuje azd przygotowania i wdrażania zasobów aplikacji.
Visual Studio Code otwiera okno terminalu, aby wyświetlić postęp procesu aprowizacji i wdrażania.
azd używa ustawień subskrypcji i lokalizacji wybranych podczas init procesu wdrażania zasobów.
Uwaga
Proces aprowizacji i wdrażania może potrwać kilka minut.
Po zakończeniu procesu wdrażania wybierz link w oknie danych wyjściowych udostępnionych przez azd , aby uruchomić witrynę w przeglądarce.
Codespaces to świetna opcja dla deweloperów, którzy wolą pracować w konteneryzowanych środowiskach w chmurze i unikać instalowania narzędzi lub zależności lokalnie.
Konfigurowanie usługi Codespace
- Nad listą plików kliknij Użyj tego szablonu>Otwórz w Codespace.
W Codespaces wszystkie wymagania wstępne są już zainstalowane, w tym rozszerzenie azd Visual Studio Code.
Uruchamianie szablonu
Po utworzeniu aplikacji Codespace kliknij prawym przyciskiem myszy plik azure.yaml w katalogu głównym. Z opcji wybierz pozycję up (aprowizuj zasoby i wdróż kod w Azure).
Po uruchomieniu azd up polecenia zostanie wyświetlony monit o podanie następujących informacji oraz zalogowanie się przy użyciu przeglądarki internetowej i kodu uwierzytelniania:
| Parametr |
Opis |
Environment Name |
Prefiks grupy zasobów, który zostanie utworzony do przechowywania wszystkich Azure zasobów. Co oznacza nazwa środowiska w azd? Zawsze możesz utworzyć nowe środowisko za pomocą polecenia azd env new. |
Azure Location |
Lokalizacja Azure, w której zostaną wdrożone zasoby. |
Azure Subscription |
Subskrypcja Azure, w której zostaną wdrożone zasoby. |
Wykonanie tego procesu może zająć trochę czasu, ponieważ azd up polecenie obsługuje następujące zadania:
- Tworzy i konfiguruje wszystkie niezbędne zasoby Azure (
azd provision).
- Konfiguruje zasady dostępu i role dla konta.
- Wdraża komunikację między usługami przy użyciu Tożsamości Zarządzanych.
- Pakuje i wdraża kod (
azd deploy).
Po podaniu niezbędnych parametrów i zakończeniu polecenia azd up, terminal CodeSpaces wyświetli dwa linki do portalu Azure, aby wyświetlić utworzone zasoby.
- Aplikacja ToDo API
- Fronton aplikacji internetowej ToDo
Co się stało?
Po pomyślnym zakończeniu polecenia azd up:
- Zasoby Azure przywoływane w pliku
README.md szablonu zostały aprowizowane do subskrypcji Azure, którą określiłeś, po uruchomieniu azd up. Możesz teraz wyświetlić te zasoby Azure za pośrednictwem portalu Azure.
- Aplikacja została skompilowana i wdrożona w Azure. Korzystając z adresu URL aplikacji webowej pochodzącego z polecenia
azd up, możesz przejść do w pełni funkcjonalnej aplikacji.
Uwaga
- Możesz wywołać
azd up dowolną liczbę razy, aby aprowizować i wdrażać aplikację.
- Uruchamianie i debugowanie, które wymaga otwarcia przeglądarki internetowej, nie jest obecnie obsługiwane z powodu znanych ograniczeń z GitHub Codespaces. Aby uzyskać lepsze wrażenia, zalecamy używanie usługi Codespaces na komputerze stacjonarnym.
DevContainer to obraz platformy Docker zawierający wszystkie wymagania wstępne wymagane do pracy z szablonem azd na komputerze lokalnym. Są doskonałym wyborem dla deweloperów, którzy preferują konteneryzowane środowiska, które nadal działają na urządzeniu lokalnym zamiast usługi w chmurze, takiej jak GitHub Codespaces.
Wymagania wstępne
Inicjowanie projektu
Otwórz terminal, utwórz nowy pusty katalog i przejdź do niego.
Uruchom następujące polecenie, aby zainicjować projekt:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Po uruchomieniu azd init polecenia zostanie wyświetlony monit o podanie następujących informacji:
| Parametr |
Opis |
Environment Name |
Prefiks grupy zasobów, który zostanie utworzony do przechowywania wszystkich Azure zasobów. Co oznacza nazwa środowiska w azd? Zawsze możesz utworzyć nowe środowisko za pomocą polecenia azd env new. |
Otwieranie usługi DevContainer
- Otwórz projekt w programie VS Code.
- Naciśnij F1 i wybierz:
Remote-Containers: Rebuild and Reopen in Container
Wykonaj polecenie up
Uruchom następujące polecenie:
azd up
Po uruchomieniu azd up polecenia zostanie wyświetlony monit o podanie następujących informacji:
| Parametr |
Opis |
Azure Location |
Lokalizacja Azure, w której zostaną wdrożone zasoby. |
Azure Subscription |
Subskrypcja Azure, w której zostaną wdrożone zasoby. |
Uruchomienie azd up polecenia może zająć trochę czasu, ponieważ wykonuje następujące kroki:
- Tworzy i konfiguruje wszystkie niezbędne zasoby Azure (
azd provision), w tym:
- Zasady dostępu i role dla twojego konta
- Komunikacja pomiędzy usługami przy użyciu zarządzanych tożsamości
- Pakuje i wdraża kod (
azd deploy)
Po podaniu niezbędnych parametrów i zakończeniu polecenia azd up interfejs wiersza polecenia wyświetla dwa linki do portalu Azure, aby zobaczyć utworzone zasoby.
- Aplikacja ToDo API
- Fronton aplikacji internetowej ToDo
Uwaga
Możesz uruchomić azd up dowolną liczbę razy, aby aprowizować i wdrażać aplikację w tym samym regionie oraz przy użyciu tych samych wartości konfiguracji podanych w pierwszym uruchomieniu.
Czyszczenie zasobów
Jeśli nie potrzebujesz już zasobów utworzonych w tym artykule, uruchom następujące polecenie, aby wyłączyć aplikację:
azd down
Jeśli chcesz ponownie wdrożyć go w innym regionie, usuń .azure katalog przed ponownym uruchomieniem azd up . W bardziej zaawansowanym scenariuszu można selektywnie edytować pliki w katalogu, .azure aby zmienić region.
Zażądaj pomocy
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ą.
Następne kroki