Tworzenie środowiska przy użyciu interfejsu wiersza polecenia dla deweloperów platformy Azure

W tym artykule zainstalujesz interfejs wiersza polecenia dla deweloperów platformy Azure (AZD), utworzysz nowe środowisko wdrażania, aprowizuj infrastrukturę aplikacji w środowiskach wdrażania platformy Azure i wdrożysz kod aplikacji w zaaprowizowanych środowiskach wdrażania.

Interfejs wiersza polecenia dla deweloperów platformy Azure (AZD) to narzędzie typu open source, które skraca czas potrzebny na pobranie aplikacji z lokalnego środowiska deweloperskiego na platformę Azure. Usługa AZD zapewnia najlepsze rozwiązanie, przyjazne dla deweloperów polecenia mapowane na kluczowe etapy przepływu pracy, niezależnie od tego, czy pracujesz w terminalu, edytorze, czy zintegrowanym środowisku projektowym (IDE), czy ciągłej integracji/ciągłego wdrażania.

Aby dowiedzieć się, jak skonfigurować usługę AZD do pracy ze środowiskami wdrażania platformy Azure, zobacz Używanie interfejsu wiersza polecenia dla deweloperów platformy Azure z środowiskami wdrażania platformy Azure.

Wymagania wstępne

Należy:

• Zapoznaj się ze środowiskami wdrażania platformy Azure. Zapoznaj się z tematem Co to są środowiska wdrażania platformy Azure? i kluczowe pojęcia dotyczące środowisk wdrażania platformy Azure.
• Tworzenie i konfigurowanie centrum deweloperów przy użyciu projektu, typów środowisk i wykazu. Skorzystaj z następującego artykułu jako wskazówek:
  • Szybki start: tworzenie i konfigurowanie centrum deweloperskiego dla środowisk wdrażania platformy Azure.
• Wykaz dołączony do centrum deweloperów.

Przygotowanie do pracy z usługą AZD

Podczas pracy z usługą AZD po raz pierwszy należy wykonać kilka jednorazowych zadań konfiguracyjnych. Te zadania obejmują instalowanie interfejsu wiersza polecenia dla deweloperów platformy Azure, logowanie się do konta platformy Azure i włączanie obsługi usługi AZD dla środowisk wdrażania platformy Azure.

Instalowanie rozszerzenia interfejsu wiersza polecenia dla deweloperów platformy Azure dla programu Visual Studio Code

Podczas instalowania azd narzędzia azd są instalowane w zakresie azd, a nie globalnie, i są usuwane, jeśli azd zostanie odinstalowany. Plik azd można zainstalować w programie Visual Studio Code lub w wierszu polecenia.

Visual Studio Code

Aby włączyć funkcje interfejsu wiersza polecenia dla deweloperów platformy Azure w programie Visual Studio Code, zainstaluj rozszerzenie interfejsu wiersza polecenia dla deweloperów platformy Azure w wersji 0.8.0-alpha.1-beta.3173884. Wybierz ikonę Rozszerzenia na pasku Działań, wyszukaj pozycję Interfejs wiersza polecenia dla deweloperów platformy Azure, a następnie wybierz pozycję Zainstaluj.

Interfejs wiersza polecenia dla deweloperów platformy Azure

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Program Visual Studio

W programie Visual Studio 2022 17.3 (wersja zapoznawcza 2 lub nowsza) możesz włączyć integrację z aplikacją azd jako funkcję w wersji zapoznawczej.

Aby włączyć funkcję azd, przejdź do pozycji Narzędzia>Opcje>Środowiska>w wersji zapoznawczej i wybierz pozycję Integracja z azd, interfejs wiersza polecenia dla deweloperów platformy Azure.

Po włączeniu tej funkcji możesz użyć interfejsu wiersza polecenia dla deweloperów platformy Azure z wybranego terminalu w systemie Windows, Linux lub macOS.

Logowanie się przy użyciu interfejsu wiersza polecenia dla deweloperów platformy Azure

Uzyskaj dostęp do zasobów platformy Azure, logując się. Po zainicjowaniu logowania zostanie otwarte okno przeglądarki z monitem o zalogowanie się na platformie Azure. Po zalogowaniu w terminalu zostanie wyświetlony komunikat informujący o zalogowaniu się na platformie Azure.

Zaloguj się do usługi AZD przy użyciu palety poleceń:

Visual Studio Code

Dane wyjściowe poleceń wydanych z palety poleceń są wyświetlane w terminalu deweloperskim azd, podobnie jak w poniższym przykładzie:

Interfejs wiersza polecenia dla deweloperów platformy Azure

Zaloguj się do platformy Azure w interfejsie wiersza polecenia przy użyciu następującego polecenia:

 azd auth login

