Udostępnij za pośrednictwem

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

  • Artykuł

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

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

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

Po ustawieniu platform.type na devcenterwszystkie azd stan środowiska zdalnego i aprowizacja będą korzystać z nowych składników centrum deweloperskiego. Ta konfiguracja oznacza również, że folder infra w szablonach lokalnych będzie skutecznie ignorowany. Zamiast tego azd 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 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ę

Polecenie azd up spakuje, aprowizować i wdrażać aplikację w środowiskach wdrażania platformy Azure. Jednak etap aprowizacji polecenia azd up 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 szablonie azd. Tryb centrum deweloperskiego jest włączony, azd zignoruje folder infra w lokalnym szablonie 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 wyświetlać 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 provision

Polecenie azd provision spowoduje utworzenie nowych środowisk centrum deweloperskiego. 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 zignoruje folder infra w lokalnym szablonie 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 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

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

  • 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"
        }
    }
}