Snabbstart: Distribuera ett händelsedrivet program till Azure Spring Apps

• En Azure-prenumeration Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.

• En Azure-prenumeration Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
• Git.
• Java Development Kit (JDK), version 17.

• En Azure-prenumeration Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
• Git.
• Java Development Kit (JDK), version 17.
• Azure Developer CLI (AZD), version 1.2.0 eller senare.

• En Azure-prenumeration Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
• Om du distribuerar en Azure Spring Apps Enterprise-planinstans för första gången i målprenumerationen läser du avsnittet Krav i Visa Azure Spring Apps Enterprise-nivåerbjudande på Azure Marketplace.

• En Azure-prenumeration Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
• Om du distribuerar en Azure Spring Apps Enterprise-planinstans för första gången i målprenumerationen läser du avsnittet Krav i Visa Azure Spring Apps Enterprise-nivåerbjudande på Azure Marketplace.
• Git.
• Java Development Kit (JDK), version 17.

• En Azure-prenumeration Om du inte har en Azure-prenumeration skapar du ett kostnadsfritt Azure-konto innan du börjar.
• Om du distribuerar en Azure Spring Apps Enterprise-planinstans för första gången i målprenumerationen läser du avsnittet Krav i Visa Azure Spring Apps Enterprise-nivåerbjudande på Azure Marketplace.
• Git.
• Java Development Kit (JDK), version 17.
• Azure CLI version 2.45.0 eller senare.

Knappen Distribuera till Azure i nästa avsnitt startar en Azure Portal upplevelse som laddar ned ett JAR-paket från sidan ASA-Samples-Web-Application-versioner på GitHub. Inga lokala förberedelsesteg krävs.

Använd följande steg för att förbereda exemplet lokalt:

1. Exempelprojektet är klart på GitHub. Klona exempelprojektet med hjälp av följande kommando:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Skapa exempelprojektet med hjälp av följande kommandon:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Använd följande steg för att förbereda exemplet lokalt. De här stegen använder AZD för att initiera det händelsedrivna programmet från Azure Developer CLI-mallarna.

1. Öppna en terminal, skapa en ny, tom mapp och navigera sedan till den.

2. Använd följande kommando för att initiera projektet:

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

   I följande lista beskrivs kommandointeraktionerna:

   • Ange ett nytt miljönamn: Ange ett miljönamn som används som suffix för resursgruppen som skapas för att lagra alla Azure-resurser. Det här namnet ska vara unikt i din Azure-prenumeration.

   Konsolen matar ut meddelanden som liknar följande exempel:

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

I det här avsnittet används knappen Distribuera till Azure för att starta en distributionsupplevelse i Azure Portal. Den här upplevelsen använder en ARM-mall för att skapa Azure-resurser.

3.1. Logga in på Azure-portalen

Gå till Azure Portal och ange dina autentiseringsuppgifter för att logga in på portalen. Standardvyn är instrumentpanelen.

3.2. Skapa Azure-resurser

Använd följande steg för att skapa alla Azure-resurser som appen är beroende av:

1. Välj följande knappen Distribuera till Azure för att starta distributionsupplevelsen i Azure Portal:

   

2. Fyll i formuläret på fliken Grundläggande . Använd följande tabell som guide för att fylla i formuläret:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration.	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Region	Den region som är närmast dina användare.	Regionen används för att skapa resursgruppen.

3. Välj Granska och skapa för att granska dina val. Välj sedan Skapa för att distribuera appen till Azure Spring Apps.

4. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida. Välj Gå till resurs för att öppna tjänstens översiktssida.

   

3.1. Logga in på Azure-portalen

Öppna webbläsaren och gå till Azure Portal. Ange dina autentiseringsuppgifter och logga in på portalen. Standardvyn är instrumentpanelen.

3.2. Skapa en Service Bus-instans

Använd följande steg för att skapa en Service Bus-instans:

1. Välj Skapa en resurs i hörnet av Azure Portal.

2. Sök efter Service Bus i sökrutan tjänsten Search s och Marketplace.

3. I avsnittet Service Bus väljer du Skapa.

4. Fyll i formuläret på fliken Grundläggande . Använd följande tabell som guide för att fylla i formuläret:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration.	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Namn på namnrymd	my-srvbus	Ett unikt namn som identifierar din Service Bus-tjänst.
   Plats	Den plats som är närmast dina användare.	Den plats som är närmast dina användare.
   Värdalternativ och planer	Grundläggande	Prisplanen avgör vilken resurs och kostnad som är associerad med din instans.

5. Välj Granska och skapa för att granska skapandeparametrarna. Välj sedan Skapa för att slutföra skapandet av Service Bus-instansen.

6. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida. Välj Gå till resurs för att öppna tjänstens översiktssida.

   

7. Välj Gå till resurs för att gå till sidan Service Bus-namnområde .

