Skapa en miljö med hjälp av Azure Developer CLI

I den här artikeln installerar du Azure Developer CLI (AZD), skapar en ny distributionsmiljö genom att etablera din appinfrastruktur till Azure Deployment Environments och distribuera din appkod till den etablerade distributionsmiljön.

Azure Developer CLI (AZD) är ett verktyg med öppen källkod som påskyndar den tid det tar för dig att hämta ditt program från den lokala utvecklingsmiljön till Azure. AZD tillhandahåller bästa praxis, utvecklarvänliga kommandon som mappar till viktiga steg i arbetsflödet, oavsett om du arbetar i terminalen, redigeraren eller den integrerade utvecklingsmiljön (IDE) eller CI/CD (kontinuerlig integrering/kontinuerlig distribution).

Mer information om hur du konfigurerar AZD för att arbeta med Azure Deployment Environments finns i Använda Azure Developer CLI med Azure Deployment Environments.

Förutsättningar

Du bör:

• Bekanta dig med Azure Deployment Environments. Läs Vad är Azure-distributionsmiljöer? och viktiga begrepp för Azure-distributionsmiljöer.
• Skapa och konfigurera ett utvecklingscenter med ett projekt, miljötyper och en katalog. Använd följande artikel som vägledning:
  • Snabbstart: Skapa och konfigurera ett utvecklingscenter för Azure-distributionsmiljöer.
• En katalog som är kopplad till utvecklingscentret.

Förbereda för att arbeta med AZD

När du arbetar med AZD för första gången finns det några engångskonfigurationsuppgifter som du behöver utföra. Dessa uppgifter omfattar installation av Azure Developer CLI, inloggning till ditt Azure-konto och aktivering av AZD-stöd för Azure-distributionsmiljöer.

Installera Azure Developer CLI-tillägget för Visual Studio Code

När du installerar azd installeras azd-verktygen inom azd-omfånget i stället för globalt och tas bort om azd avinstalleras. Du kan installera azd i Visual Studio Code eller från kommandoraden.

Visual Studio Code

Om du vill aktivera Azure Developer CLI-funktioner i Visual Studio Code installerar du Azure Developer CLI-tillägget version v0.8.0-alpha.1-beta.3173884. Välj ikonen Tillägg i aktivitetsfältet, sök efter Azure Developer CLI och välj sedan Installera.

Azure Developer CLI

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

Visual Studio

I Visual Studio 2022 17.3 Förhandsversion 2 eller senare kan du aktivera integrering med azd som en förhandsversionsfunktion.

Om du vill aktivera azd-funktionen går du till Verktygsalternativ>>Miljöförhandsgranskningsfunktioner> och väljer Integrering med azd, Azure Developer CLI.

När funktionen är aktiverad kan du använda Azure Developer CLI från valfri terminal i Windows, Linux eller macOS.

Logga in med Azure Developer CLI

Få åtkomst till dina Azure-resurser genom att logga in. När du initierar en inloggning öppnas ett webbläsarfönster och du uppmanas att logga in på Azure. När du har loggat in visar terminalen ett meddelande om att du är inloggad i Azure.

Logga in på AZD med hjälp av kommandopaletten:

Visual Studio Code

Utdata från kommandon som utfärdats från kommandopaletten visas i en azd dev-terminal som i följande exempel:

Azure Developer CLI

Logga in på Azure i CLI med följande kommando:

 azd auth login

Visual Studio

Få åtkomst till dina Azure-resurser genom att logga in. När du initierar en inloggning öppnas ett webbläsarfönster och du uppmanas att logga in på Azure. När du har loggat in visar terminalen ett meddelande om att du är inloggad i Azure.

Så här öppnar du kommandotolken För utvecklare:

1. På menyn Verktyg väljer du Terminal.

2. I terminalfönstretväljer du Kommandotolk för utvecklare.

   

Logga in på AZD med hjälp av utvecklarkommandoterminalen:

 azd auth login

Aktivera AZD-stöd för ADE

Du kan konfigurera AZD för att etablera och distribuera resurser till dina distributionsmiljöer med hjälp av standardkommandon som azd up eller azd provision. När platform.type är inställt på devcenteranvänder alla AZD-fjärrmiljötillstånd och all etablering dev center-komponenter. AZD använder en av de infrastrukturmallar som definierats i utvecklingscentrets katalog för resursetablering. I den här konfigurationen används inte infra-mappen i dina lokala mallar.

Visual Studio Code

Azure Developer CLI

 azd config set platform.type devcenter

Visual Studio

 azd config set platform.type devcenter

Skapa en miljö från befintlig kod

Nu är du redo att skapa en miljö att arbeta i. Du kan börja med kod i en lokal mapp eller klona en befintlig lagringsplats. I det här exemplet skapar du en miljö med hjälp av kod i en lokal mapp.

