Podpora Azure Developer CLI pro prostředí nasazení Azure

Článek
12/21/2024

Azure Developer CLI (azd) poskytuje podporu pro prostředí nasazení Azure. Prostředí nasazení Azure (ADE) je předem nakonfigurovaná kolekce prostředků Azure nasazených v předdefinovaných předplatných. Zásady správného řízení Azure se použijí na tato předplatná na základě typu prostředí, jako je sandbox, testování, příprava nebo produkční prostředí. V prostředích nasazení Azure můžete vynutit podnikové zásady zabezpečení a poskytnout kurátorovanou sadu předdefinovaných šablon infrastruktury jako kódu (IaC).

Požadavky

Ověřte, že jste dokončili následující požadavky pro práci s prostředími nasazení Azure pomocí azd:

nainstalované azd místně nebo mít přístup k azd přes Cloud Shell
Vytvoření a konfigurace prostředí nasazení Azure s katalogem dev center, projektu a šablon
Nakonfigurované typy prostředí na úrovni centra pro vývoj a na úrovni projektu
Ujistěte se, že vývojář má v projektu roli uživatele prostředí nasazení.

Spropitné

pochopení klíčových konceptů o prostředích nasazení Azure je nezbytné pro práci s nimi prostřednictvím azd.

Povolení podpory prostředí nasazení Azure

Pomocí standardních příkazů, jako jsou azd up nebo azd provision, můžete nakonfigurovat azd pro zřizování a nasazování prostředků do prostředí nasazení. Pokud chcete povolit podporu pro prostředí nasazení Azure, spusťte následující příkaz:

azd config set platform.type devcenter

Když je platform.type nastavená na devcenter, budou všechny azd stavu vzdáleného prostředí a zřizování využívat nové komponenty dev Center. Tato konfigurace také znamená, že složka infra v místních šablonách se bude efektivně ignorovat. Místo toho azd použije jednu ze šablon infrastruktury definovaných v katalogu dev Center pro zřizování prostředků.

Podporu dev center můžete také zakázat pomocí následujícího příkazu:

azd config unset platform

Práce s prostředími nasazení Azure

Když je funkce dev Center povolená, změní se výchozí chování některých běžných příkazů azd, aby fungovaly s těmito vzdálenými prostředími. Funkce dev center rozšiřuje funkce poskytované standardní azdpodporou vzdáleného prostředí.

azd init

Prostředí příkazů azd init v režimu dev Center zobrazuje všechny šablony ADE kompatibilní s ADE azd pro výběr z nakonfigurovaného katalogu. Během procesu inicializaci se po azd naklonování kódu šablony automaticky aktualizuje soubor azure.yaml tak, aby zahrnoval oddíl platform s vybranou konfigurací na základě zvolené šablony. Konfigurace zahrnuje název vývojového centra, katalog a definici prostředí.

azd init

azd nahoru

Příkaz azd up zabalí, zřídí a nasadí vaši aplikaci do prostředí nasazení Azure. Fáze zřizování příkazu azd up ale bude používat kurátorované šablony infrastruktury jako kódu ve vzdáleném vývojovém centru, zatímco fáze nasazení nasadí zdrojový kód do šablony azd. I když je režim dev center povolený, azd bude ignorovat složku infra v místní šabloně azd a zřizovat prostředky jenom pomocí šablon dev center. Příkaz vás také vyzve k zadání potřebných hodnot, jako je projekt prostředí nasazení Azure nebo typ prostředí.

azd up

seznam šablon azd

Příkaz azd template list zobrazí dostupné šablony infrastruktury v katalogu vývojového centra místo zobrazení šablon z výchozí galerie AZD Awesome. katalogy poskytují sadu kurátorovaných a schválených šablon infrastruktury jako kódu, které můžou vývojové týmy používat k vytváření prostředí.

azd template list

snímek obrazovky zobrazující aktualizovanou galerii šablon

zřízení azd

Příkaz azd provision vytvoří nová prostředí vývojového centra. Příkaz vás vyzve k zadání chybějících hodnot, například typu prostředí nebo projektu. Když se příkaz spustí, použije přidruženou šablonu infrastruktury ke zřízení správné sady prostředků Azure pro dané prostředí. I když je režim dev center povolený, azd bude ignorovat složku infra v místní šabloně azd a zřizovat prostředky jenom pomocí šablon dev center.

azd provision

azd env list

Příkaz azd env list zobrazí stejný seznam prostředí, která byste viděli na portálu pro vývojáře.

azd env list

Označování prostředků pro prostředí nasazení Azure

azd zřizování pro prostředí nasazení Azure spoléhá na kurátorované šablony z katalogu dev center. Šablony v katalogu můžou nebo nemusí přiřazovat značky zřízeným prostředkům Azure, aby se vaše aplikační služby přidružily v souboru azure.yaml. Pokud šablony nepřiřazují značky, můžete tento problém vyřešit jedním ze dvou způsobů:

Spolupracujte se správcem katalogu dev Center a ujistěte se, že zřízené prostředky Azure obsahují značky, které je přidruží ke službám definovaným ve vašem souboru azure.yaml.

Místo značek v souboru azure.yaml zadejte resourceName:

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

Konfigurace nastavení dev center

Můžete definovat nastavení azd pro vývojová centra na několika místech. Nastavení se z těchto umístění zkombinují a vytvoří konečnou sadu konfigurací v následujícím pořadí priorit:

Proměnné prostředí
Konfigurace prostředí Azd
Konfigurace projektu
Konfigurace uživatele

azd vás automaticky vyzve k zadání všech hodnot konfigurace, které v těchto zdrojích chybí. Každá z těchto možností konfigurace je podrobně popsána v následujících částech.

Proměnné prostředí

Následující proměnné prostředí budou zjištěny a používány azd:

AZURE_DEVCENTER_NAME
AZURE_DEVCENTER_PROJECT
AZURE_DEVCENTER_CATALOG
AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
AZURE_DEVCENTER_ENVIRONMENT_TYPE
AZURE_DEVCENTER_ENVIRONMENT_USER

Definování konfigurací

Definujte konfigurace pro vývojová centra v oboru prostředí azd v souboru .azure/<env>/config.json:

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

Rozsah projektu

Definujte konfigurace pro vývojové centra v oboru projektu azd v platform uzlu souboru 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

Obor uživatele

Definujte konfigurace pro vývojová centra v oboru uživatele v souboru ~/<user_profile>/.azd/config.json:

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

Sdílet prostřednictvím