8. Välj Principer för delad åtkomst på navigeringsmenyn och välj sedan RootManageSharedAccessKey.

9. På sidan SAS-princip: RootManageSharedAccessKey kopierar och sparar du värdet primär anslutningssträng, som används för att konfigurera anslutningar från Spring-appen.

10. Välj Köer på navigeringsmenyn och välj sedan Kö.

11. På sidan Skapa kö anger du gemener för Namn och väljer sedan Skapa.

12. Skapa en annan kö genom att upprepa föregående steg med versaler för Namn.

3.3. Skapa en Azure Spring Apps-instans

Använd följande steg för att skapa tjänstinstansen:

1. Välj Skapa en resurs i hörnet av portalen.

2. Välj Beräkna>Azure Spring Apps.

3. Fyll i formuläret Standardförbrukning och dedikerad (förhandsversion) med följande information:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Namn	myasa	Ett unikt namn som identifierar din Azure Spring Apps-tjänst. Namnet måste vara mellan 4 och 32 tecken långt och får endast innehålla gemener, siffror och bindestreck. Det första tecknet i tjänstnamnet måste vara en bokstav och det sista tecknet måste vara antingen en bokstav eller ett tal.
   Planera	Standardförbrukning och dedikerad (förhandsversion)	Prisplanen avgör vilka resurser och kostnader som är kopplade till din instans.
   Region	Den region som är närmast dina användare	Den plats som är närmast dina användare.
   Container Apps-miljö	myacaenv	Miljön är en säker gräns runt en eller flera containerappar som kan kommunicera med varandra och dela ett virtuellt nätverk, loggning och Dapr-konfiguration.

4. (Valfritt) Använd följande steg för att skapa en Container Apps-miljö:

   • Förbrukningsarbetsbelastning
   • Dedikerad arbetsbelastning

   1. Fyll i fliken Grundläggande med följande information:

      • Miljönamn: myacaenv
      • Plan: Förbrukning
      • Zonredundans: Inaktiverad

   2. Välj Skapa för att skapa containerappmiljön.

5. Välj Granska och skapa för att granska dina val. Välj Skapa för att etablera Azure Spring Apps-instansen.

6. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida. Om du väljer Gå till resurs öppnas tjänstens översiktssida.

   

7. Välj Gå till resurs för att gå till översiktssidan för Azure Spring Apps .

8. Välj Appar i den vänstra navigeringsmenyn och välj sedan Skapa app.

9. På sidan Skapa app anger du simple-event-driven-app som Appnamn och väljer sedan Använd snabbstartsexempelapp för att skapa en app.

   

10. Välj Skapa för att slutföra skapandet av Azure Spring Apps-instansen.

11. När appen har skapats väljer du det appnamn som du skapade i föregående steg.

12. Välj Konfiguration i navigeringsfönstret och konfigurera sedan följande egenskap på fliken Miljövariabler .

    • SERVICE_BUS_CONNECTION_STRING: Ange den primära Service Bus-anslutningssträng.

    

13. Spara anslutningsegenskaperna genom att välja Spara .

1. Använd följande kommando för att logga in i Azure med OAuth2. Ignorera det här steget om du redan har loggat in.

   azd auth login
   

   Konsolen matar ut meddelanden som liknar följande exempel:

   Logged in to Azure.
   

2. Använd följande kommando för att etablera mallens infrastruktur till Azure:

   azd provision
   

   I följande lista beskrivs kommandointeraktionerna:

   • Välj en Azure-prenumeration som ska användas: Använd pilar för att flytta, skriv för att filtrera och tryck sedan på Retur.
   • Välj en Azure-plats att använda: Använd pilar för att flytta, skriv för att filtrera och tryck sedan på Retur.

   Konsolen matar ut meddelanden som liknar följande exempel:

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name>-<random-string>> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Kommentar

   Det här kommandot kan ta en stund att slutföra. Du ser en förloppsindikator när den etablerar Azure-resurser.

Knappen Distribuera till Azure i föregående avsnitt startar en Azure Portal upplevelse som innehåller programdistribution, så inget annat behövs.

Använd följande steg för att distribuera med maven-plugin-programmet för Azure Spring Apps:

1. Gå till den fullständiga katalogen och kör sedan följande kommando för att konfigurera appen i Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   I följande lista beskrivs kommandointeraktionerna:

   • OAuth2-inloggning: Du måste auktorisera inloggningen till Azure baserat på OAuth2-protokollet.
   • Välj prenumeration: Välj prenumerationslistans nummer för den Azure Spring Apps-instans som du skapade, som standard är den första prenumerationen i listan. Om du använder standardnumret trycker du på Retur direkt.
   • Använd befintliga Azure Spring Apps i Azure: Tryck på y för att använda den befintliga Azure Spring Apps-instansen.
   • Välj Azure Spring Apps för distribution: Välj listnumret för den Azure Spring Apps-instans som du skapade. Om du använder standardnumret trycker du på Retur direkt.
   • Använd befintlig app i Azure Spring Apps <ditt-instansnamn>: Tryck på y för att använda den skapade appen.
   • Bekräfta för att spara alla ovanstående konfigurationer: Tryck på y. Om du trycker på n sparas inte konfigurationen i POM-filerna.