Program Visual Studio

Uzyskaj dostęp do zasobów platformy Azure, logując się. Po zainicjowaniu logowania zostanie otwarte okno przeglądarki z monitem o zalogowanie się na platformie Azure. Po zalogowaniu w terminalu zostanie wyświetlony komunikat informujący o zalogowaniu się na platformie Azure.

Aby otworzyć wiersz polecenia dla deweloperów:

1. W menu Narzędzia wybierz pozycję Terminal.

2. W oknie Terminal wybierz pozycję Wiersz polecenia dla deweloperów.

   

Zaloguj się do usługi AZD przy użyciu terminalu poleceń dewelopera:

 azd auth login

Włączanie obsługi usługi AZD dla usługi ADE

Usługę AZD można skonfigurować tak, aby aprowizować i wdrażać zasoby w środowiskach wdrażania przy użyciu standardowych poleceń, takich jak azd up lub azd provision. Gdy platform.type jest ustawiona wartość devcenter, wszystkie stany środowiska zdalnego AZD i aprowizacja używają składników centrum deweloperskiego. Usługa AZD używa jednego z szablonów infrastruktury zdefiniowanych w katalogu centrum deweloperów na potrzeby aprowizacji zasobów. W tej konfiguracji folder infra w szablonach lokalnych nie jest używany.

Visual Studio Code

Interfejs wiersza polecenia dla deweloperów platformy Azure

 azd config set platform.type devcenter

Program Visual Studio

 azd config set platform.type devcenter

Tworzenie środowiska na podstawie istniejącego kodu

Teraz możesz przystąpić do tworzenia środowiska do pracy. Możesz zacząć od kodu w folderze lokalnym lub sklonować istniejące repozytorium. W tym przykładzie utworzysz środowisko przy użyciu kodu w folderze lokalnym.

Inicjowanie nowej aplikacji

Inicjowanie nowej aplikacji powoduje utworzenie plików i folderów, które są wymagane do pracy z aplikacją przez usługę AZD.

Usługa AZD używa pliku azure.yaml do zdefiniowania środowiska. Plik azure.yaml definiuje i opisuje aplikacje i typy zasobów platformy Azure używanych przez aplikację. Aby dowiedzieć się więcej na temat pliku azure.yaml, zobacz Schemat azure.yaml interfejsu wiersza polecenia platformy Azure.

Visual Studio Code

1. W programie Visual Studio Code otwórz folder zawierający kod aplikacji.

2. Otwórz paletę poleceń i wprowadź init interfejsu wiersza polecenia dla deweloperów platformy Azure, a następnie z listy wybierz pozycję Interfejs wiersza polecenia dla deweloperów platformy Azure (azd): init.

   

3. Na liście szablonów, aby kontynuować bez wybierania szablonu, naciśnij klawisz ENTER dwa razy.

4. W terminalu usługi AZD wybierz pozycję Użyj kodu w bieżącym katalogu.

   

5. azd init identyfikuje usługi zdefiniowane w kodzie aplikacji i monituje o potwierdzenie i kontynuowanie, usuwanie usługi lub dodawanie usługi. Wybierz pozycję Potwierdź i kontynuuj inicjowanie mojej aplikacji.

   

6. azd init program kontynuuje zbieranie informacji w celu skonfigurowania aplikacji. W przypadku tej przykładowej aplikacji zostanie wyświetlony monit o podanie nazwy wystąpienia bazy danych MongoDB i portów, na których nasłuchują usługi.

   

7. Wprowadź nazwę lokalnego środowiska AZD.

   

8. azd init wyświetla listę projektów, do których masz dostęp. Wybieranie projektu dla środowiska

   

9. azd init Wyświetla listę definicji środowiska w projekcie. Wybierz definicję środowiska.

   

   Usługa AZD tworzy zasoby projektu, w tym plik azure.yaml w katalogu głównym projektu.

Interfejs wiersza polecenia dla deweloperów platformy Azure

1. W interfejsie wiersza polecenia przejdź do folderu zawierającego kod aplikacji.

2. Uruchom następujące polecenie, aby zainicjować aplikację i podać informacje po wyświetleniu monitu:

   azd init
   

3. W terminalu usługi AZD wybierz pozycję Użyj kodu w bieżącym katalogu.

   

   Usługa AZD skanuje bieżący katalog i zbiera więcej informacji w zależności od typu kompilowania aplikacji. Postępuj zgodnie z monitami, aby skonfigurować środowisko AZD.

4. azd init identyfikuje usługi zdefiniowane w kodzie aplikacji i monituje o potwierdzenie i kontynuowanie, usuwanie usługi lub dodawanie usługi. Wybierz pozycję Potwierdź i kontynuuj inicjowanie mojej aplikacji.

   

