Een omgeving maken met behulp van de Azure Developer CLI
Artikel
In dit artikel installeert u de Azure Developer CLI (AZD), maakt u een nieuwe implementatieomgeving door uw app-infrastructuur in te richten in Azure Deployment Environments en uw app-code te implementeren in de ingerichte implementatieomgeving.
Azure Developer CLI (AZD) is een opensource-hulpprogramma dat de tijd versnelt die nodig is voordat u uw toepassing uit de lokale ontwikkelomgeving naar Azure haalt. AZD biedt best practice, ontwikkelaarsvriendelijke opdrachten die zijn toegewezen aan belangrijke fasen in uw werkstroom, ongeacht of u in de terminal, uw editor of geïntegreerde ontwikkelomgeving (IDE) of CI/CD (continue integratie/continue implementatie) werkt.
Een catalogus die is gekoppeld aan uw ontwikkelaarscentrum.
Voorbereiden op het werken met AZD
Wanneer u voor het eerst met AZD werkt, zijn er enkele eenmalige installatietaken die u moet voltooien. Deze taken omvatten het installeren van de Azure Developer CLI, het aanmelden bij uw Azure-account en het inschakelen van AZD-ondersteuning voor Azure Deployment Environments.
De Azure Developer CLI-extensie voor Visual Studio Code installeren
Wanneer u azd installeert, worden de azd-hulpprogramma's geïnstalleerd binnen azd scope in plaats van globaal en worden ze verwijderd als azd wordt verwijderd. U kunt azd installeren in Visual Studio Code of vanaf de opdrachtregel.
Als u Azure Developer CLI-functies in Visual Studio Code wilt inschakelen, installeert u de Azure Developer CLI-extensie, versie v0.8.0-alpha.1-beta.3173884. Selecteer het pictogram Extensies in de activiteitenbalk, zoek naar Azure Developer CLI en selecteer Vervolgens Installeren.
In Visual Studio 2022 17.3 Preview 2 of hoger kunt u integratie met azd inschakelen als preview-functie.
Als u de azd-functie wilt inschakelen, gaat u naar De preview-functies van Tools>Options>Environment>en selecteert u Integratie met azd, de Azure Developer CLI.
Wanneer de functie is ingeschakeld, kunt u de Azure Developer CLI gebruiken vanuit uw terminal in Windows, Linux of macOS.
Aanmelden met Azure Developer CLI
Open uw Azure-resources door u aan te melden. Wanneer u een aanmelding start, wordt er een browservenster geopend en wordt u gevraagd u aan te melden bij Azure. Nadat u zich hebt aangemeld, wordt in de terminal een bericht weergegeven dat u bent aangemeld bij Azure.
Meld u aan bij AZD met behulp van het opdrachtenpalet:
De uitvoer van opdrachten die zijn uitgegeven vanuit het opdrachtenpalet wordt weergegeven in een azd dev-terminal , zoals in het volgende voorbeeld:
Meld u aan bij Azure bij de CLI met behulp van de volgende opdracht:
azd auth login
Open uw Azure-resources door u aan te melden. Wanneer u een aanmelding start, wordt er een browservenster geopend en wordt u gevraagd u aan te melden bij Azure. Nadat u zich hebt aangemeld, wordt in de terminal een bericht weergegeven dat u bent aangemeld bij Azure.
De opdrachtprompt voor ontwikkelaars openen:
Selecteer Terminal in het menu Extra.
Selecteer in het terminalvenster de opdrachtprompt voor ontwikkelaars.
Meld u aan bij AZD met behulp van de Opdrachtterminal voor ontwikkelaars:
azd auth login
AZD-ondersteuning voor ADE 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. Wanneer platform.type deze instelling is ingesteld devcenter, maakt alle azd-externe omgevingsstatus en inrichting gebruik van onderdelen van het ontwikkelaarscentrum. AZD maakt gebruik van een van de infrastructuursjablonen die zijn gedefinieerd in uw ontwikkelaarscentrumcatalogus voor het inrichten van resources. In deze configuratie wordt de inframap in uw lokale sjablonen niet gebruikt.
U bent nu klaar om een omgeving te maken waarin u kunt werken. U kunt beginnen met code in een lokale map of u kunt een bestaande opslagplaats klonen. In dit voorbeeld maakt u een omgeving met behulp van code in een lokale map.
Een nieuwe toepassing initialiseren
Als u een nieuwe toepassing initialiseert, worden de bestanden en mappen gemaakt die nodig zijn om AZD te laten werken met uw toepassing.
AZD maakt gebruik van een azure.yaml-bestand om de omgeving te definiëren. Het bestand azure.yaml definieert en beschrijft de apps en typen Azure-resources die door de toepassing worden gebruikt. Zie het azure.yaml-schema van Azure Developer CLI voor meer informatie over azure.yaml.
Open in Visual Studio Code de map die uw toepassingscode bevat.
Open het opdrachtpalet en voer Azure Developer CLI init in en selecteer vervolgens Azure Developer CLI (azd): init.
Druk tweemaal op Enter om door te gaan zonder een sjabloon te selecteren in de lijst met sjablonen.
Selecteer code gebruiken in de AZD-terminal in de huidige map.
azd init identificeert de services die zijn gedefinieerd in uw app-code en vraagt u om te bevestigen en door te gaan, een service te verwijderen of een service toe te voegen. Selecteer Bevestigen en ga verder met het initialiseren van mijn app.
azd init blijft informatie verzamelen om uw app te configureren. Voor deze voorbeeldtoepassing wordt u gevraagd om de naam van uw MongoDB-database-exemplaar en poorten waarop de services luisteren.
Voer een naam in voor uw lokale AZD-omgeving.
azd init geeft een lijst weer van de projecten waarvoor u toegang hebt. Het project voor uw omgeving selecteren
azd init geeft een lijst weer met omgevingsdefinities in het project. Selecteer een omgevingsdefinitie.
AZD maakt de projectbronnen, inclusief een azure.yaml-bestand in de hoofdmap van uw project.
Navigeer in de CLI naar de map die uw toepassingscode bevat.
Voer de volgende opdracht uit om uw toepassing te initialiseren en informatie op te geven wanneer u hierom wordt gevraagd:
azd init
Selecteer code gebruiken in de AZD-terminal in de huidige map.
AZD scant de huidige map en verzamelt meer informatie, afhankelijk van het type app dat u bouwt. Volg de aanwijzingen om uw AZD-omgeving te configureren.
azd init identificeert de services die zijn gedefinieerd in uw app-code en vraagt u om te bevestigen en door te gaan, een service te verwijderen of een service toe te voegen. Selecteer Bevestigen en ga verder met het initialiseren van mijn app.
azd init blijft informatie verzamelen om uw app te configureren. Voor deze voorbeeldtoepassing wordt u gevraagd om de naam van uw MongoDB-database-exemplaar en poorten waarop de services luisteren.
Voer een naam in voor uw lokale AZD-omgeving.
azd init geeft een lijst weer van de projecten waarvoor u toegang hebt. Selecteer het project voor uw omgeving.
azd init geeft een lijst weer met omgevingsdefinities in het project. Selecteer een omgevingsdefinitie.
AZD maakt de projectbronnen, inclusief een azure.yaml-bestand in de hoofdmap van uw project.
Navigeer in de CLI naar de map die uw toepassingscode bevat.
Voer de volgende opdracht uit om uw toepassing te initialiseren en informatie op te geven wanneer u hierom wordt gevraagd:
azd init
Selecteer code gebruiken in de AZD-terminal in de huidige map.
AZD scant de huidige map en verzamelt meer informatie, afhankelijk van het type app dat u bouwt. Volg de aanwijzingen om uw AZD-omgeving te configureren.
azd init identificeert de services die zijn gedefinieerd in uw app-code en vraagt u om te bevestigen en door te gaan, een service te verwijderen of een service toe te voegen. Selecteer Bevestigen en ga verder met het initialiseren van mijn app.
azd init blijft informatie verzamelen om uw app te configureren. Voor deze voorbeeldtoepassing wordt u gevraagd om de naam van uw MongoDB-database-exemplaar en poorten waarop de services luisteren.
Voer een naam in voor uw lokale AZD-omgeving.
azd init geeft een lijst weer van de projecten waarvoor u toegang hebt. Selecteer het project voor uw omgeving.
azd init geeft een lijst weer met omgevingsdefinities in het project. Selecteer een omgevingsdefinitie.
AZD maakt de projectbronnen, inclusief een azure.yaml-bestand in de hoofdmap van uw project.
Infrastructuur inrichten voor azure-implementatieomgeving
Wanneer u klaar bent, kunt u uw lokale omgeving inrichten in een externe Azure Deployment Environments-omgeving in Azure. Met dit proces worden de infrastructuur en resources ingericht die zijn gedefinieerd in de omgevingsdefinitie in uw ontwikkelaarscentrumcatalogus.
Klik in Explorer met de rechtermuisknop op azure.yaml en selecteer vervolgens Azure Developer CLI (azd)>Provision Azure Resources (provision).
AZD scant Azure Deployment Environments voor projecten waartoe u toegang hebt. Selecteer of voer in de AZD-terminal de volgende gegevens in:
Project
Omgevingsdefinitie
Type omgeving
Locatie
AZD geeft ADE opdracht om een nieuwe omgeving te maken op basis van de informatie die u in de vorige stap hebt opgegeven.
U kunt de resources bekijken die zijn gemaakt in Azure Portal of in de ontwikkelaarsportal.
Richt uw toepassing in azure in met behulp van de volgende opdracht:
azd provision
'azd provision' biedt een lijst met projecten waartoe u toegang hebt. Selecteer het project waaraan u de toepassing wilt inrichten.
'azd provision' biedt een lijst met omgevingsdefinities in het geselecteerde project. Selecteer de omgevingsdefinitie die u wilt gebruiken om uw toepassing in te richten.
'azd provision' biedt een lijst met omgevingstypen in het geselecteerde project. Selecteer het omgevingstype dat u wilt gebruiken om uw toepassing in te richten.
AZD geeft ADE opdracht om een nieuwe omgeving te maken op basis van de informatie die u in de vorige stap hebt opgegeven.
U kunt de resources bekijken die zijn gemaakt in Azure Portal of in de ontwikkelaarsportal.
Richt uw toepassing in azure in met behulp van de volgende opdracht:
azd provision
'azd provision' biedt een lijst met projecten waartoe u toegang hebt. Selecteer het project waaraan u de toepassing wilt inrichten.
'azd provision' biedt een lijst met omgevingsdefinities in het geselecteerde project. Selecteer de omgevingsdefinitie die u wilt gebruiken om uw toepassing in te richten.
'azd provision' biedt een lijst met omgevingstypen in het geselecteerde project. Selecteer het omgevingstype dat u wilt gebruiken om uw toepassing in te richten.
AZD geeft ADE opdracht om een nieuwe omgeving te maken op basis van de informatie die u in de vorige stap hebt opgegeven.
U kunt de resources bekijken die zijn gemaakt in Azure Portal of in de ontwikkelaarsportal.
Bestaande omgevingen weergeven (optioneel)
Controleer of uw omgeving is gemaakt door de bestaande omgevingen te vermelden.
Klik in Explorer met de rechtermuisknop op azure.yaml en selecteer vervolgens Azure Developer CLI (azd)>View Local and Remote Environments (env list).
U wordt gevraagd om een project en een omgevingsdefinitie te selecteren.
Gebruik de volgende opdracht om de omgevingen weer te geven waartoe u toegang hebt: de lokale AZD-omgeving en de externe Azure Deployment Environments-omgeving.
azd env list
azd env list vraagt u om een project en een omgevingsdefinitie te selecteren.
Gebruik de volgende opdracht om de omgevingen weer te geven waartoe u toegang hebt: de lokale AZD-omgeving en de externe Azure Deployment Environments-omgeving.
azd env list
azd env list vraagt u om een project en een omgevingsdefinitie te selecteren.
Code implementeren in Azure Deployment Environments
Wanneer uw omgeving is ingericht, kunt u uw code implementeren in de omgeving.
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.