Snabbstart: Distribuera en CLI-mall för Azure Developer

En lokal utvecklingsmiljö är ett bra val för traditionella arbetsflöden för utveckling. Du klonar malllagringsplatsen på enheten och kör kommandon mot en lokal installation av azd.

Förutsättningar

Initiera projektet

1. I Utforskaren eller en terminal skapar du en ny tom katalog och ändrar till den.

2. azd init Kör kommandot och ange den mall som du vill använda som parameter:

   azd init --template todo-nodejs-mongo
   

   azd init --template todo-python-mongo
   

   azd init --template todo-csharp-cosmos-sql
   

   azd init --template todo-java-mongo-aca
   

   Ange ett miljönamn när du uppmanas att göra det, till exempel azdquickstart, som anger ett namngivningsprefix för resursgruppen som ska skapas för att lagra Azure resurser. Vad är ett miljönamn i azd?

   När du har angett miljön azd klonar du mallprojektet till datorn och initierar projektet.

Etablera och distribuera appresurserna

1. azd auth login Kör kommandot och azd startar en webbläsare så att du kan slutföra inloggningsprocessen.

   azd auth login
   

2. azd up Kör kommandot:

   azd up
   

3. När du har loggat in på Azure uppmanas du att ange följande information:

   Parameter	Beskrivning
   Azure Location	Den Azure plats där dina resurser ska distribueras.
   Azure Subscription	Den Azure prenumeration där dina resurser ska distribueras.

   Välj önskade värden och tryck på Retur. Kommandot azd up hanterar följande uppgifter för dig med hjälp av mallkonfigurations- och infrastrukturfilerna:

   • Skapar och konfigurerar alla nödvändiga Azure resurser (azd provision), inklusive:
   • Åtkomstprinciper och roller för ditt konto
   • Tjänst-till-tjänst-kommunikation med hanterade identiteter
   • Paketerar och distribuerar koden (azd deploy)

   azd up När kommandot har slutförts visar CLI två länkar för att visa resurser som skapats:

   • ToDo API-app
   • ToDo-webbappens klientdel

   

   Kommentar

   Du kan anropa azd up så många gånger du vill för att både etablera och distribuera uppdateringar till ditt program. Distributionen kan misslyckas på grund av att en resurs inte kan distribueras i den valda regionen. Eftersom det här är en snabbstart är det säkert att ta bort .azure katalogen och försöka azd up igen. När du tillfrågas väljer du en annan region. I ett mer avancerat scenario kan du selektivt redigera filer i .azure katalogen för att ändra regionen.

CLI för Azure Developer tillhandahåller ett Visual Studio Code tillägg för att effektivisera arbetet med azd funktioner. Du kan till exempel använda kommandopalettens gränssnitt för att köra azd kommandon. Du måste installera CLI-tillägget Azure Developer för Visual Studio Code för att slutföra stegen framåt.

Installera CLI-tillägget Azure Developer

1. Öppna Visual Studio Code.

2. På menyn Visa väljer du Tillägg.

3. I sökfältet anger du Azure Developer CLI.

   

4. Välj Installera och vänta tills installationsprocessen har slutförts.

Initiera en ny app

1. Öppna en tom katalog i Visual Studio Code.

2. På menyn Visa väljer du Kommandopalett....

3. Sök efter kommandot Azure Developer CLI (azd): Initialize app (init) och tryck på Retur. Kommandot azd up instruerar azd att etablera och distribuera appresurserna.

   

4. Välj arbetsflödet Välj en mall .

   

6. När mallen har klonats öppnar Visual Studio Code en terminal för att fråga efter ett miljönamn. Ange ett kort namn som du väljer, till exempel azdvscode och tryck på Retur.

   Enter a new environment name: [? for help] azdvscode
   

   Miljönamnet påverkar namngivning av resurser som etablerats i Azure och skapar en mapp i mallkatalogen .azure för att lagra vissa miljöinställningar.

Etablera och distribuera appresurserna

1. Öppna kommandopaletten och sök efter kommandot Azure Developer CLI (azd): Package, Provision and Deploy(up) och tryck på Retur. Kommandot azd up instruerar azd att etablera och distribuera appresurserna.

   Visual Studio Code öppnar ett terminalfönster för att visa förloppet för etablerings- och distributionsprocessen. azd använder de prenumerations- och platsinställningar som du valde under init processen när du distribuerade resurser.

   Kommentar

   Etablerings- och distributionsprocessen kan ta flera minuter.