5. azd init program kontynuuje zbieranie informacji w celu skonfigurowania aplikacji. W przypadku tej przykładowej aplikacji zostanie wyświetlony monit o podanie nazwy wystąpienia bazy danych MongoDB i portów, na których nasłuchują usługi.

   

6. Wprowadź nazwę lokalnego środowiska AZD.

   

7. azd init wyświetla listę projektów, do których masz dostęp. Wybierz projekt dla swojego środowiska.

   

8. azd init Wyświetla listę definicji środowiska w projekcie. Wybierz definicję środowiska.

   

   Usługa AZD tworzy zasoby projektu, w tym plik azure.yaml w katalogu głównym projektu.

Program Visual Studio

1. W interfejsie wiersza polecenia przejdź do folderu zawierającego kod aplikacji.

2. Uruchom następujące polecenie, aby zainicjować aplikację i podać informacje po wyświetleniu monitu:

   azd init
   

3. W terminalu usługi AZD wybierz pozycję Użyj kodu w bieżącym katalogu.

   

   Usługa AZD skanuje bieżący katalog i zbiera więcej informacji w zależności od typu kompilowania aplikacji. Postępuj zgodnie z monitami, aby skonfigurować środowisko AZD.

4. azd init identyfikuje usługi zdefiniowane w kodzie aplikacji i monituje o potwierdzenie i kontynuowanie, usuwanie usługi lub dodawanie usługi. Wybierz pozycję Potwierdź i kontynuuj inicjowanie mojej aplikacji.

   

5. azd init program kontynuuje zbieranie informacji w celu skonfigurowania aplikacji. W przypadku tej przykładowej aplikacji zostanie wyświetlony monit o podanie nazwy wystąpienia bazy danych MongoDB i portów, na których nasłuchują usługi.

   

6. Wprowadź nazwę lokalnego środowiska AZD.

   

7. azd init wyświetla listę projektów, do których masz dostęp. Wybierz projekt dla swojego środowiska.

   

8. azd init Wyświetla listę definicji środowiska w projekcie. Wybierz definicję środowiska.

   Usługa AZD tworzy zasoby projektu, w tym plik azure.yaml w katalogu głównym projektu.

Aprowizuj infrastrukturę w środowisku wdrażania platformy Azure

Gdy wszystko będzie gotowe, możesz aprowizować środowisko lokalne w zdalnym środowisku środowisk wdrażania platformy Azure na platformie Azure. Ten proces aprowizuje infrastrukturę i zasoby zdefiniowane w definicji środowiska w katalogu centrum deweloperów.

Visual Studio Code

1. W Eksploratorze kliknij prawym przyciskiem myszy pozycję azure.yaml, a następnie wybierz pozycję Interfejs wiersza polecenia dla deweloperów platformy Azure (azd)>Aprowizuj zasoby platformy Azure (aprowizuj).

   

2. Usługa AZD skanuje środowiska wdrażania platformy Azure pod kątem projektów, do których masz dostęp. W terminalu usługi AZD wybierz lub wprowadź następujące informacje:

   1. Projekt
   2. Definicja środowiska
   3. Typ środowiska
   4. Lokalizacja

3. AZD nakazuje usłudze ADE utworzenie nowego środowiska na podstawie informacji podanych w poprzednim kroku.

4. Zasoby utworzone w witrynie Azure Portal lub w portalu dla deweloperów można wyświetlić.

Interfejs wiersza polecenia dla deweloperów platformy Azure

Aprowizuj aplikację na platformie Azure przy użyciu następującego polecenia:

azd provision

1. Element "azd provision" zawiera listę projektów, do których masz dostęp. Wybierz projekt, do którego chcesz aprowizować aplikację.

   

2. Element "azd provision" zawiera listę definicji środowiska w wybranym projekcie. Wybierz definicję środowiska, której chcesz użyć do aprowizacji aplikacji.

   

3. Element "azd provision" zawiera listę typów środowisk w wybranym projekcie. Wybierz typ środowiska, którego chcesz użyć do aprowizacji aplikacji.

   

4. AZD nakazuje usłudze ADE utworzenie nowego środowiska na podstawie informacji podanych w poprzednim kroku.

   

5. Zasoby utworzone w witrynie Azure Portal lub w portalu dla deweloperów można wyświetlić.

Program Visual Studio

Aprowizuj aplikację na platformie Azure przy użyciu następującego polecenia:

azd provision

1. Element "azd provision" zawiera listę projektów, do których masz dostęp. Wybierz projekt, do którego chcesz aprowizować aplikację.

   