Initiera ett nytt program

När du initierar ett nytt program skapas de filer och mappar som krävs för att AZD ska fungera med ditt program.

AZD använder en azure.yaml-fil för att definiera miljön. Filen azure.yaml definierar och beskriver de appar och typer av Azure-resurser som programmet använder. Mer information om azure.yaml finns i Azure Developer CLI:s azure.yaml-schema.

Visual Studio Code

1. Öppna mappen som innehåller programkoden i Visual Studio Code.

2. Öppna kommandopaletten och ange Azure Developer CLI-init och välj sedan Azure Developer CLI (azd): init i listan.

   

3. Tryck på RETUR två gånger om du vill fortsätta utan att välja en mall i listan över mallar.

4. I AZD-terminalen väljer du Använd kod i den aktuella katalogen.

   

5. azd init identifierar de tjänster som definierats i din appkod och uppmanar dig att bekräfta och fortsätta, ta bort en tjänst eller lägga till en tjänst. Välj Bekräfta och fortsätt initiera min app.

   

6. azd init fortsätter att samla in information för att konfigurera din app. I det här exempelprogrammet uppmanas du att ange namnet på mongoDB-databasinstansen och portar som tjänsterna lyssnar på.

   

7. Ange ett namn för din lokala AZD-miljö.

   

8. azd init visar en lista över de projekt som du har åtkomst till. Välj projektet för din miljö

   

9. azd init visar en lista över miljödefinitioner i projektet. Välj en miljödefinition.

   

   AZD skapar projektresurserna, inklusive en azure.yaml-fil i roten för projektet.

Azure Developer CLI

1. I CLI navigerar du till mappen som innehåller programkoden.

2. Kör följande kommando för att initiera programmet och ange information när du uppmanas att göra det:

   azd init
   

3. I AZD-terminalen väljer du Använd kod i den aktuella katalogen.

   

   AZD söker igenom den aktuella katalogen och samlar in mer information beroende på vilken typ av app du skapar. Följ anvisningarna för att konfigurera AZD-miljön.

4. azd init identifierar de tjänster som definierats i din appkod och uppmanar dig att bekräfta och fortsätta, ta bort en tjänst eller lägga till en tjänst. Välj Bekräfta och fortsätt initiera min app.

   

5. azd init fortsätter att samla in information för att konfigurera din app. I det här exempelprogrammet uppmanas du att ange namnet på mongoDB-databasinstansen och portar som tjänsterna lyssnar på.

   

6. Ange ett namn för din lokala AZD-miljö.

   

7. azd init visar en lista över de projekt som du har åtkomst till. Välj projektet för din miljö.

   

8. azd init visar en lista över miljödefinitioner i projektet. Välj en miljödefinition.

   

   AZD skapar projektresurserna, inklusive en azure.yaml-fil i roten för projektet.

Visual Studio

1. I CLI navigerar du till mappen som innehåller programkoden.

2. Kör följande kommando för att initiera programmet och ange information när du uppmanas att göra det:

   azd init
   

3. I AZD-terminalen väljer du Använd kod i den aktuella katalogen.

   

   AZD söker igenom den aktuella katalogen och samlar in mer information beroende på vilken typ av app du skapar. Följ anvisningarna för att konfigurera AZD-miljön.

4. azd init identifierar de tjänster som definierats i din appkod och uppmanar dig att bekräfta och fortsätta, ta bort en tjänst eller lägga till en tjänst. Välj Bekräfta och fortsätt initiera min app.

   

5. azd init fortsätter att samla in information för att konfigurera din app. I det här exempelprogrammet uppmanas du att ange namnet på mongoDB-databasinstansen och portar som tjänsterna lyssnar på.

   

6. Ange ett namn för din lokala AZD-miljö.

   

7. azd init visar en lista över de projekt som du har åtkomst till. Välj projektet för din miljö.

   

8. azd init visar en lista över miljödefinitioner i projektet. Välj en miljödefinition.

   AZD skapar projektresurserna, inklusive en azure.yaml-fil i roten för projektet.

Etablera infrastruktur till Azure Deployment Environment

När du är klar kan du etablera din lokala miljö till en fjärransluten Azure Deployment Environments-miljö i Azure. Den här processen etablerar infrastrukturen och resurserna som definierats i miljödefinitionen i utvecklingscentrets katalog.

Visual Studio Code

1. Högerklicka på azure.yaml i Utforskaren och välj sedan Azure Developer CLI (azd)>Etablera Azure-resurser (etablering).

   

2. AZD söker igenom Azure Deployment Environments efter projekt som du har åtkomst till. I AZD-terminalen väljer eller anger du följande information:

   1. Project
   2. Miljödefinition
   3. Miljötyp
   4. Plats