2. Använd följande kommando för att distribuera appen:

   ./mvnw azure-spring-apps:deploy
   

   I följande lista beskrivs kommandointeraktionen:

   • OAuth2-inloggning: Du måste auktorisera inloggningen till Azure baserat på OAuth2-protokollet.

   När kommandot har körts kan du se från följande loggmeddelanden att distributionen lyckades:

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Använd följande steg för att använda AZD för att paketera appen, etablera de Azure-resurser som krävs av webbprogrammet och sedan distribuera till Azure Spring Apps.

1. Använd följande kommando för att paketera en distribuerad kopia av ditt program:

   azd package
   

   Konsolen matar ut meddelanden som liknar följande exempel:

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

2. Använd följande kommando för att distribuera programkoden till de nyligen etablerade resurserna:

   azd deploy
   

   Konsolen matar ut meddelanden som liknar följande exempel:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service simple-event-driven-app
   - No endpoints were found
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

Knappen Distribuera till Azure i nästa avsnitt startar en Azure Portal upplevelse som laddar ned ett JAR-paket från sidan ASA-Samples-Web-Application-versioner på GitHub. Inga lokala förberedelsesteg krävs.

Använd följande steg för att förbereda exemplet lokalt:

1. Exempelprojektet är klart på GitHub. Klona exempelprojektet med hjälp av följande kommando:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Skapa exempelprojektet med hjälp av följande kommandon:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Använd följande steg för att förbereda exemplet lokalt. De här stegen använder AZD för att initiera det händelsedrivna programmet från Azure Developer CLI-mallarna.

1. Öppna en terminal, skapa en ny, tom mapp och navigera sedan till den.

2. Använd följande kommando för att initiera projektet:

   azd init --template Azure-Samples/ASA-Samples-Event-Driven-Application
   

   I följande lista beskrivs kommandointeraktionerna:

   • Ange ett nytt miljönamn: Ange ett miljönamn som används som suffix för resursgruppen som skapas för att lagra alla Azure-resurser. Det här namnet ska vara unikt i din Azure-prenumeration.

   Konsolen matar ut meddelanden som liknar följande exempel:

   Initializing a new project (azd init)
   
   (✓) Done: Initialized git repository
   (✓) Done: Downloading template code to: <your-local-path>
   
   Enter a new environment name: <your-env-name>
   
   SUCCESS: New project initialized!
   You can view the template code in your directory: <your-local-path>
   Learn more about running 3rd party code on our DevHub: https://aka.ms/azd-third-party-code-notice
   

I det här avsnittet används knappen Distribuera till Azure för att starta en distributionsupplevelse i Azure Portal. Den här upplevelsen använder en ARM-mall för att skapa Azure-resurser.

3.1. Logga in på Azure-portalen

Gå till Azure Portal och ange dina autentiseringsuppgifter för att logga in på portalen. Standardvyn är instrumentpanelen.

3.2. Skapa Azure-resurser

Använd följande steg för att skapa alla Azure-resurser som appen är beroende av:

1. Välj följande knappen Distribuera till Azure för att starta distributionsupplevelsen i Azure Portal:

   

2. Fyll i formuläret på fliken Grundläggande . Använd följande tabell som guide för att fylla i formuläret:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration.	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Region	Den region som är närmast dina användare.	Regionen används för att skapa resursgruppen.

3. Välj Granska och skapa för att granska dina val. Välj sedan Skapa för att distribuera appen till Azure Spring Apps.

4. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida. Välj Gå till resurs för att öppna tjänstens översiktssida.

   

3.1. Logga in på Azure-portalen

Öppna webbläsaren och gå till Azure Portal. Ange dina autentiseringsuppgifter och logga in på portalen. Standardvyn är instrumentpanelen.

3.2. Skapa en Service Bus-instans

Använd följande steg för att skapa en Service Bus-instans:

1. Välj Skapa en resurs i hörnet av Azure Portal.

2. Sök efter Service Bus i sökrutan tjänsten Search s och Marketplace.

3. I avsnittet Service Bus väljer du Skapa.

4. Fyll i formuläret på fliken Grundläggande . Använd följande tabell som guide för att fylla i formuläret:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration.	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Namn på namnrymd	my-srvbus	Ett unikt namn som identifierar din Service Bus-tjänst.
   Plats	Den plats som är närmast dina användare.	Den plats som är närmast dina användare.
   Värdalternativ och planer	Grundläggande	Prisplanen avgör vilken resurs och kostnad som är associerad med din instans.

