Snabbstart: Distribuera ett händelsedrivet program till Azure Spring Apps
Artikel
Kommentar
Basic-, Standard- och Enterprise-planerna kommer att vara inaktuella från och med mitten av mars 2025, med en 3-årig pensionsperiod. Vi rekommenderar att du övergår till Azure Container Apps. Mer information finns i meddelandet om azure Spring Apps-pensionering.
Den här artikeln gäller för: ✔️ Standardförbrukning och dedikerad (förhandsversion) ✔️ Basic/Standard ✔️ Enterprise
Den här artikeln beskriver hur du distribuerar ett Spring Boot-händelsedrivet program till Azure Spring Apps.
Exempelprojektet är ett händelsedrivet program som prenumererar på en Service Bus-kö med namnet lower-caseoch sedan hanterar meddelandet och skickar ett annat meddelande till en annan kö med namnet upper-case. För att göra appen enkel konverterar meddelandebearbetning bara meddelandet till versaler. Följande diagram visar den här processen:
Den här artikeln innehåller följande alternativ för att distribuera till Azure Spring Apps:
Alternativet Azure Portal är det enklaste och snabbaste sättet att skapa resurser och distribuera program med ett enda klick. Det här alternativet är lämpligt för Spring-utvecklare som snabbt vill distribuera program till Azure-molntjänster.
Plugin-alternativet Azure Portal + Maven är ett mer konventionellt sätt att skapa resurser och distribuera program steg för steg. Det här alternativet är lämpligt för Spring-utvecklare som använder Azure-molntjänster för första gången.
Cli-alternativet Azure Developer är ett effektivare sätt att automatiskt skapa resurser och distribuera program via enkla kommandon. Azure Developer CLI använder en mall för att etablera de Azure-resurser som behövs och för att distribuera programkoden. Det här alternativet är lämpligt för Spring-utvecklare som är bekanta med Azure-molntjänster.
Alternativet Azure Portal är det enklaste och snabbaste sättet att skapa resurser och distribuera program med ett enda klick. Det här alternativet är lämpligt för Spring-utvecklare som snabbt vill distribuera program till Azure-molntjänster.
Plugin-alternativet Azure Portal + Maven är ett mer konventionellt sätt att skapa resurser och distribuera program steg för steg. Det här alternativet är lämpligt för Spring-utvecklare som använder Azure-molntjänster för första gången.
Azure CLI-alternativet använder ett kraftfullt kommandoradsverktyg för att hantera Azure-resurser. Det här alternativet är lämpligt för Spring-utvecklare som är bekanta med Azure-molntjänster.
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.
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.
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.
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:
Exempelprojektet är klart på GitHub. Klona exempelprojektet med hjälp av följande kommando:
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.
Öppna en terminal, skapa en ny, tom mapp och navigera sedan till den.
Använd följande kommando för att initiera projektet:
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
3. Förbereda molnmiljön
De viktigaste resurserna du behöver för att köra det här exemplet är en Azure Spring Apps-instans, ett Azure Key Vault och en Azure Service Bus-instans. Använd följande steg för att skapa dessa resurser.
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:
Välj följande knappen Distribuera till Azure för att starta distributionsupplevelsen i Azure Portal:
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.
Välj Granska och skapa för att granska dina val. Välj sedan Skapa för att distribuera appen till Azure Spring Apps.
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:
Välj Skapa en resurs i hörnet av Azure Portal.
Sök efter Service Bus i sökrutan tjänsten Search s och Marketplace.
I avsnittet Service Bus väljer du Skapa.
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.
Välj Granska och skapa för att granska skapandeparametrarna. Välj sedan Skapa för att slutföra skapandet av Service Bus-instansen.
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.
Välj Gå till resurs för att gå till sidan Service Bus-namnområde .
Välj Principer för delad åtkomst på navigeringsmenyn och välj sedan RootManageSharedAccessKey.
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.
Välj Köer på navigeringsmenyn och välj sedan Kö.
På sidan Skapa kö anger du gemener för Namn och väljer sedan Skapa.
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:
Välj Skapa en resurs i hörnet av portalen.
Välj Beräkna>Azure Spring Apps.
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.
(Valfritt) Använd följande steg för att skapa en Container Apps-miljö:
Fyll i fliken Grundläggande med följande information:
Miljönamn: myacaenv
Plan: Förbrukning
Zonredundans: Inaktiverad
Välj Skapa för att skapa containerappmiljön.
Fyll i fliken Grundläggande med följande information:
Miljönamn: myacaenv
Planera: (förhandsversion) Förbrukning och dedikerade arbetsbelastningsprofiler
Zonredundans: Inaktiverad
Välj fliken Arbetsbelastningsprofiler (förhandsversion) och välj sedan Lägg till arbetsbelastningsprofil för att lägga till en arbetsbelastningsprofil.
På sidan Lägg till arbetsbelastningsprofil (förhandsversion) lägger du till följande information:
Namn på arbetsbelastningsprofil: my-wlp
Storlek på arbetsbelastningsprofil: Välj Dedikerad D4
Antal instanser för automatisk skalning: Välj 3 och 5
Markera Lägga till. Det här valet tar dig tillbaka till sidan Lägg till arbetsbelastningsprofil (förhandsversion). Välj my-wlp och välj sedan Skapa för att skapa containerappmiljön.
Välj Granska och skapa för att granska dina val. Välj Skapa för att etablera Azure Spring Apps-instansen.
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.
Välj Gå till resurs för att gå till översiktssidan för Azure Spring Apps .
Välj Appar i den vänstra navigeringsmenyn och välj sedan Skapa app.
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.
Välj Skapa för att slutföra skapandet av Azure Spring Apps-instansen.
När appen har skapats väljer du det appnamn som du skapade i föregående steg.
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.
Spara anslutningsegenskaperna genom att välja Spara .
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.
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.
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.
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.
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.
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
Kommentar
Du kan också använda azd up för att kombinera de föregående tre kommandona: azd provision (etablerar Azure-resurser), azd package (paket en distribuerad kopia av ditt program) och azd deploy (distribuerar programkod). Mer information finns i Azure-Samples/ASA-Samples-Event-Driven-Application.
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:
Exempelprojektet är klart på GitHub. Klona exempelprojektet med hjälp av följande kommando:
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.
Öppna en terminal, skapa en ny, tom mapp och navigera sedan till den.
Använd följande kommando för att initiera projektet:
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
3. Förbereda molnmiljön
De viktigaste resurserna du behöver för att köra det här exemplet är en Azure Spring Apps-instans, en Azure Key Vault-instans och en Azure Service Bus-instans. Använd följande steg för att skapa dessa resurser.
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:
Välj följande knappen Distribuera till Azure för att starta distributionsupplevelsen i Azure Portal:
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.
Välj Granska och skapa för att granska dina val. Välj sedan Skapa för att distribuera appen till Azure Spring Apps.
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:
Välj Skapa en resurs i hörnet av Azure Portal.
Sök efter Service Bus i sökrutan tjänsten Search s och Marketplace.
I avsnittet Service Bus väljer du Skapa.
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.
Välj Granska och skapa för att granska skapandeparametrarna. Välj sedan Skapa för att slutföra skapandet av Service Bus-instansen.
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.
Välj Gå till resurs för att gå till sidan Service Bus-namnområde .
Välj Principer för delad åtkomst på navigeringsmenyn och välj sedan RootManageSharedAccessKey.
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.
Välj Köer på navigeringsmenyn och välj sedan Kö.
På sidan Skapa kö anger du gemener för Namn och väljer sedan Skapa.
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:
Välj Skapa en resurs i hörnet av Azure Portal.
Välj Beräkna>Azure Spring Apps.
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.
Välj Granska och skapa för att granska dina val. Välj Skapa för att etablera Azure Spring Apps-instansen.
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
Gå till din Azure Spring Apps-instans i Azure Portal.
Välj Appar på navigeringsmenyn och välj sedan Skapa app.
På sidan Skapa app anger du simple-event-driven-app som Appnamn och väljer Java 17 för Runtime-plattformen.
När appen har skapats väljer du det appnamn som du skapade i föregående steg.
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.
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.
Använd följande kommando för att ange mallen med hjälp av standardplanen :
azd env set PLAN standard
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.
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.
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.
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.
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
Kommentar
Du kan också använda azd up för att kombinera de föregående tre kommandona: azd provision (etablerar Azure-resurser), azd package (paket en distribuerad kopia av ditt program) och azd deploy (distribuerar programkod). Mer information finns i Azure-Samples/ASA-Samples-Event-Driven-Application.
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:
Exempelprojektet är klart på GitHub. Klona exempelprojektet med hjälp av följande kommando:
Skapa exempelprojektet med hjälp av följande kommandon:
cd ASA-Samples-Event-Driven-Application
./mvnw clean package
3. Förbereda molnmiljön
De viktigaste resurserna du behöver för att köra det här exemplet är en Azure Spring Apps-instans och en Azure Service Bus-instans. I följande avsnitt beskrivs hur du skapar dessa resurser.
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:
Välj följande knappen Distribuera till Azure för att starta distributionsupplevelsen i Azure Portal:
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.
Välj Granska och skapa för att granska dina val. Välj sedan Skapa för att distribuera appen till Azure Spring Apps.
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:
Välj Skapa en resurs i hörnet av Azure Portal.
Sök efter Service Bus i sökrutan tjänsten Search s och Marketplace.
I avsnittet Service Bus väljer du Skapa.
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.
Välj Granska och skapa för att granska skapandeparametrarna. Välj sedan Skapa för att slutföra skapandet av Service Bus-instansen.
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.
Välj Gå till resurs för att gå till sidan Service Bus-namnområde .
Välj Köer på navigeringsmenyn och välj sedan Kö.
På sidan Skapa kö anger du gemener för Namn och väljer sedan Skapa.
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:
Välj Skapa en resurs i hörnet av Azure Portal.
Välj Beräkna>Azure Spring Apps.
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.
Välj Granska och skapa för att granska dina val. Välj sedan Skapa för att etablera Azure Spring Apps-instansen.
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 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:
Gå till din Azure Spring Apps-instans i Azure Portal.
Öppna fönstret Appar i navigeringsfönstret och välj sedan Skapa app.
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.
Välj Skapa för att slutföra skapandet av appen och välj sedan appen för att visa informationen.
Välj Tjänstanslutning i navigeringsfönstret och välj sedan Skapa för att skapa en ny tjänstanslutning.
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.
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.
Välj Nästa: Nätverk. Använd standardalternativet Konfigurera brandväggsregler för att aktivera åtkomst till måltjänsten.
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.
Använd följande steg för att skapa en ny resursgrupp:
Använd följande kommando för att logga in på Azure CLI:
az login
Använd följande kommando för att ange standardplatsen:
az configure --defaults location=${LOCATION}
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
Använd följande kommando för att ange standardprenumerationen:
az account set --subscription <subscription-ID>
Använd följande kommando för att skapa en resursgrupp:
az group create --resource-group ${RESOURCE_GROUP}
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:
Använd följande kommando för att skapa ett Service Bus-namnområde:
az servicebus namespace create --name ${SERVICE_BUS_NAME_SPACE}
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:
Hämta Service Bus-anslutningssträng med hjälp av följande kommando:
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.
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
5. Verifiera appen
Använd följande steg för att bekräfta att den händelsedrivna appen fungerar korrekt. Du kan verifiera appen genom att skicka ett meddelande till lower-case kön och sedan bekräfta att det finns ett meddelande i upper-case kön.
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.
Gå till översiktssidan för Azure Spring Apps-instansen och välj Loggar för att kontrollera appens loggar.
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.
Gå till översiktssidan för Azure Spring Apps-instansen och välj Loggar för att kontrollera appens loggar.
Kontrollera informationen för varje resursdistribution, vilket är användbart för att undersöka eventuella distributionsproblem.
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.
Gå till översiktssidan för Azure Spring Apps-instansen och välj Loggar för att kontrollera appens loggar.
Kontrollera informationen för varje resursdistribution, vilket är användbart för att undersöka eventuella distributionsproblem.
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.
Gå till översiktssidan för Azure Spring Apps-instansen och välj Loggar för att kontrollera appens loggar.
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}
6. Rensa resurser
Se till att ta bort de resurser som du skapade i den här artikeln när du inte längre behöver dem. Du kan ta bort den Azure-resursgrupp som innehåller alla resurser i resursgruppen.