Obsługa interfejsu wiersza polecenia dla deweloperów platformy Azure dla środowisk wdrażania platformy Azure

Artykuł
11/16/2023

Interfejs wiersza polecenia dla deweloperów platformy Azure (azd) zapewnia obsługę środowisk wdrażania platformy Azure. Środowisko wdrażania platformy Azure (ADE) to wstępnie skonfigurowana kolekcja zasobów platformy Azure wdrożonych w wstępnie zdefiniowanych subskrypcjach. Zarządzanie platformą Azure jest stosowane do tych subskrypcji na podstawie typu środowiska, takiego jak piaskownica, testowanie, przemieszczanie lub produkcja. Za pomocą środowisk wdrażania platformy Azure można wymuszać zasady zabezpieczeń przedsiębiorstwa i udostępniać wyselekcjonowany zestaw wstępnie zdefiniowanych szablonów infrastruktury jako kodu (IaC).

Wymagania wstępne

Sprawdź, czy zostały spełnione następujące wymagania wstępne dotyczące pracy ze środowiskami wdrażania platformy Azure przy użyciu polecenia azd:

azd Zainstalowane lokalnie lub mają dostęp do azd usługi Cloud Shell
Utworzono i skonfigurowano środowisko wdrażania platformy Azure za pomocą centrum deweloperskiego, projektu i katalogu szablonów
Skonfigurowane typy środowisk na poziomie centrum deweloperów i projektu
Upewnij się, że deweloper ma rolę użytkownika środowiska wdrażania w projekcie

Napiwek

Zrozumienie kluczowych pojęć dotyczących środowisk wdrażania platformy Azure jest niezbędne do pracy z nimi za pośrednictwem usługi azd.

Włączanie obsługi środowiska wdrażania platformy Azure

Możesz skonfigurować azd obsługę administracyjną i wdrożyć zasoby w środowiskach wdrażania przy użyciu standardowych poleceń, takich jak azd up lub azd provision. Aby włączyć obsługę środowisk wdrażania platformy Azure, uruchom następujące polecenie:

azd config set platform.type devcenter

Gdy platform.type jest ustawiona wartość devcenter, wszystkie azd stany środowiska zdalnego i aprowizacja będą korzystać z nowych składników centrum deweloperskiego. Ta konfiguracja oznacza również, że infra folder w szablonach lokalnych 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.

Obsługę centrum deweloperów można również wyłączyć za pomocą następującego polecenia:

azd config unset platform

Praca z eksmironmentami wdrażania platformy Azure

Po włączeniu funkcji centrum deweloperskiego domyślne zachowanie niektórych typowych azd poleceń zmienia się w pracy z tymi środowiskami zdalnymi. Funkcja centrum deweloperskiego rozszerza funkcjonalność zapewnianą przez standardowe azdzdalne wsparcie środowiska.

azd init

Środowisko azd init polecenia w trybie centrum deweloperów pokazuje wszystkie szablony ADE zgodne z azd do wyboru ze skonfigurowanego wykazu. Podczas procesu inicjowania po azd sklonowania kodu szablonu azure.yaml plik zostanie automatycznie zaktualizowany w celu uwzględnienia platform sekcji z wybraną konfiguracją na podstawie wybranego szablonu. Konfiguracja obejmuje nazwę centrum deweloperskiego, katalog i definicję środowiska.

`azd init`

azd w górę

Polecenie azd up będzie pakować, aprowizować i wdrażać aplikację w środowiskach wdrażania platformy Azure. Jednak etap azd up aprowizacji polecenia będzie używać wyselekcjonowanych szablonów infrastruktury jako kodu w zdalnym centrum deweloperów, podczas gdy etap wdrażania wdroży kod źródłowy w azd szablonie. Tryb centrum deweloperskiego jest włączony, azd ale zignoruje infra folder w szablonie lokalnym azd i aprowizuje tylko zasoby przy użyciu szablonów centrum deweloperskiego. Polecenie wyświetli również monit o wszelkie niezbędne wartości, takie jak projekt środowiska wdrażania platformy Azure lub typ środowiska.

azd up

lista szablonów azd

