Azure Developer CLI-ondersteuning voor Azure Deployment Environments

Artikel
11/16/2023

De Azure Developer CLI (azd) biedt ondersteuning voor Azure Deployment Environments. Een ADE (Azure Deployment Environment) is een vooraf geconfigureerde verzameling Azure-resources die zijn geïmplementeerd in vooraf gedefinieerde abonnementen. Azure-governance wordt toegepast op deze abonnementen op basis van het type omgeving, zoals sandbox, testen, faseren of productie. Met Azure Deployment Environments kunt u beveiligingsbeleidsregels voor ondernemingen afdwingen en een gecureerde set vooraf gedefinieerde infrastructuur als codesjablonen (IaC) bieden.

Vereisten

Controleer of u de volgende vereisten hebt voltooid om te werken met Azure Deployment Environments met behulp van azd:

Lokaal geïnstalleerd azd of toegang hebben via azd Cloud Shell
Een Azure Deployment Environment gemaakt en geconfigureerd met een ontwikkelaarscentrum, project en sjablooncatalogus
Geconfigureerde omgevingstypen op het niveau van het ontwikkelaarscentrum en op projectniveau
Zorg ervoor dat de ontwikkelaar de gebruikersrol Implementatieomgevingen in het project heeft

Tip

Het begrijpen van belangrijke concepten over Azure Deployment Environments is essentieel voor het werken met deze omgevingen via azd.

Ondersteuning voor Azure Deployment Environment inschakelen

U kunt configureren azd voor het inrichten en implementeren van resources in uw implementatieomgevingen met behulp van standaardopdrachten zoals azd up of azd provision. Voer de volgende opdracht uit om ondersteuning voor Azure Deployment Environments in te schakelen:

azd config set platform.type devcenter

Wanneer platform.type deze optie is ingesteld devcenter, maakt alle azd externe omgevingsstatus en inrichting gebruik van nieuwe onderdelen van het ontwikkelaarscentrum. Deze configuratie betekent ook dat de infra map in uw lokale sjablonen effectief wordt genegeerd. In plaats daarvan azd gebruikt u een van de infrastructuursjablonen die zijn gedefinieerd in uw ontwikkelaarscentrumcatalogus voor het inrichten van resources.

U kunt ook ondersteuning voor het ontwikkelaarscentrum uitschakelen via de volgende opdracht:

azd config unset platform

Werken met Azure Deployment Evironments

Wanneer de functie van het ontwikkelaarscentrum is ingeschakeld, verandert het standaardgedrag van enkele algemene azd opdrachten om met deze externe omgevingen te werken. De functie van het ontwikkelaarscentrum breidt de functionaliteit uit van standaard azdexterne omgevingsondersteuning.

azd init

De azd init opdrachtervaring in de ontwikkelaarscentrummodus toont alle azd compatibele ADE-sjablonen voor selectie uit uw geconfigureerde catalogus. Tijdens het init-proces, nadat azd de sjablooncode is gekloond, wordt het azure.yaml bestand automatisch bijgewerkt met een platform sectie met de geselecteerde configuratie op basis van de sjabloon die is gekozen. De configuratie bevat de naam, catalogus en omgevingsdefinitie van het ontwikkelaarscentrum.

`azd init`

azd up

Met de azd up opdracht wordt uw toepassing verpakt, ingericht en geïmplementeerd in Azure Deployment Environments. De inrichtingsfase van de azd up opdracht gebruikt echter de gecureerde sjablonen voor infrastructuur als code in uw externe ontwikkelcentrum, terwijl de implementatiefase de broncode in uw azd sjabloon implementeert. Terwijl de modus dev center is ingeschakeld, azd negeert u de infra map in uw lokale azd sjabloon en richt u alleen resources in met behulp van de sjablonen van het ontwikkelaarscentrum. Met de opdracht wordt u ook gevraagd om de benodigde waarden, zoals het Azure Deployment Environment-project of het omgevingstype.

azd up

azd template list

Met azd template list de opdracht worden de beschikbare infrastructuursjablonen in uw ontwikkelaarscentrumcatalogus weergegeven in plaats van sjablonen uit de standaardgalerie AZD Awesome weer te geven. Catalogi bieden een set gecureerde en goedgekeurde sjablonen voor infrastructuur als code die uw ontwikkelteams kunnen gebruiken om omgevingen te maken.

azd template list

A screenshot showing the updated template gallery.

azd provision

Met de azd provision opdracht worden nieuwe ontwikkelcentrumomgevingen gemaakt. Met de opdracht wordt u gevraagd om ontbrekende waarden, zoals het omgevingstype of het project. Wanneer de opdracht wordt uitgevoerd, wordt de bijbehorende infrastructuursjabloon gebruikt om de juiste set Azure-resources voor die omgeving in te richten. Terwijl de modus dev center is ingeschakeld, azd negeert u de infra map in uw lokale azd sjabloon en richt u alleen resources in met behulp van de sjablonen van het ontwikkelaarscentrum.

azd provision

azd env list

Met azd env list de opdracht wordt dezelfde lijst met omgevingen weergegeven die u in de ontwikkelaarsportal zou zien.

azd env list

Resources taggen voor Azure-implementatieomgevingen

azd inrichting voor Azure Deployment Environments is afhankelijk van gecureerde sjablonen uit de ontwikkelaarscentrumcatalogus. Sjablonen in de catalogus kunnen al dan niet tags toewijzen aan ingerichte Azure-resources, zodat u uw app-services in het azure.yaml bestand kunt koppelen. Als de sjablonen geen tags toewijzen, kunt u dit probleem op twee manieren oplossen:

Neem contact op met de catalogusbeheerder van het ontwikkelaarscentrum om ervoor te zorgen dat de ingerichte Azure-resources tags bevatten om deze te koppelen aan services die in uw azure.yaml bestand zijn gedefinieerd.

Geef het resoureName bestand op azure.yaml in plaats van tags te gebruiken:

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

Instellingen voor ontwikkelaarscentrum configureren

U kunt instellingen voor uw ontwikkelcentra op meerdere locaties definiëren azd . Instellingen worden gecombineerd vanaf deze locaties om de uiteindelijke set configuraties in de volgende volgorde van prioriteit te maken:

Omgevingsvariabelen
Azd-omgevingsconfiguratie
Projectconfiguratie
Gebruikersconfiguratie

azd wordt u automatisch gevraagd om configuratiewaarden die ontbreken in deze bronnen. Elk van deze configuratieopties wordt beschreven in de volgende secties.

Omgevingsvariabelen

De volgende omgevingsvariabelen worden gedetecteerd en gebruikt door azd:

AZURE_DEVCENTER_NAME
AZURE_DEVCENTER_PROJECT
AZURE_DEVCENTER_CATALOG
AZURE_DEVCENTER_ENVIRONMENT_DEFINITION
AZURE_DEVCENTER_ENVIRONMENT_TYPE
AZURE_DEVCENTER_ENVIRONMENT_USER

Configuraties definiëren

Definieer configuraties voor uw ontwikkelcentra binnen het azd omgevingsbereik in .azure/<env>/config.json het bestand:

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

Projectbereik

Definieer configuraties voor uw ontwikkelcentra in het azd projectbereik in het platform knooppunt van het azure.yaml bestand:

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

Gebruikersbereik

Definieer configuraties voor uw ontwikkelcentra op het gebruikersbereik in het ~/<user_profile>/.azd/config.json bestand:

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

Delen via