Azure Developer CLI-ondersteuning voor Azure Deployment Environments

Artikel
12/21/2024

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.

Voorwaarden

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

lokaal azd geïnstalleerd of toegang hebben tot azd via 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

Fooi

Inzicht in de belangrijkste concepten over Azure Deployment Environments is essentieel voor het werken met deze omgevingen via azd.

Ondersteuning voor Azure Deployment Environment inschakelen

U kunt azd configureren 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 is ingesteld op devcenter, maken 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 gebruikt azd 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-implementatieomgevingen

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

azd init

In de azd init opdrachtervaring in de ontwikkelaarscentrummodus ziet u alle azd compatibele ADE-sjablonen voor selectie uit uw geconfigureerde catalogus. Nadat azd tijdens het init-proces de sjablooncode heeft 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 opdracht azd up wordt uw toepassing in Azure Deployment Environments verpakt, ingericht en geïmplementeerd. 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 ontwikkelaarscentrummodus is ingeschakeld, negeert azd de map infra in uw lokale azd-sjabloon en richt deze 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 de opdracht azd template list worden de beschikbare infrastructuursjablonen in uw ontwikkelaarscentrumcatalogus weergegeven in plaats van sjablonen uit de standaardgalerie AZD Awesome weer te geven. Catalogs een set gecureerde en goedgekeurde sjablonen voor infrastructuur als code bieden die uw ontwikkelteams kunnen gebruiken om omgevingen te maken.

azd template list

Een schermopname met de bijgewerkte sjabloongalerie.

azd provision

Met de opdracht azd provision 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 ontwikkelaarscentrummodus is ingeschakeld, negeert azd de map infra in uw lokale azd-sjabloon en richt deze alleen resources in met behulp van de sjablonen van het ontwikkelaarscentrum.

azd provision

azd env list

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

azd env list

Resources taggen voor Azure-implementatieomgevingen

azd inrichten voor Azure Deployment Environments is afhankelijk van gecureerde sjablonen uit de catalogus van het ontwikkelaarscentrum. Sjablonen in de catalogus kunnen al dan niet tags toewijzen aan ingerichte Azure-resources, zodat u uw app-services kunt koppelen aan het azure.yaml-bestand. 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 zijn gedefinieerd in uw azure.yaml-bestand.

Geef de resourceName op in uw azure.yaml bestand 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 azd instellingen voor uw ontwikkelcentra op meerdere plaatsen definiëren. Instellingen worden gecombineerd van 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 op het azd omgevingsbereik in .azure/<env>/config.json 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 in 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