2. När distributionsprocessen är klar väljer du länken i utdatafönstret som tillhandahålls av azd för att starta webbplatsen i webbläsaren.

Kodområden är ett bra alternativ för utvecklare som föredrar att arbeta i containerbaserade molnmiljöer och undvika att installera verktyg eller beroenden lokalt.

Konfigurera ditt Codespace

2. Klicka på Använd den här mallen>Öppna i ett kodområde ovanför fillistan.

Med Codespaces installeras alla nödvändiga förhandskrav för dig, inklusive Visual Studio Code-tillägget .

Kör mallen

1. När codespace har skapats högerklickar du på azure.yaml i rotkatalogen. Välj up (provisionera resurser och distribuera kod till Azure).

   

2. När du kör azd up kommandot uppmanas du att ange följande information och logga in med en webbläsare och en autentiseringskod:

   

   Parameter	Beskrivning
   Environment Name	Prefix för resursgruppen som ska skapas för att lagra alla Azure resurser. Vad är ett miljönamn i azd? Du kan alltid skapa en ny miljö med azd env new.
   Azure Location	Den Azure plats där dina resurser ska distribueras.
   Azure Subscription	Den Azure prenumeration där dina resurser ska distribueras.

   Den här processen kan ta lite tid att slutföra eftersom azd up kommandot hanterar följande uppgifter:

   • Skapar och konfigurerar alla nödvändiga Azure resurser (azd provision).
   • Konfigurerar åtkomstprinciper och roller för ditt konto.
   • Implementerar tjänst-till-tjänst-kommunikation med hanterade identiteter.
   • Paketerar och distribuerar koden (azd deploy).

   När du har angett nödvändiga parametrar och kommandot azd up har slutförts visar CodeSpaces-terminalen två Azure portallänkar för att visa resurser som skapats:

   • ToDo API-app
   • ToDo-webbappens klientdel

   

Vad hände?

När kommandot har slutförts azd up :

• De Azure-resurser som refereras i mallens README.md-fil har skapats till den Azure-prenumeration du angav när du körde azd up. Nu kan du visa dessa Azure resurser via portalen Azure.
• Appen har skapats och distribuerats till Azure. Med hjälp av webbappens azd up URL-utdata från kommandot kan du bläddra till den fullt fungerande appen.

En DevContainer är en Docker-avbildning som innehåller alla förutsättningar som du behöver för att arbeta med mallen azd på den lokala datorn. De är ett bra val för utvecklare som föredrar containerbaserade miljöer som fortfarande körs på en lokal enhet i stället för en molntjänst som GitHub Codespaces.

Förutsättningar

Initiera projektet

1. Öppna en terminal, skapa en ny tom katalog och ändra till den.

2. Kör följande kommando för att initiera projektet:

   azd init --template todo-nodejs-mongo
   

   azd init --template todo-python-mongo
   

   azd init --template todo-csharp-cosmos-sql
   

   azd init --template todo-java-mongo-aca
   

   När du kör azd init kommandot uppmanas du att ange följande information:

   Parameter	Beskrivning
   Environment Name	Prefix för resursgruppen som ska skapas för att lagra alla Azure resurser. Vad är ett miljönamn i azd? Du kan alltid skapa en ny miljö med azd env new.

Öppna DevContainer

1. Öppna projektet i VS Code.
2. Tryck på F1 och välj: Remote-Containers: Rebuild and Reopen in Container

Kör kommandot up.

Kör följande kommando:

azd up

När du kör azd up kommandot uppmanas du att ange följande information:

Kommandot azd up kan ta lite tid att köra när det slutför följande steg:

• Skapar och konfigurerar alla nödvändiga Azure resurser (azd provision), inklusive:
  • Åtkomstprinciper och roller för ditt konto
  • Tjänst-till-tjänst-kommunikation med hanterade identiteter
• Paketerar och distribuerar koden (azd deploy)

När du har angett nödvändiga parametrar och kommandot azd up har slutförts visar CLI två Azure portallänkar för att visa resurser som skapats:

• ToDo API-app
• ToDo-webbappens klientdel