5. Välj Granska och skapa för att granska skapandeparametrarna. Välj sedan Skapa för att slutföra skapandet av Service Bus-instansen.

6. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida. Välj Gå till resurs för att öppna tjänstens översiktssida.

   

7. Välj Gå till resurs för att gå till sidan Service Bus-namnområde .

8. Välj Principer för delad åtkomst på navigeringsmenyn och välj sedan RootManageSharedAccessKey.

9. På sidan SAS-princip: RootManageSharedAccessKey kopierar och sparar du värdet primär anslutningssträng, som används för att konfigurera anslutningar från Spring-appen.

10. Välj Köer på navigeringsmenyn och välj sedan Kö.

11. På sidan Skapa kö anger du gemener för Namn och väljer sedan Skapa.

12. Skapa en annan kö genom att upprepa föregående steg med versaler för Namn.

3.3. Skapa en Azure Spring Apps-instans

Använd följande steg för att skapa en Azure Spring Apps-instans:

1. Välj Skapa en resurs i hörnet av Azure Portal.

2. Välj Beräkna>Azure Spring Apps.

3. Fyll i formuläret Grundläggande med följande information:

   Använd följande tabell som en guide för att fylla i formuläret. Den rekommenderade planen är Standard.

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Namn	myasa	Ett unikt namn som identifierar din Azure Spring Apps-tjänst. Namnet måste vara mellan 4 och 32 tecken långt och får endast innehålla gemener, siffror och bindestreck. Det första tecknet i tjänstnamnet måste vara en bokstav och det sista tecknet måste vara antingen en bokstav eller ett tal.
   Planera	Standard	Planen bestämmer resursen och kostnaden som är associerad med din instans.
   Region	Den region som är närmast dina användare	Den plats som är närmast dina användare.
   Zonredundant	Inte markerat	Om du vill skapa din Azure Spring Apps-tjänst i en Azure-tillgänglighetszon kan den bara stödjas i flera regioner för tillfället.

4. Välj Granska och skapa för att granska dina val. Välj Skapa för att etablera Azure Spring Apps-instansen.

5. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida. Om du väljer Gå till resurs öppnas tjänstens översiktssida.

   

3.4. Ansluta appinstansen till Service Bus-instansen

1. Gå till din Azure Spring Apps-instans i Azure Portal.

2. Välj Appar på navigeringsmenyn och välj sedan Skapa app.

3. På sidan Skapa app anger du simple-event-driven-app som Appnamn och väljer Java 17 för Runtime-plattformen.

   

4. När appen har skapats väljer du det appnamn som du skapade i föregående steg.

5. På sidan Konfiguration väljer du fliken Miljövariabler, anger SERVICE_BUS_CONNECTION_STRING för Nyckel, klistrar in Service Bus-anslutningssträng för Värde och väljer sedan Spara.

   

1. Använd följande kommando för att logga in på Azure med OAuth2. Ignorera det här steget om du redan har loggat in.

   azd auth login
   

   Konsolen matar ut meddelanden som liknar följande exempel:

   Logged in to Azure.
   

2. Använd följande kommando för att ange mallen med hjälp av standardplanen :

   azd env set PLAN standard
   

3. Använd följande kommando för att paketera en distribuerad kopia av ditt program, etablera mallens infrastruktur till Azure och distribuera programkoden till de nyligen etablerade resurserna:

   azd provision
   

   I följande lista beskrivs kommandointeraktionerna:

   • Välj en Azure-prenumeration som ska användas: Använd pilar för att flytta, skriv för att filtrera och tryck sedan på Retur.
   • Välj en Azure-plats att använda: Använd pilar för att flytta, skriv för att filtrera och tryck sedan på Retur.

   Konsolen matar ut meddelanden som liknar följande exempel:

   SUCCESS: Your application was provisioned in Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

   Kommentar

   Det här kommandot kan ta en stund att slutföra. Du visas en förloppsindikator när den etablerar Azure-resurser.

Knappen Distribuera till Azure i föregående avsnitt startar en Azure Portal upplevelse som innehåller programdistribution, så inget annat behövs.

Använd följande steg för att distribuera med maven-plugin-programmet för Azure Spring Apps:

1. Gå till den fullständiga katalogen och kör sedan följande kommando för att konfigurera appen i Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   I följande lista beskrivs kommandointeraktionerna:

   • OAuth2-inloggning: Du måste auktorisera inloggningen till Azure baserat på OAuth2-protokollet.
   • Välj prenumeration: Välj prenumerationslistans nummer för den Azure Spring Apps-instans som du skapade, som standard är den första prenumerationen i listan. Om du använder standardnumret trycker du på Retur direkt.
   • Använd befintliga Azure Spring Apps i Azure: Tryck på y för att använda den befintliga Azure Spring Apps-instansen.
   • Välj Azure Spring Apps för distribution: Välj listnumret för den Azure Spring Apps-instans som du skapade. Om du använder standardnumret trycker du på Retur direkt.
   • Använd befintlig app i Azure Spring Apps <ditt-instansnamn>: Tryck på y för att använda den skapade appen.
   • Bekräfta för att spara alla ovanstående konfigurationer: Tryck på y. Om du trycker på n sparas inte konfigurationen i POM-filerna.

2. Använd följande kommando för att distribuera appen:

   ./mvnw azure-spring-apps:deploy
   

   I följande lista beskrivs kommandointeraktionen:

   • OAuth2-inloggning: Du måste auktorisera inloggningen till Azure baserat på OAuth2-protokollet.

   När kommandot har körts kan du se från följande loggmeddelanden att distributionen lyckades:

   [INFO] Deployment(default) is successfully created
   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Använd följande steg för att använda AZD för att paketera appen, etablera de Azure-resurser som krävs av webbprogrammet och sedan distribuera till Azure Spring Apps.

1. Använd följande kommando för att paketera en distribuerad kopia av ditt program:

   azd package
   

   Konsolen matar ut meddelanden som liknar följande exempel:

   SUCCESS: Your application was packaged for Azure in xx seconds.
   

2. Använd följande kommando för att distribuera programkoden till de nyligen etablerade resurserna:

   azd deploy
   

   Konsolen matar ut meddelanden som liknar följande exempel:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service simple-event-driven-app
   - No endpoints were found
   
   SUCCESS: Your application was deployed to Azure in xx minutes xx seconds.
   You can view the resources created under the resource group rg-<your-environment-name> in Azure Portal:
   https://portal.azure.com/#@/resource/subscriptions/<your-subscription-id>/resourceGroups/rg-<your-environment-name>/overview
   

Knappen Distribuera till Azure i nästa avsnitt startar en Azure Portal upplevelse som laddar ned ett JAR-paket från sidan ASA-Samples-Web-Application-versioner på GitHub. Inga lokala förberedelsesteg krävs.

Använd följande steg för att förbereda exemplet lokalt:

1. Exempelprojektet är klart på GitHub. Klona exempelprojektet med hjälp av följande kommando:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Skapa exempelprojektet med hjälp av följande kommandon:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

Använd följande steg för att förbereda exemplet lokalt:

1. Exempelprojektet är klart på GitHub. Klona exempelprojektet med hjälp av följande kommando:

   git clone https://github.com/Azure-Samples/ASA-Samples-Event-Driven-Application.git
   

2. Skapa exempelprojektet med hjälp av följande kommandon:

   cd ASA-Samples-Event-Driven-Application
   ./mvnw clean package
   

I det här avsnittet används knappen Distribuera till Azure för att starta en distributionsupplevelse i Azure Portal. Den här upplevelsen använder en ARM-mall för att skapa Azure-resurser.

3.1. Logga in på Azure-portalen

Gå till Azure Portal och ange dina autentiseringsuppgifter för att logga in på portalen. Standardvyn är instrumentpanelen.

3.2. Skapa Azure-resurser

Använd följande steg för att skapa alla Azure-resurser som appen är beroende av:

1. Välj följande knappen Distribuera till Azure för att starta distributionsupplevelsen i Azure Portal:

   

2. Fyll i formuläret på fliken Grundläggande . Använd följande tabell som guide för att fylla i formuläret:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration.	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Region	Den region som är närmast dina användare.	Regionen används för att skapa resursgruppen.

3. Välj Granska och skapa för att granska dina val. Välj sedan Skapa för att distribuera appen till Azure Spring Apps.

4. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida. Välj Gå till resurs för att öppna tjänstens översiktssida.

   

3.1. Logga in på Azure-portalen

Gå till Azure Portal och ange dina autentiseringsuppgifter för att logga in på portalen. Standardvyn är instrumentpanelen.

3.2. Skapa en Service Bus-instans

Använd följande steg för att skapa en Service Bus-instans:

1. Välj Skapa en resurs i hörnet av Azure Portal.

2. Sök efter Service Bus i sökrutan tjänsten Search s och Marketplace.

3. I avsnittet Service Bus väljer du Skapa.

4. Fyll i formuläret på fliken Grundläggande . Använd följande tabell som guide för att fylla i formuläret:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration.	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Namn på namnrymd	my-srvbus	Ett unikt namn som identifierar din Service Bus-tjänst.
   Plats	Den plats som är närmast dina användare.	Den plats som är närmast dina användare.
   Värdalternativ och planer	Grundläggande	Prisplanen avgör vilken resurs och kostnad som är associerad med din instans.

