Udostępnij przez

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

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

Warunki wstępne

Aby pracować ze środowiskami wdrażania platformy Azure przy użyciu programu azd, sprawdź, czy zostały spełnione następujące wymagania wstępne:

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

Można skonfigurować azd, aby aprowizować i wdrażać 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 korzystają z nowych składników centrum deweloperskiego. Ta konfiguracja oznacza również, że infra folder w szablonach lokalnych jest ignorowany. azd Zamiast tego używa 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 ze środowiskami wdrażania platformy Azure

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

azd init

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

azd init

azd w górę

Pakiet azd up poleceń, aprowizuje i wdraża aplikację w środowiskach wdrażania platformy Azure. Jednak etap azd up aprowizacji polecenia używa wyselekcjonowanych szablonów infrastruktury jako kodu w zdalnym centrum deweloperów, podczas gdy etap wdrażania wdraża kod źródłowy w azd szablonie. Tryb centrum deweloperskiego jest włączony, azd ignoruje infra folder w szablonie lokalnym azd i aprowizuje tylko zasoby przy użyciu szablonów centrum deweloperów. 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świetla dostępne szablony infrastruktury w katalogu centrum deweloperów, zamiast pokazywać szablony z domyślnej galerii AZD Awesome. Catalogs 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

Zrzut ekranu przedstawiający zaktualizowaną galerię szablonów.

azd świadczenie

Polecenie azd provision tworzy nowe środowiska centrum deweloperskiego. Polecenie wyświetla monit o brakujące wartości, takie jak typ środowiska lub projekt. Po uruchomieniu polecenia używa skojarzonego szablonu infrastruktury do aprowizowania poprawnego zestawu zasobów platformy Azure dla tego środowiska. Tryb centrum deweloperskiego jest włączony, azd ignoruje infra folder w szablonie lokalnym azd i aprowizuje tylko zasoby przy użyciu szablonów centrum deweloperów.

azd provision

azd env list

Polecenie azd env list wyświetla tę samą listę środowisk, które można zobaczyć w portalu deweloperów.

azd env list

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

azd aprowizacja środowisk wdrażania platformy Azure opiera się na wyselekcjonowanych szablonach z katalogu centrum deweloperów. Szablony w katalogu 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 pliku azure.yaml.

  • Określ resourceName w pliku azure.yaml 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 azd dla centrów deweloperskich można zdefiniować w wielu miejscach. Ustawienia są łączone z tych lokalizacji w celu utworzenia końcowego zestawu konfiguracji w następującej kolejności:

  1. Zmienne środowiskowe
  2. Konfiguracja środowiska Azd
  3. Konfiguracja projektu
  4. 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

azd odnajduje i używa następujących zmiennych środowiskowych:

  • 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 zakresie środowiska azd w pliku .azure/<env>/config.json:

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

Zakres projektu

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

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 pliku ~/<user_profile>/.azd/config.json:

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