Azure Developer CLI-Unterstützung für Azure-Bereitstellungsumgebungen

Artikel
11/16/2023

Die Azure Developer CLI (azd) bietet Unterstützung für Azure-Bereitstellungsumgebungen. Eine Azure Deployment Environment (ADE) ist eine vorkonfigurierte Sammlung von Azure-Ressourcen, die in vordefinierten Abonnements bereitgestellt werden. Auf diese Abonnements wird Azure Governance basierend auf dem Typ der Umgebung angewendet, z. B. Sandbox, Tests, Stagingprozess oder Produktion. Mit Azure-Bereitstellungsumgebungen können Sie Unternehmenssicherheitsrichtlinien erzwingen und einen kuratierten Satz vordefinierter Infrastruktur als Codevorlagen (IaC) bereitstellen.

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Voraussetzungen für die Verwendung von azdAzure-Bereitstellungsumgebungen erfüllt haben:

Lokal installiert azd oder zugriff über azd Cloud Shell
Erstellen und Konfigurieren einer Azure-Bereitstellungsumgebung mit einem Dev Center, Projekt und Vorlagenkatalog
Konfigurierte Umgebungstypen auf Dev Center-Ebene und Projektebene
Stellen Sie sicher, dass der Entwickler über die Rolle "Deployment Environments User" im Projekt verfügt.

Tipp

Grundlegende Konzepte zu Azure-Bereitstellungsumgebungen sind für die Arbeit mit ihnen über azddiese unerlässlich.

Aktivieren der Unterstützung der Azure-Bereitstellungsumgebung

Sie können azd die Bereitstellung und Bereitstellung von Ressourcen in Ihren Bereitstellungsumgebungen mithilfe von Standardbefehlen wie azd up z. B. oder azd provision. Führen Sie den folgenden Befehl aus, um die Unterstützung für Azure-Bereitstellungsumgebungen zu aktivieren:

azd config set platform.type devcenter

Wenn platform.type diese Einstellung auf <a0/> festgelegt ist, nutzt der gesamte azd Remoteumgebungsstatus und die Bereitstellung neue Dev Center-Komponenten. Diese Konfiguration bedeutet auch, dass der infra Ordner in Ihren lokalen Vorlagen effektiv ignoriert wird. Verwenden Sie stattdessen eine der Infrastrukturvorlagen, azd die im Dev Center-Katalog für die Ressourcenbereitstellung definiert sind.

Sie können auch die Dev Center-Unterstützung über den folgenden Befehl deaktivieren:

azd config unset platform

Arbeiten mit Azure Deployment Evironments

Wenn das Dev Center-Feature aktiviert ist, ändert sich das Standardverhalten einiger gängiger azd Befehle, um mit diesen Remoteumgebungen zu arbeiten. Das Dev Center-Feature erweitert die Funktionalität, die von standardmäßigen azdRemote-Umgebung unterstützen bereitgestellt wird.

azd init

Die azd init Befehlsoberfläche im Dev Center-Modus zeigt alle azd kompatiblen ADE-Vorlagen für die Auswahl aus Ihrem konfigurierten Katalog an. Während des Init-Prozesses wird die azure.yaml Datei nach azd dem Klonen des Vorlagencodes automatisch aktualisiert, um einen platform Abschnitt mit der ausgewählten Konfiguration basierend auf der ausgewählten Vorlage einzuschließen. Die Konfiguration umfasst den Dev Center-Namen, den Katalog und die Umgebungsdefinition.

`azd init`

azd up

Mit dem azd up Befehl werden Ihre Anwendung in Azure-Bereitstellungsumgebungen verpackt, bereitgestellt und bereitgestellt. Die Bereitstellungsphase des azd up Befehls verwendet jedoch die kuratierten Infrastruktur-as-Code-Vorlagen in Ihrem Remote Dev Center, während die Bereitstellungsphase den Quellcode in Ihrer azd Vorlage bereitstellt. Während der Dev Center-Modus aktiviert ist, azd wird der infra Ordner in Ihrer lokalen azd Vorlage ignoriert und nur Ressourcen mithilfe der Dev Center-Vorlagen bereitgestellt. Der Befehl fordert Sie außerdem auf, alle erforderlichen Werte anzugeben, z. B. das Azure Deployment Environment-Projekt oder den Umgebungstyp.