Polecenie azd template list wyświetli dostępne szablony infrastruktury w katalogu centrum deweloperów, zamiast pokazywać szablony z domyślnej galerii AZD Awesome. Wykazy udostępniają zestaw wyselekcjonowanych i zatwierdzonych szablonów infrastruktury jako kodu, których zespoły programistyczne mogą używać do tworzenia środowisk.

azd template list

A screenshot showing the updated template gallery.

azd provision

Polecenie azd provision utworzy nowe środowiska centrum deweloperów. Polecenie wyświetli monit o brakujące wartości, takie jak typ środowiska lub projekt. Po uruchomieniu polecenia użyje skojarzonego szablonu infrastruktury, aby aprowizować prawidłowy zestaw zasobów platformy Azure dla tego środowiska. Tryb centrum deweloperskiego jest włączony, azd ale zignoruje infra folder w szablonie lokalnym azd i aprowizuje tylko zasoby przy użyciu szablonów centrum deweloperskiego.

azd provision

azd env list

Polecenie azd env list wyświetli tę samą listę środowisk, które będą widoczne w portalu deweloperów.

azd env list

Tagowanie zasobów dla środowisk wdrażania platformy Azure

azd aprowizowanie dla środowisk wdrażania platformy Azure opiera się na wyselekcjonowanych szablonach z katalogu centrum deweloperów. Szablony w wykazie mogą lub nie mogą przypisywać tagów do zaaprowizowanych zasobów platformy Azure, aby skojarzyć usługi app services z plikiem azure.yaml . Jeśli szablony nie przypisują tagów, możesz rozwiązać ten problem na jeden z dwóch sposobów:

Skontaktuj się z administratorem katalogu centrum deweloperów, aby upewnić się, że aprowizowane zasoby platformy Azure zawierają tagi umożliwiające skojarzenie ich z usługami zdefiniowanymi w azure.yaml pliku.

Określ element resoureName w azure.yaml pliku zamiast tagów:

services:
    api:
        project: ./src/api
        host: containerapp
        language: js
        resourceName: sample-api-containerapp
    web:
        project: ./src/web
        host: containerapp
        language: js
        resourceName: sample-web-containerapp

Konfigurowanie ustawień centrum deweloperskiego

Ustawienia centrów deweloperskich można zdefiniować azd w wielu miejscach. Ustawienia są łączone z tych lokalizacji w celu utworzenia końcowego zestawu konfiguracji w następującej kolejności:

Zmienne środowiskowe
Konfiguracja środowiska Azd
Konfiguracja projektu
Konfiguracja użytkownika

azd Automatycznie wyświetli monit o wszelkie brakujące wartości konfiguracji z tych źródeł. Każda z tych opcji konfiguracji jest szczegółowo opisano w poniższych sekcjach.

Zmienne środowiskowe

Następujące zmienne środowiskowe zostaną odnalezione i użyte przez azdprogram :

AZURE_DEVCENTER_NAME
AZURE_DEVCENTER_PROJECT
AZURE_DEVCENTER_CATALOG
AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
AZURE_DEVCENTER_ENVIRONMENT_TYPE
AZURE_DEVCENTER_ENVIRONMENT_USER

Definiowanie konfiguracji

Zdefiniuj konfiguracje centrów deweloperskich w azd zakresie środowiska w .azure/<env>/config.json pliku:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Zakres projektu

Zdefiniuj konfiguracje centrów deweloperskich w azd zakresie projektu w węźle platformazure.yaml pliku:

name: todo-nodejs-mongo-aca
metadata:
    template: todo-nodejs-mongo-aca@0.0.1-beta
platform:
    type: devcenter
    config:
        catalog: SampleCatalog
        environmentDefinition: Todo
        name: sample-devcenter
        project: SampleProject
services:
    api:
        project: ./src/api
        host: containerapp
        language: js
    web:
        project: ./src/web
        host: containerapp
        language: js

Zakres użytkownika

Zdefiniuj konfiguracje centrów deweloperskich w zakresie użytkownika w ~/<user_profile>/.azd/config.json pliku:

{
    "platform": {
        "config": {
            "catalog": "SampleCatalog",
            "environmentDefinition": "Todo",
            "environmentType": "Dev",
            "name": "sample-devcenter",
            "Project": "SampleProject"
        }
    }
}

Udostępnij za pośrednictwem