5. Välj Granska och skapa för att granska skapandeparametrarna. Välj sedan Skapa för att slutföra skapandet av Service Bus-instansen.

6. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida. Välj Gå till resurs för att öppna tjänstens översiktssida.

   

7. Välj Gå till resurs för att gå till sidan Service Bus-namnområde .

8. Välj Köer på navigeringsmenyn och välj sedan Kö.

9. På sidan Skapa kö anger du gemener för Namn och väljer sedan Skapa.

10. Skapa en annan kö genom att upprepa föregående steg med versaler för Namn.

3.3. Skapa en Azure Spring Apps-instans

Använd följande steg för att skapa tjänstinstansen:

1. Välj Skapa en resurs i hörnet av Azure Portal.

2. Välj Beräkna>Azure Spring Apps.

3. Fyll i formuläret Grundläggande med följande information:

   Inställning	Föreslaget värde	beskrivning
   Abonnemang	Namnet på din prenumeration.	Den Azure-prenumeration som ska användas för servern. Om du har flera prenumerationer väljer du den prenumeration där du vill debiteras för resursen.
   Resursgrupp	myresourcegroup	Ett nytt resursgruppnamn eller ett befintligt namn i prenumerationen.
   Namn	myasa	Ett unikt namn som identifierar din Azure Spring Apps-tjänst. Namnet måste vara mellan 4 och 32 tecken långt och får endast innehålla gemener, siffror och bindestreck. Det första tecknet i tjänstnamnet måste vara en bokstav och det sista tecknet måste vara antingen en bokstav eller ett tal.
   Region	Den region som är närmast dina användare.	Den plats som är närmast dina användare.
   Värdalternativ och planer	Enterprise	Prisplanen som avgör vilken resurs och kostnad som är associerad med din instans.
   Zonredundant	Inte markerat	Alternativet att skapa din Azure Spring Apps-tjänst i en Azure-tillgänglighetszon. Den här funktionen stöds för närvarande inte i alla regioner.
   Ip-plan för programvara	Betala per användning	Prisplanen som låter dig betala per användning med Azure Spring Apps.
   Distribuera exempelprojekt	Inte markerat	Alternativet att använda det inbyggda exempelprogrammet.

4. Välj Granska och skapa för att granska dina val. Välj sedan Skapa för att etablera Azure Spring Apps-instansen.

5. Välj ikonen Aviseringar (en bjällra) i verktygsfältet för att övervaka distributionsprocessen. När distributionen är klar kan du välja Fäst på instrumentpanelen, vilket skapar en panel för den här tjänsten på din Azure Portal instrumentpanel som en genväg till tjänstens översiktssida.

   

6. Välj Gå till resurs för att gå till översiktssidan för Azure Spring Apps .

3.4. Ansluta appinstansen till Service Bus-instansen

Använd följande steg för att ansluta dina tjänstinstanser:

1. Gå till din Azure Spring Apps-instans i Azure Portal.

2. Öppna fönstret Appar i navigeringsfönstret och välj sedan Skapa app.

3. På sidan Skapa app för appnamnet använder du simple-event-driven-app och lämnar alla andra fält med sina standardvärden.

4. Välj Skapa för att slutföra skapandet av appen och välj sedan appen för att visa informationen.

5. Välj Tjänstanslutning i navigeringsfönstret och välj sedan Skapa för att skapa en ny tjänstanslutning.

6. Fyll i fliken Grundläggande med följande information:

   • Tjänsttyp: Välj Service Bus.
   • Anslutningsnamn: Fylls med ett automatiskt genererat namn som du kan ändra.
   • Prenumeration: Välj din prenumeration.
   • Namnområde: Välj det namnområde som du skapade.
   • Klienttyp: Välj SpringBoot.

7. Konfigurera fliken Nästa: Autentisering med följande information:

   • Välj den autentiseringstyp som du vill använda mellan beräkningstjänsten och måltjänsten.: Välj Anslutningssträng.

8. Välj Nästa: Nätverk. Använd standardalternativet Konfigurera brandväggsregler för att aktivera åtkomst till måltjänsten.

9. Välj Nästa: Granska och skapa för att granska dina val och välj sedan Skapa för att skapa anslutningen.

3.1. Ange namn för varje resurs

Skapa variabler för att lagra resursnamnen med hjälp av följande kommandon. Se till att ersätta platshållarna med dina egna värden.

export RESOURCE_GROUP=<event-driven-app-resource-group-name>
export LOCATION=<desired-region>
export SERVICE_BUS_NAME_SPACE=<event-driven-app-service-bus-namespace>
export AZURE_SPRING_APPS_INSTANCE=<Azure-Spring-Apps-instance-name>
export APP_NAME=<event-driven-app-name>

3.2. Skapa en ny resursgrupp

