Een omgeving maken met behulp van de Azure Developer CLI

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.

Zie Azure Developer CLI gebruiken met Azure Deployment Environments voor meer informatie over het instellen van AZD voor gebruik met Azure Deployment Environments.

Vereisten

U moet het volgende doen:

• Vertrouwd zijn met Azure Deployment Environments. Bekijk wat zijn Azure-implementatieomgevingen? en belangrijke concepten voor Azure-implementatieomgevingen.
• Maak en configureer een ontwikkelaarscentrum met een project, omgevingstypen en een catalogus. Gebruik het volgende artikel als richtlijn:
  • Quickstart: Een ontwikkelaarscentrum maken en configureren voor Azure Deployment Environments.
• 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.

Visual Studio Code

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.

Azure Developer CLI

powershell -ex AllSigned -c "Invoke-RestMethod 'https://aka.ms/install-azd.ps1' | Invoke-Expression"

Visual Studio

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:

Visual Studio Code

De uitvoer van opdrachten die zijn uitgegeven vanuit het opdrachtenpalet wordt weergegeven in een azd dev-terminal , zoals in het volgende voorbeeld:

Azure Developer CLI

Meld u aan bij Azure bij de CLI met behulp van de volgende opdracht:

 azd auth login

Visual Studio

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:

1. Selecteer Terminal in het menu Extra.

2. 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.

Visual Studio Code

Azure Developer CLI

 azd config set platform.type devcenter

Visual Studio

 azd config set platform.type devcenter

Een omgeving maken op afstand van bestaande code

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.

Visual Studio Code

1. Open in Visual Studio Code de map die uw toepassingscode bevat.

2. Open het opdrachtpalet en voer Azure Developer CLI init in en selecteer vervolgens Azure Developer CLI (azd): init.

   

3. Druk tweemaal op Enter om door te gaan zonder een sjabloon te selecteren in de lijst met sjablonen.

4. Selecteer code gebruiken in de AZD-terminal in de huidige map.

   

5. 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.

   

6. 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.

   

7. Voer een naam in voor uw lokale AZD-omgeving.

   

8. azd init geeft een lijst weer van de projecten waarvoor u toegang hebt. Het project voor uw omgeving selecteren

   

9. 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.

Azure Developer CLI

1. Navigeer in de CLI naar de map die uw toepassingscode bevat.

2. Voer de volgende opdracht uit om uw toepassing te initialiseren en informatie op te geven wanneer u hierom wordt gevraagd:

   azd init
   

3. 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.

4. 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.

   

5. 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.

   

6. Voer een naam in voor uw lokale AZD-omgeving.

   

7. azd init geeft een lijst weer van de projecten waarvoor u toegang hebt. Selecteer het project voor uw omgeving.

   

8. 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.

Visual Studio

1. Navigeer in de CLI naar de map die uw toepassingscode bevat.

2. Voer de volgende opdracht uit om uw toepassing te initialiseren en informatie op te geven wanneer u hierom wordt gevraagd:

   azd init
   

3. 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.

4. 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.

   

5. 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.

   

6. Voer een naam in voor uw lokale AZD-omgeving.

   

7. azd init geeft een lijst weer van de projecten waarvoor u toegang hebt. Selecteer het project voor uw omgeving.

   

8. 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.

Visual Studio Code

1. Klik in Explorer met de rechtermuisknop op azure.yaml en selecteer vervolgens Azure Developer CLI (azd)>Provision Azure Resources (provision).

   

2. AZD scant Azure Deployment Environments voor projecten waartoe u toegang hebt. Selecteer of voer in de AZD-terminal de volgende gegevens in:

   1. Project
   2. Omgevingsdefinitie
   3. Type omgeving
   4. Locatie

3. AZD geeft ADE opdracht om een nieuwe omgeving te maken op basis van de informatie die u in de vorige stap hebt opgegeven.

4. U kunt de resources bekijken die zijn gemaakt in Azure Portal of in de ontwikkelaarsportal.

Azure Developer CLI

Richt uw toepassing in azure in met behulp van de volgende opdracht:

azd provision

1. 'azd provision' biedt een lijst met projecten waartoe u toegang hebt. Selecteer het project waaraan u de toepassing wilt inrichten.

   

2. 'azd provision' biedt een lijst met omgevingsdefinities in het geselecteerde project. Selecteer de omgevingsdefinitie die u wilt gebruiken om uw toepassing in te richten.

   

3. 'azd provision' biedt een lijst met omgevingstypen in het geselecteerde project. Selecteer het omgevingstype dat u wilt gebruiken om uw toepassing in te richten.

   

4. AZD geeft ADE opdracht om een nieuwe omgeving te maken op basis van de informatie die u in de vorige stap hebt opgegeven.

   

5. U kunt de resources bekijken die zijn gemaakt in Azure Portal of in de ontwikkelaarsportal.

Visual Studio

Richt uw toepassing in azure in met behulp van de volgende opdracht:

azd provision

1. 'azd provision' biedt een lijst met projecten waartoe u toegang hebt. Selecteer het project waaraan u de toepassing wilt inrichten.

   

2. 'azd provision' biedt een lijst met omgevingsdefinities in het geselecteerde project. Selecteer de omgevingsdefinitie die u wilt gebruiken om uw toepassing in te richten.

   

3. 'azd provision' biedt een lijst met omgevingstypen in het geselecteerde project. Selecteer het omgevingstype dat u wilt gebruiken om uw toepassing in te richten.

4. AZD geeft ADE opdracht om een nieuwe omgeving te maken op basis van de informatie die u in de vorige stap hebt opgegeven.

5. 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.

Visual Studio Code

1. 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.

Azure Developer CLI

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.

Visual Studio

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.

Visual Studio Code

1. Klik in Explorer met de rechtermuisknop op azure.yaml en selecteer vervolgens Azure Developer CLI (azd)>Azure-resources implementeren (implementeren).

   

2. U kunt controleren of uw code is geïmplementeerd door de eindpunt-URL's te selecteren die worden vermeld in de AZD-terminal.

Azure Developer CLI

Implementeer uw toepassingscode in de externe Azure Deployment Environments-omgeving die u hebt ingericht met behulp van de volgende opdracht:

azd deploy

Het implementeren van uw code in de externe omgeving kan enkele minuten duren.

U kunt de voortgang van de implementatie bekijken in Azure Portal:

Wanneer de implementatie is voltooid, kunt u de resources bekijken die zijn ingericht in Azure Portal:

U kunt controleren of uw code is geïmplementeerd door de eindpunt-URL's te selecteren die worden vermeld in de AZD-terminal.

Voor deze voorbeeldtoepassing ziet u ongeveer als volgt:

Visual Studio

Implementeer uw toepassingscode in de externe Azure Deployment Environments-omgeving die u hebt ingericht met behulp van de volgende opdracht:

azd deploy

Het implementeren van uw code in de externe omgeving kan enkele minuten duren.

U kunt de voortgang van de implementatie bekijken in Azure Portal:

Wanneer de implementatie is voltooid, kunt u de resources bekijken die zijn ingericht in Azure Portal:

U kunt controleren of uw code is geïmplementeerd door de eindpunt-URL's te selecteren die worden vermeld in de AZD-terminal.

Resources opschonen

Wanneer u klaar bent met uw omgeving, kunt u de Azure-resources verwijderen.

Visual Studio Code

Klik in Explorer met de rechtermuisknop op azure.yaml en selecteer vervolgens Azure Developer CLI (azd)>Delete Deployment and Resources (omlaag).

Bevestig dat u de omgeving wilt verwijderen door desgevraagd in te voeren y .

Azure Developer CLI

Verwijder uw Azure-resources met behulp van de volgende opdracht:

azd down --environment <environmentName>

Visual Studio

Verwijder uw Azure-resources met behulp van de volgende opdracht:

azd down --environment <environmentName>

Gerelateerde inhoud

• Een ontwikkelaarscentrum maken en configureren
• Wat is de Azure Developer CLI?
• De Azure Developer CLI installeren of bijwerken