Udostępnij za pośrednictwem

Korzystanie z interfejsu wiersza polecenia dla deweloperów platformy Azure z środowiskami wdrażania platformy Azure

  • Artykuł

W tym artykule dowiesz się więcej o interfejsie wiersza polecenia dla deweloperów platformy Azure (azd) i sposobie jej działania ze środowiskami wdrażania platformy Azure (ADE) w celu aprowizowania infrastruktury aplikacji i wdrażania kodu aplikacji w nowej infrastrukturze.

Interfejs wiersza polecenia dla deweloperów platformy Azure (azd) to narzędzie wiersza polecenia typu open source, które udostępnia przyjazne dla deweloperów polecenia mapujące na kluczowe etapy przepływu pracy. Możesz zainstalować azd lokalnie na maszynie lub użyć jej w innych środowiskach.

Za pomocą programu ADE można tworzyć środowiska na podstawie definicji środowiska w katalogu dołączonym do centrum deweloperów. azdDodając element , możesz wdrożyć kod aplikacji w nowej infrastrukturze.

azd Jak działa usługa ADE?

azd współpracuje z usługą ADE, aby umożliwić tworzenie środowisk, z których pracujesz.

Dzięki programowi ADE i azdposzczególnym deweloperom pracującym z unikatową infrastrukturą i kodem, który chce przekazać do chmury, mogą utworzyć środowisko z folderu lokalnego. Mogą używać azd ich do aprowizowania środowiska i bezproblemowego wdrażania kodu.

Na dużą skalę użycie usługi ADE i azd razem umożliwia deweloperom tworzenie infrastruktury i kodu aplikacji. Twój zespół może utworzyć wiele środowisk ADE z tej samej azd zgodnej definicji środowiska i aprowizować kod do chmury w spójny sposób.

Omówienie azd szablonów

Polecenia interfejsu wiersza polecenia dla deweloperów platformy Azure są przeznaczone do pracy ze standardowymi szablonami. Każdy szablon to repozytorium kodu zgodne z określonymi konwencjami plików i folderów. Szablony zawierają zasoby azd potrzebne do aprowizowania środowiska środowiska wdrażania platformy Azure. Po uruchomieniu polecenia takiego jak azd upnarzędzie używa zasobów szablonu do wykonywania różnych kroków przepływu pracy, takich jak aprowizowanie lub wdrażanie zasobów na platformie Azure.

Poniżej przedstawiono typową strukturę szablonu:

├── infra                                        [ Contains infrastructure as code files ]
├── .azdo                                        [ Configures an Azure Pipeline ]
├── .devcontainer                                [ For DevContainer ]
├── .github                                      [ Configures a GitHub workflow ]
├── .vscode                                      [ VS Code workspace configurations ]
├── .azure                                       [ Stores Azure configurations and environment variables ]
├── src                                          [ Contains all of the deployable app source code ]
└── azure.yaml                                   [ Describes the app and type of Azure resources]

Wszystkie azd szablony obejmują następujące zasoby:

  • folder infra — folder infra nie jest używany w azd programie ADE. Zawiera on całą infrastrukturę Bicep lub Terraform jako pliki kodu dla szablonu azd. Program ADE udostępnia infrastrukturę jako pliki kodu dla szablonu azd . Nie musisz dołączać tych plików do azd szablonu.

  • plik azure.yaml — 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.

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

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

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

  • Folder .devcontainer — umożliwia skonfigurowanie środowiska kontenera deweloperskiego dla aplikacji. Jest to typowe podejście środowiska programistycznego, które nie jest specyficzne dla azd.

  • Folder .github — przechowuje pliki przepływu pracy ciągłej integracji/ciągłego wdrażania dla funkcji GitHub Actions, która jest domyślnym dostawcą ciągłej integracji/ciągłego wdrażania dla usługi azd.

  • Folder .azdo — 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.

azd zgodne wykazy

Wykazy środowisk wdrażania platformy Azure składają się z definicji środowiska: szablony IaC definiujące zasoby infrastruktury aprowidowane dla środowiska wdrażania. Interfejs wiersza polecenia dewelopera platformy Azure używa definicji środowiska w katalogu dołączonym do centrum deweloperów w celu aprowizowania nowych środowisk.

Uwaga

Obecnie interfejs wiersza polecenia dla deweloperów platformy Azure współpracuje z szablonami usługi ARM przechowywanymi w katalogu centrum deweloperów środowisk wdrażania platformy Azure.

Aby prawidłowo obsługiwać niektóre usługi Obliczeniowe platformy Azure, interfejs wiersza polecenia dla deweloperów platformy Azure wymaga dodatkowych ustawień konfiguracji w szablonie IaC. Na przykład należy oznaczyć hosty usługi App Service określonymi informacjami, aby azd wiedzieć, jak znaleźć hosty i wdrożyć aplikację w nich.

Listę obsługiwanych usług platformy Azure można znaleźć tutaj: Obsługiwane usługi obliczeniowe (host) platformy Azure.

Zgodność katalogu usługi ADE z azd

Aby umożliwić zespołom deweloperów korzystanie azd z usługi ADE, musisz utworzyć definicję środowiska w katalogu, która jest zgodna z usługą azd. Możesz utworzyć nową azdzgodną definicję środowiska lub użyć istniejącej definicji środowiska z katalogu centrum deweloperskiego środowisk wdrażania platformy Azure. Jeśli zdecydujesz się użyć istniejącej definicji środowiska, musisz wprowadzić kilka zmian w celu zapewnienia zgodności z azdprogramem .

Zmiany obejmują:

  • Jeśli modyfikujesz istniejący azd szablon, usuń infra folder. Program ADE używa następujących plików do utworzenia infrastruktury:
    • Szablon usługi ARM (azuredeploy.json).)
    • Plik konfiguracji definiujący parametry (environment.yaml lub manifest.yaml)
  • Tagowanie zasobów w pliku azure.yaml przy użyciu określonych informacji, azd aby wiedzieć, jak znaleźć hosty i wdrożyć aplikację w nich.
  • Skonfiguruj ustawienia centrum deweloperów, takie jak zmienne środowiskowe, azd konfiguracja środowiska, azd konfiguracja projektu i konfiguracja użytkownika.

Aby dowiedzieć się więcej na temat sposobu, aby definicja środowiska ADE jest zgodna z usługą azd, zobacz Make your project compatible with Azure Developer CLI (Udostępnianie projektu zgodnego z interfejsem wiersza polecenia dla deweloperów platformy Azure).

Włączanie azd obsługi w programie ADE

Aby włączyć azd obsługę przy użyciu usługi ADE, należy ustawić wartość platform.type na devcenter. Ta konfiguracja umożliwia azd korzystanie z nowych składników centrum deweloperskiego na potrzeby stanu środowiska zdalnego i aprowizacji oraz oznacza, że folder infra w szablonach będzie skutecznie ignorowany. azd Zamiast tego użyje jednego z szablonów infrastruktury zdefiniowanych w katalogu centrum deweloperów na potrzeby aprowizacji zasobów.

Aby włączyć azd obsługę, uruchom następujące polecenie:

 azd config set platform.type devcenter

Eksplorowanie azd poleceń

Po włączeniu funkcji centrum deweloperskiego domyślne zachowanie niektórych typowych poleceń azd zmienia się w celu pracy z tymi środowiskami zdalnymi. Aby uzyskać więcej informacji, zobacz Praca ze środowiskami wdrażania platformy Azure.

Powiązana zawartość