2. Element "azd provision" zawiera listę definicji środowiska w wybranym projekcie. Wybierz definicję środowiska, której chcesz użyć do aprowizacji aplikacji.

   

3. Element "azd provision" zawiera listę typów środowisk w wybranym projekcie. Wybierz typ środowiska, którego chcesz użyć do aprowizacji aplikacji.

4. AZD nakazuje usłudze ADE utworzenie nowego środowiska na podstawie informacji podanych w poprzednim kroku.

5. Zasoby utworzone w witrynie Azure Portal lub w portalu dla deweloperów można wyświetlić.

Wyświetlanie listy istniejących środowisk (opcjonalnie)

Sprawdź, czy środowisko zostało utworzone, wyświetlając listę istniejących środowisk.

Visual Studio Code

1. W Eksploratorze kliknij prawym przyciskiem myszy plik azure.yaml, a następnie wybierz pozycję Interfejs wiersza polecenia dla deweloperów platformy Azure (azd)>Wyświetl środowiska lokalne i zdalne (lista env).

   

   Zostanie wyświetlony monit o wybranie projektu i definicji środowiska.

Interfejs wiersza polecenia dla deweloperów platformy Azure

Użyj następującego polecenia, aby wyświetlić środowiska, do których masz dostęp: lokalne środowisko AZD i zdalne środowisko środowiska wdrażania platformy Azure.

azd env list

azd env list monituje o wybranie projektu i definicji środowiska.

Program Visual Studio

Użyj następującego polecenia, aby wyświetlić środowiska, do których masz dostęp: lokalne środowisko AZD i zdalne środowisko środowiska wdrażania platformy Azure.

azd env list

azd env list monituje o wybranie projektu i definicji środowiska.

Wdrażanie kodu w środowiskach wdrażania platformy Azure

Po aprowizacji środowiska można wdrożyć kod w środowisku.

Visual Studio Code

1. W Eksploratorze kliknij prawym przyciskiem myszy pozycję azure.yaml, a następnie wybierz pozycję Interfejs wiersza polecenia dla deweloperów platformy Azure (azd)Deploy Azure Resources (deploy)>.

   

2. Aby sprawdzić, czy kod został wdrożony, wybierz adresy URL punktu końcowego wymienione w terminalu usługi AZD.

Interfejs wiersza polecenia dla deweloperów platformy Azure

Wdróż kod aplikacji w zdalnym środowisku środowisk wdrażania platformy Azure aprowizowania przy użyciu następującego polecenia:

azd deploy

Wdrażanie kodu w środowisku zdalnym może potrwać kilka minut.

Postęp wdrażania można wyświetlić w witrynie Azure Portal:

Po zakończeniu wdrażania można wyświetlić zasoby, które zostały aprowidowane w witrynie Azure Portal:

Aby sprawdzić, czy kod został wdrożony, wybierz adresy URL punktu końcowego wymienione w terminalu usługi AZD.

W przypadku tej przykładowej aplikacji zobaczysz coś podobnego do następującego:

Program Visual Studio

Wdróż kod aplikacji w zdalnym środowisku środowisk wdrażania platformy Azure aprowizowania przy użyciu następującego polecenia:

azd deploy

Wdrażanie kodu w środowisku zdalnym może potrwać kilka minut.

Postęp wdrażania można wyświetlić w witrynie Azure Portal:

Po zakończeniu wdrażania można wyświetlić zasoby, które zostały aprowidowane w witrynie Azure Portal:

Aby sprawdzić, czy kod został wdrożony, wybierz adresy URL punktu końcowego wymienione w terminalu usługi AZD.

Czyszczenie zasobów

Po zakończeniu pracy ze środowiskiem możesz usunąć zasoby platformy Azure.

Visual Studio Code

W Eksploratorze kliknij prawym przyciskiem myszy plik azure.yaml, a następnie wybierz pozycję Interfejs wiersza polecenia dla deweloperów platformy Azure (azd)>Usuń wdrożenie i zasoby (w dół).

Upewnij się, że chcesz usunąć środowisko, wprowadzając polecenie po wyświetleniu y monitu.

Interfejs wiersza polecenia dla deweloperów platformy Azure

Usuń zasoby platformy Azure przy użyciu następującego polecenia:

azd down --environment <environmentName>

Program Visual Studio

Usuń zasoby platformy Azure przy użyciu następującego polecenia:

azd down --environment <environmentName>

Powiązana zawartość

• Tworzenie i konfigurowanie centrum deweloperskiego
• Co to jest interfejs wiersza polecenia dla deweloperów platformy Azure?
• Instalowanie lub aktualizowanie interfejsu wiersza polecenia dla deweloperów platformy Azure