3. AZD instruerar ADE att skapa en ny miljö baserat på den information du gav i föregående steg.

4. Du kan visa de resurser som skapats i Azure-portalen eller i utvecklarportalen.

Azure Developer CLI

Etablera ditt program till Azure med följande kommando:

azd provision

1. "azd provision" innehåller en lista över projekt som du har åtkomst till. Välj det projekt som du vill etablera programmet till.

   

2. "azd provision" innehåller en lista över miljödefinitioner i det valda projektet. Välj den miljödefinition som du vill använda för att etablera ditt program.

   

3. "azd provision" innehåller en lista över miljötyper i det valda projektet. Välj den miljötyp som du vill använda för att etablera ditt program.

   

4. AZD instruerar ADE att skapa en ny miljö baserat på den information du gav i föregående steg.

   

5. Du kan visa de resurser som skapats i Azure-portalen eller i utvecklarportalen.

Visual Studio

Etablera ditt program till Azure med följande kommando:

azd provision

1. "azd provision" innehåller en lista över projekt som du har åtkomst till. Välj det projekt som du vill etablera programmet till.

   

2. "azd provision" innehåller en lista över miljödefinitioner i det valda projektet. Välj den miljödefinition som du vill använda för att etablera ditt program.

   

3. "azd provision" innehåller en lista över miljötyper i det valda projektet. Välj den miljötyp som du vill använda för att etablera ditt program.

4. AZD instruerar ADE att skapa en ny miljö baserat på den information du gav i föregående steg.

5. Du kan visa de resurser som skapats i Azure-portalen eller i utvecklarportalen.

Visa en lista över befintliga miljöer (valfritt)

Kontrollera att din miljö har skapats genom att visa en lista över befintliga miljöer.

Visual Studio Code

1. Högerklicka på azure.yaml i Utforskaren och välj sedan Azure Developer CLI (azd)>View Local and Remote Environments (env list).

   

   Du uppmanas att välja ett projekt och en miljödefinition.

Azure Developer CLI

Använd följande kommando för att visa de miljöer som du har åtkomst till: den lokala AZD-miljön och den fjärranslutna Azure Deployment Environments-miljön.

azd env list

azd env list uppmanar dig att välja ett projekt och en miljödefinition.

Visual Studio

Använd följande kommando för att visa de miljöer som du har åtkomst till: den lokala AZD-miljön och den fjärranslutna Azure Deployment Environments-miljön.

azd env list

azd env list uppmanar dig att välja ett projekt och en miljödefinition.

Distribuera kod till Azure-distributionsmiljöer

När din miljö har etablerats kan du distribuera koden till miljön.

Visual Studio Code

1. Högerklicka på azure.yaml i Utforskaren och välj sedan Azure Developer CLI (azd)>Deploy Azure Resources (deploy).

   

2. Du kan kontrollera att koden har distribuerats genom att välja slutpunkts-URL:er som anges i AZD-terminalen.

Azure Developer CLI

Distribuera programkoden till den fjärranslutna Azure Deployment Environments-miljön som du etablerade med hjälp av följande kommando:

azd deploy

Det kan ta flera minuter att distribuera koden till fjärrmiljön.

Du kan visa förloppet för distributionen i Azure-portalen:

När distributionen är klar kan du visa de resurser som har etablerats i Azure-portalen:

Du kan kontrollera att koden har distribuerats genom att välja slutpunkts-URL:er som anges i AZD-terminalen.

För det här exempelprogrammet ser du ungefär så här:

Visual Studio

Distribuera programkoden till den fjärranslutna Azure Deployment Environments-miljön som du etablerade med hjälp av följande kommando:

azd deploy

Det kan ta flera minuter att distribuera koden till fjärrmiljön.

Du kan visa förloppet för distributionen i Azure-portalen:

När distributionen är klar kan du visa de resurser som har etablerats i Azure-portalen:

Du kan kontrollera att koden har distribuerats genom att välja slutpunkts-URL:er som anges i AZD-terminalen.

Rensa resurser

När du är klar med din miljö kan du ta bort Azure-resurserna.

Visual Studio Code

I Utforskaren högerklickar du på azure.yaml och väljer sedan Azure Developer CLI (azd)>Delete Deployment and Resources (down).

Bekräfta att du vill ta bort miljön genom att ange y när du uppmanas att göra det.

Azure Developer CLI

Ta bort dina Azure-resurser med hjälp av följande kommando:

azd down --environment <environmentName>

Visual Studio

Ta bort dina Azure-resurser med hjälp av följande kommando:

azd down --environment <environmentName>

Relaterat innehåll

• Skapa och konfigurera ett utvecklingscenter
• Vad är Azure Developer CLI?
• Installera eller uppdatera Azure Developer CLI