azd up

Azd-Vorlagenliste

Mit dem azd template list Befehl werden die verfügbaren Infrastrukturvorlagen in Ihrem Dev Center-Katalog angezeigt, anstatt Vorlagen aus dem standardmäßigen AZD Awesome-Katalog anzuzeigen. Kataloge bieten eine Reihe kuratierter und genehmigter Infrastruktur-as-Code-Vorlagen, die Ihre Entwicklungsteams zum Erstellen von Umgebungen verwenden können.

azd template list

A screenshot showing the updated template gallery.

azd-Bereitstellung

Der azd provision Befehl erstellt neue Dev Center-Umgebungen. Der Befehl fordert Sie zur Eingabe fehlender Werte auf, z. B. den Umgebungstyp oder das Projekt. Wenn der Befehl ausgeführt wird, wird die zugeordnete Infrastrukturvorlage verwendet, um den richtigen Satz von Azure-Ressourcen für diese Umgebung bereitzustellen. Während der Dev Center-Modus aktiviert ist, azd wird der infra Ordner in Ihrer lokalen azd Vorlage ignoriert und nur Ressourcen mithilfe der Dev Center-Vorlagen bereitgestellt.

azd provision

azd env list

Der azd env list Befehl zeigt dieselbe Liste der Umgebungen an, die sie im Entwicklerportal sehen würden.

azd env list

Kategorisieren von Ressourcen für Azure-Bereitstellungsumgebungen

azd Die Bereitstellung für Azure-Bereitstellungsumgebungen basiert auf kuratierten Vorlagen aus dem Dev Center-Katalog. Vorlagen im Katalog können Tags für bereitgestellte Azure-Ressourcen zuweisen, mit deren Rahmen Sie Ihre App-Dienste in der azure.yaml Datei zuordnen können. Wenn die Vorlagen keine Tags zuweisen, können Sie dieses Problem auf eine von zwei Arten beheben:

Arbeiten Sie mit Ihrem Dev Center-Katalogadministrator zusammen, um sicherzustellen, dass die bereitgestellten Azure-Ressourcen Tags enthalten, um sie den in Ihrer azure.yaml Datei definierten Diensten zuzuordnen.

Geben Sie die resoureName Datei in Ihrer azure.yaml Datei an, anstatt Tags zu verwenden:

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

Konfigurieren von Dev Center-Einstellungen

Sie können Einstellungen für Ihre Dev Center an mehreren Stellen definieren azd . Einstellungen werden von diesen Speicherorten kombiniert, um den endgültigen Satz von Konfigurationen in der folgenden Reihenfolge der Rangfolge zu erstellen:

Umgebungsvariablen
Azd-Umgebungskonfiguration
Projektkonfiguration
Benutzerkonfiguration

azd fordert Sie automatisch auf, alle Konfigurationswerte anzugeben, die aus diesen Quellen fehlen. Jede dieser Konfigurationsoptionen ist in den folgenden Abschnitten beschrieben.

Umgebungsvariablen

Die folgenden Umgebungsvariablen werden ermittelt und verwendet von azd:

AZURE_DEVCENTER_NAME
AZURE_DEVCENTER_PROJECT
AZURE_DEVCENTER_CATALOG
AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
AZURE_DEVCENTER_ENVIRONMENT_TYPE
AZURE_DEVCENTER_ENVIRONMENT_USER

Definieren von Konfigurationen

Definieren Sie Konfigurationen für Ihre Dev Center im Umgebungsbereich in .azure/<env>/config.json der azd Datei:

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

Projektumfang

Definieren Sie Konfigurationen für Ihre Dev Center im azd Projektbereich im platform Knoten der azure.yaml Datei:

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

Benutzerbereich

Definieren Sie Konfigurationen für Ihre Dev Center im Benutzerbereich in der ~/<user_profile>/.azd/config.json Datei:

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

Freigeben über