Använd följande steg för att skapa en ny resursgrupp:

1. Använd följande kommando för att logga in på Azure CLI:

   az login
   

2. Använd följande kommando för att ange standardplatsen:

   az configure --defaults location=${LOCATION}
   

3. Använd följande kommando för att lista alla tillgängliga prenumerationer för att fastställa vilket prenumerations-ID som ska användas:

   az account list --output table
   

4. Använd följande kommando för att ange standardprenumerationen:

   az account set --subscription <subscription-ID>
   

5. Använd följande kommando för att skapa en resursgrupp:

   az group create --resource-group ${RESOURCE_GROUP}
   

6. Använd följande kommando för att ange den nyligen skapade resursgruppen som standardresursgrupp:

   az configure --defaults group=${RESOURCE_GROUP}
   

3.3. Installera tillägget och registrera namnområdet

Använd följande kommandon för att installera Azure Spring Apps-tillägget för Azure CLI och registrera Microsoft.SaaS namnområdet:

az extension add --name spring --upgrade
az provider register --namespace Microsoft.SaaS

3.4. Skapa en Azure Spring Apps-instans

Använd följande kommando för att skapa din Azure Spring Apps-instans:

az spring create \
    --name ${AZURE_SPRING_APPS_INSTANCE} \
    --sku Enterprise

Använd sedan följande kommando för att skapa en app i Azure Spring Apps-instansen:

az spring app create \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME}

3.5. Skapa en Service Bus-instans

Använd följande steg för att skapa en Service Bus-instans:

1. Använd följande kommando för att skapa ett Service Bus-namnområde:

   az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
   

2. Använd följande kommandon för att skapa två köer med namnet lower-case och upper-case:

   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name lower-case
   az servicebus queue create \
       --namespace-name ${SERVICE_BUS_NAME_SPACE} \
       --name upper-case
   

3.6. Ansluta appinstansen till Service Bus-instansen

Nu har du skapat både Service Bus och appen i Azure Spring Apps, men appen kan inte ansluta till Service Bus. Använd följande steg för att göra det möjligt för appen att ansluta till Service Bus och sedan distribuera appen:

1. Hämta Service Bus-anslutningssträng med hjälp av följande kommando:

   export SERVICE_BUS_CONNECTION_STRING=$( \
       az servicebus namespace authorization-rule keys list \
           --namespace-name ${SERVICE_BUS_NAME_SPACE} \
           --name RootManageSharedAccessKey \
           --query primaryConnectionString \
           --output tsv)
   

2. Använd följande kommando för att tillhandahålla anslutningssträng till appen via en miljövariabel:

   az spring app update \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME} \
       --env SPRING_CLOUD_AZURE_SERVICEBUS_CONNECTIONSTRING=${SERVICE_BUS_CONNECTION_STRING} \
             SPRING_CLOUD_AZURE_KEYVAULT_SECRET_PROPERTYSOURCEENABLED=false
   

Knappen Distribuera till Azure i föregående avsnitt startar en Azure Portal upplevelse som innehåller programdistribution, så inget annat behövs.

Använd följande steg för att distribuera med maven-plugin-programmet för Azure Spring Apps:

1. Gå till den fullständiga katalogen och kör sedan följande kommando för att konfigurera appen i Azure Spring Apps:

   ./mvnw com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config
   

   I följande lista beskrivs kommandointeraktionerna:

   • OAuth2-inloggning: Du måste auktorisera inloggningen till Azure baserat på OAuth2-protokollet.
   • Välj prenumeration: Välj prenumerationslistans nummer för den Azure Spring Apps-instans som du skapade, som standard är den första prenumerationen i listan. Om du använder standardnumret trycker du på Retur direkt.
   • Använd befintliga Azure Spring Apps i Azure: Tryck på y för att använda den befintliga Azure Spring Apps-instansen.
   • Välj Azure Spring Apps för distribution: Välj listnumret för den Azure Spring Apps-instans som du skapade. Om du använder standardnumret trycker du på Retur direkt.
   • Använd befintlig app i Azure Spring Apps <ditt-instansnamn>: Tryck på y för att använda den skapade appen.
   • Bekräfta för att spara alla ovanstående konfigurationer: Tryck på y. Om du trycker på n sparas inte konfigurationen i POM-filerna.

2. Använd följande kommando för att distribuera appen:

   ./mvnw azure-spring-apps:deploy
   

   I följande lista beskrivs kommandointeraktionen:

   • OAuth2-inloggning: Du måste auktorisera inloggningen till Azure baserat på OAuth2-protokollet.

   När kommandot har körts kan du se från följande loggmeddelanden att distributionen lyckades:

   [INFO] Starting Spring App after deploying artifacts...
   [INFO] Deployment Status: Running
   

Molnmiljön är nu klar. Distribuera appen med hjälp av följande kommando:

az spring app deploy \
    --service ${AZURE_SPRING_APPS_INSTANCE} \
    --name ${APP_NAME} \
    --artifact-path target/simple-event-driven-app-0.0.2-SNAPSHOT.jar

1. Skicka ett meddelande till lower-case kön med Service Bus Explorer. Mer information finns i avsnittet Skicka ett meddelande till en kö eller ett ämne i Använda Service Bus Explorer för att köra dataåtgärder på Service Bus.

2. Bekräfta att ett nytt meddelande skickas till upper-case kön. Mer information finns i avsnittet Granska ett meddelande i Använda Service Bus Explorer för att köra dataåtgärder på Service Bus.

3. Gå till översiktssidan för Azure Spring Apps-instansen och välj Loggar för att kontrollera appens loggar.

   

4. Kontrollera informationen för varje resursdistribution, vilket är användbart för att undersöka eventuella distributionsproblem.

1. Skicka ett meddelande till lower-case kön med Service Bus Explorer. Mer information finns i avsnittet Skicka ett meddelande till en kö eller ett ämne i Använda Service Bus Explorer för att köra dataåtgärder på Service Bus.

2. Bekräfta att ett nytt meddelande skickas till upper-case kön. Mer information finns i avsnittet Granska ett meddelande i Använda Service Bus Explorer för att köra dataåtgärder på Service Bus.

3. Gå till översiktssidan för Azure Spring Apps-instansen och välj Loggar för att kontrollera appens loggar.

   

4. Kontrollera informationen för varje resursdistribution, vilket är användbart för att undersöka eventuella distributionsproblem.

1. Skicka ett meddelande till lower-case kön med Service Bus Explorer. Mer information finns i avsnittet Skicka ett meddelande till en kö eller ett ämne i Använda Service Bus Explorer för att köra dataåtgärder på Service Bus.

2. Bekräfta att ett nytt meddelande skickas till upper-case kön. Mer information finns i avsnittet Granska ett meddelande i Använda Service Bus Explorer för att köra dataåtgärder på Service Bus.

3. Gå till översiktssidan för Azure Spring Apps-instansen och välj Loggar för att kontrollera appens loggar.

   

4. Använd följande kommando för att kontrollera appens logg för att undersöka eventuella distributionsproblem:

   az spring app logs \
       --service ${AZURE_SPRING_APPS_INSTANCE} \
       --name ${APP_NAME}
   

Använd följande steg för att ta bort hela resursgruppen, inklusive den nyligen skapade tjänsten:

1. Leta reda på resursgruppen på Azure Portal. På navigeringsmenyn väljer du Resursgrupper och sedan namnet på resursgruppen.

2. På sidan Resursgrupp väljer du Ta bort. Ange namnet på resursgruppen i textrutan för att bekräfta borttagningen och välj sedan Ta bort.

Använd följande steg för att ta bort hela resursgruppen, inklusive den nyligen skapade tjänsten:

1. Leta reda på resursgruppen på Azure Portal. På navigeringsmenyn väljer du Resursgrupper och sedan namnet på resursgruppen.

2. På sidan Resursgrupp väljer du Ta bort. Ange namnet på resursgruppen i textrutan för att bekräfta borttagningen och välj sedan Ta bort.

Använd följande kommando för att ta bort hela resursgruppen, inklusive den nyligen skapade tjänsten:

az group delete --name ${RESOURCE_GROUP}

Använd följande steg för att ta bort hela resursgruppen, inklusive den nyligen skapade tjänsten:

1. Leta reda på resursgruppen på Azure Portal. På navigeringsmenyn väljer du Resursgrupper och sedan namnet på resursgruppen.

2. På sidan Resursgrupp väljer du Ta bort. Ange namnet på resursgruppen i textrutan för att bekräfta borttagningen och välj sedan Ta bort.

Använd följande steg för att ta bort hela resursgruppen, inklusive den nyligen skapade tjänsten:

1. Leta reda på resursgruppen på Azure Portal. På navigeringsmenyn väljer du Resursgrupper och sedan namnet på resursgruppen.

2. På sidan Resursgrupp väljer du Ta bort. Ange namnet på resursgruppen i textrutan för att bekräfta borttagningen och välj sedan Ta bort.

Använd följande kommando för att ta bort alla Azure-resurser som används i det här exempelprogrammet:

azd down

I följande lista beskrivs kommandointeraktionerna:

• Totalt antal resurser att ta bort: <your-resources-total>, är du säker på att du vill fortsätta?: Tryck på y.
• Vill du ta bort resurserna permanent i stället, så att deras namn kan återanvändas?: Tryck på y. Tryck på n om du vill återanvända Key Vault.

Konsolen matar ut meddelanden som liknar följande exempel:

SUCCESS: Your application was removed from Azure in xx minutes xx seconds.