Snabbstart: Distribuera ditt första 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 Enterprise-plan 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 Enterprise-plan 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 Enterprise-plan på Azure Marketplace.
• Git.
• Java Development Kit (JDK), version 17.
• Azure CLI version 2.45.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 Enterprise-plan på Azure Marketplace.
• Java Development Kit (JDK), version 17.
• IntelliJ IDEA.
• Azure Toolkit for IntelliJ.

• 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 Enterprise-plan på Azure Marketplace.
• Java Development Kit (JDK), version 17.
• Visual Studio Code.

Knappen Distribuera till Azure i nästa avsnitt startar en Azure Portal upplevelse som laddar ned ett JAR-paket från lanseringssidan spring-cloud-azure-tools på GitHub. Inga lokala förberedelsesteg krävs.

Använd följande steg för att förbereda projektet:

1. Använd följande kommando för att klona Spring Boot-exempelprojektet för Azure från GitHub.

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. Använd följande kommando för att flytta till projektmappen:

   cd gs-spring-boot-for-azure/complete
   

3. Använd följande Maven-kommando för att skapa projektet:

   ./mvnw clean package
   

4. Kör exempelprojektet lokalt med hjälp av följande kommando:

   ./mvnw spring-boot:run
   

Använd följande steg för att initiera programmet från Azure Developer CLI-mallarna:

1. Öppna en terminal, skapa en tom mapp och ändra sedan katalogen till den.

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

   azd init --template spring-guides/gs-spring-boot-for-azure
   

   I följande lista beskrivs kommandointeraktionerna:

   • OAuth2-inloggning: Du måste auktorisera inloggningen till Azure baserat på OAuth2-protokollet.
   • Ange ett nytt miljönamn: Ange ett miljönamn som används som suffix för resursgruppen som skapats 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

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

3.2. Skapa en Azure Spring Apps-instans

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

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 consumption & dedicated (preview).

   Inställning	Föreslaget värde	beskrivning
   Prenumeration	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.
   Name	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 vilken resurs och kostnad 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.
   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) 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.

   

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

Använd följande steg för att skapa de resurser som krävs:

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 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 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å n för att skapa en ny app.
   • Ange appnamnet (demo): Ange ett appnamn. Om du använder standardprojektets artefakt-ID trycker du på Retur direkt.
   • Exponera offentlig åtkomst för den här appen (boot-for-azure): Tryck på y.
   • 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
   [INFO]   InstanceName:demo--default-xxxxxxx-xxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:NONE
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://demo.<unique-identifier>.<region-name>.azurecontainerapps.io
   

Använd följande steg för att paketera appen, etablera de Azure-resurser som krävs av webbappen och distribuera sedan 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 demo
   - Endpoint: https://demo.xxx.<your-azure-location>.azurecontainerapps.io
   
   
   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 lanseringssidan spring-cloud-azure-tools på GitHub. Inga lokala förberedelsesteg krävs.

Använd följande steg för att förbereda projektet:

1. Använd följande kommando för att klona Spring Boot-exempelprojektet för Azure från GitHub.

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. Använd följande kommando för att flytta till projektmappen:

   cd gs-spring-boot-for-azure/complete
   

3. Använd följande Maven-kommando för att skapa projektet:

   ./mvnw clean package
   

4. Kör exempelprojektet lokalt med hjälp av följande kommando:

   ./mvnw spring-boot:run
   

Använd följande steg för att initiera programmet från Azure Developer CLI-mallarna.

1. Öppna en terminal, skapa en tom mapp och ändra sedan katalogen till den.

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

   azd init --template spring-guides/gs-spring-boot-for-azure
   

   I följande lista beskrivs kommandointeraktionerna:

   • OAuth2-inloggning: Du måste auktorisera inloggningen till Azure baserat på OAuth2-protokollet.
   • Ange ett nytt miljönamn: Ange ett miljönamn som används som suffix för resursgruppen som skapats 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 Azure Spring Apps-instans

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

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
   Prenumeration	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.
   Name	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	Prisplanen som avgör vilken resurs och kostnad 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	Anger om du vill 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.

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.

   

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

Använd följande steg för att skapa de resurser som krävs:

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 sedan 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 dem i 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 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å n för att skapa en ny app.
   • Ange appnamnet (demo): Ange ett appnamn. Om du använder standardprojektets artefakt-ID trycker du på Retur direkt.
   • Exponera offentlig åtkomst för den här appen (boot-for-azure): Tryck på y.
   • 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
   [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:UNREGISTERED
   [INFO]   InstanceName:demo-default-x-xxxxxxxxx-xxxxx  Status:Terminating Reason:null       DiscoverStatus:UNREGISTERED
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
   

Använd följande steg för att paketera appen, etablera de Azure-resurser som krävs av webbappen och distribuera sedan 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 dem i följande exempel:

   Deploying services (azd deploy)
   
   (✓) Done: Deploying service demo
   - Endpoint: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io/
   
   
   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 lanseringssidan spring-cloud-azure-tools på GitHub. Inga lokala förberedelsesteg krävs.

Använd följande steg för att förbereda projektet:

1. Använd följande kommando för att klona Spring Boot-exempelprojektet för Azure från GitHub.

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. Använd följande kommando för att flytta till projektmappen:

   cd gs-spring-boot-for-azure/complete
   

3. Använd följande Maven-kommando för att skapa projektet:

   ./mvnw clean package
   

4. Kör exempelprojektet lokalt med hjälp av följande kommando:

   ./mvnw spring-boot:run
   

Använd följande steg för att förbereda projektet:

1. Använd följande kommando för att klona Spring Boot-exempelprojektet för Azure från GitHub.

   git clone https://github.com/spring-guides/gs-spring-boot-for-azure.git
   

2. Använd följande kommando för att flytta till projektmappen:

   cd gs-spring-boot-for-azure/complete
   

3. Använd följande Maven-kommando för att skapa projektet:

   ./mvnw clean package
   

4. Kör exempelprojektet lokalt med hjälp av följande kommando:

   ./mvnw spring-boot:run
   

Använd följande steg för att skapa projektet:

1. Använd följande kommando för att generera ett exempelprojekt från start.spring.io med de rekommenderade beroendena för Azure Spring Apps:

   curl https://start.spring.io/starter.tgz -d dependencies=web -d baseDir=demo -d bootVersion=3.0.0 -d javaVersion=17 -d type=maven-project -d groupId=com.example -d artifactId=demo -d name=demo -d packageName=com.example.demo -d packaging=jar | tar -xzvf -
   

2. Skapa en webbstyrenhet för webbprogrammet genom att lägga till filen src/main/java/com/example/demo/HelloController.java med följande innehåll:

   package com.example.demo;
   
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @RestController
   public class HelloController {
   
       @RequestMapping("/")
       public String index() {
           return "Hello World";
        }
   }
   

3. Använd följande Maven-kommando för att skapa projektet:

   ./mvnw clean package
   

4. Kör exempelprojektet lokalt med hjälp av följande kommando:

   ./mvnw spring-boot:run
   

Följ stegen i avsnittet Innan du börjar med Java i Azure Spring Apps för att förbereda Spring-projektet.

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 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.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 LOCATION="<region>"
export RESOURCE_GROUP="<resource-group-name>"
export SERVICE_NAME="<Azure-Spring-Apps-instance-name>"
export APP_NAME="demo"

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 namnområdet: : Microsoft.SaaS

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

3.4. Skapa en Azure Spring Apps-instans

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

1. Använd följande kommando för att godkänna de juridiska villkoren och sekretesspolicyerna för Enterprise-planen:

   Kommentar

   Det här steget är bara nödvändigt om din prenumeration aldrig har använts för att skapa en Enterprise-planinstans av Azure Spring Apps.

   az term accept \
       --publisher vmware-inc \
       --product azure-spring-cloud-vmware-tanzu-2 \
       --plan asa-ent-hr-mtr
   

2. Använd följande kommando för att skapa en Azure Spring Apps-tjänstinstans:

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

3.5. Skapa en app i din Azure Spring Apps-instans

En app är en abstraktion av en affärsapp. Mer information finns i App och distribution i Azure Spring Apps. Appar körs i en Azure Spring Apps-tjänstinstans, enligt följande diagram.

Använd följande kommando för att skapa appen i Azure Spring Apps:

az spring app create \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --assign-endpoint true

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

Om du vill skapa en Azure Spring Apps-instans följer du stegen i avsnittet Skapa en app i Azure Spring Apps i Java i Azure Spring Apps.

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å n för att skapa en ny app.
   • Ange appnamnet (demo): Ange ett appnamn. Om du använder standardprojektets artefakt-ID trycker du på Retur direkt.
   • Exponera offentlig åtkomst för den här appen (boot-for-azure): Tryck på y.
   • 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
   [INFO]   InstanceName:demo-default-x-xxxxxxxxxx-xxxxx  Status:Running Reason:null       DiscoverStatus:N/A
   [INFO] Getting public url of app(demo)...
   [INFO] Application url: https://<your-Azure-Spring-Apps-instance-name>-demo.azuremicroservices.io
   

Använd följande kommando för att distribuera .jar-filen för appen:

az spring app deploy \
    --service ${SERVICE_NAME} \
    --name ${APP_NAME} \
    --artifact-path target/demo-0.0.1-SNAPSHOT.jar

Det kan ta några minuter att distribuera programmet.

Det här avsnittet innehåller stegen för att distribuera ditt program till Azure Spring Apps.

4.1. Importera projektet

Använd följande steg för att importera projektet:

1. Öppna IntelliJ IDEA och välj Öppna.

2. I dialogrutan Öppna fil eller projekt väljer du demomappen.

   

4.2. Skapa och distribuera din app

Använd följande steg för att skapa och distribuera din app:

1. Om du inte redan har installerat Azure Toolkit for IntelliJ följer du stegen i Installera Azure Toolkit for IntelliJ.

   Kommentar

   Azure Toolkit for IntelliJ tillhandahåller fyra sätt att logga in på Azure och distributionen kan bara starta efter inloggning.

2. Högerklicka på projektet i fönstret IntelliJ-projekt och välj sedan Azure -Deploy to Azure Spring Apps (Azure ->Deploy to Azure Spring Apps).

   

3. Acceptera namnet på appen i fältet Namn . Namnet refererar till konfigurationen, inte appnamnet. Du behöver vanligtvis inte ändra det.

4. I textrutan Artefakt väljer du Maven:demo(Java 17).

5. I textrutan Prenumeration kontrollerar du att din prenumeration är korrekt.

6. I textrutan Spring Apps väljer du den instans av Azure Spring Apps som du skapade.

7. I textrutan App väljer du plustecknet (+) för att skapa en ny app.

   

8. I textrutan Appnamn: under App Basics anger du demo och väljer sedan Fler inställningar.

9. Välj knappen Aktivera bredvid Offentlig slutpunkt. Knappen ändras till Inaktivera för att aktiveras><. Välj sedan OK.

   

10. Under Före start väljer du Kör Maven-målet demo:package och väljer sedan pennikonen för att redigera kommandoraden.

    

11. I textrutan Kommandorad anger du -DskipTests efter paket och väljer sedan OK.

    

12. Starta distributionen genom att välja knappen Kör längst ned i dialogrutan Distribuera till Azure . Plugin-programmet kör Maven-kommandot package -DskipTests i demo appen och distribuerar den .jar fil som genereras av package kommandot.

Det kan ta några minuter att distribuera programmet. Du kan se programmets offentliga URL i utdatakonsolloggen.

Om du vill distribuera appen till Azure Spring Apps följer du stegen i avsnittet Skapa och distribuera appen i Java i Azure Spring Apps.

När distributionen är klar letar du reda på program-URL:en från distributionsutdata. Använd följande steg för att verifiera:

1. Få åtkomst till programmets URL från sidan Utdata i distributionen. När du öppnar appen får du svaret Hello World.

   

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

När distributionen är klar får du åtkomst till programmet med url:en för utdataprogrammet. Använd följande steg för att kontrollera appens loggar för att undersöka eventuella distributionsproblem:

1. Få åtkomst till url:en för utdataprogrammet från sidan Utdata i distributionen. När du öppnar appen får du svaret Hello World.

   

2. I navigeringsfönstret på azure Spring Apps-instansens översiktssida väljer du Loggar för att kontrollera appens loggar.

   

När distributionen är klar får du åtkomst till programmet med utdataslutpunkten. När du öppnar appen får du svaret Hello World.

När distributionen är klar använder du följande steg för att hitta program-URL:en från distributionsutdata:

1. Få åtkomst till programmets URL från sidan Utdata i distributionen. När du öppnar appen får du svaret Hello World.

   

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

När distributionen är klar använder du följande steg för att kontrollera appens loggar för att undersöka eventuella distributionsproblem:

1. Få åtkomst till programmets URL från sidan Utdata i distributionen. När du öppnar appen får du svaret Hello World.

   

2. I navigeringsfönstret på översiktssidan för Azure Spring Apps-instansen väljer du Loggar för att kontrollera appens loggar.

   

När distributionen är klar får du åtkomst till programmet med utdataslutpunkten. När du öppnar appen får du svaret Hello World.

När distributionen är klar använder du följande steg för att hitta program-URL:en från distributionsutdata:

1. Få åtkomst till programmets URL från sidan Utdata i distributionen. När du öppnar appen får du svaret Hello World.

   

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

När distributionen är klar använder du följande steg för att verifiera appen:

1. Få åtkomst till programmets URL. När du öppnar appen får du svaret Hello World.

2. Kontrollera konsolloggarna, som är användbara för att undersöka eventuella distributionsproblem.

När distributionen är klar använder du följande steg för att kontrollera appens loggar för att undersöka eventuella distributionsproblem:

1. Få åtkomst till programmet med url:en för utdataprogrammet. När du öppnar appen får du svaret Hello World.

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

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

Använd följande steg för att strömma programloggarna:

1. Få åtkomst till programmet med url:en för utdataprogrammet. När du öppnar appen får du svaret Hello World.

2. Öppna Fönstret Azure Explorer, expandera noden Azure, expandera tjänstnoden Azure Spring Apps, expandera Azure Spring Apps-instansen som du skapade och välj sedan demoinstansen av appen som du skapade.

3. Högerklicka och välj Starta direktuppspelningsloggar och välj sedan OK för att se programloggar i realtid.

   

Använd följande steg för att strömma programloggarna:

1. Få åtkomst till programmet med url:en för utdataprogrammet. När du öppnar appen får du svaret Hello World.

2. Följ stegen i avsnittet Strömma programloggar i Java i Azure Spring Apps.

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

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änstinstansen:

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 resursgruppen med hjälp av Azure CLI:

az group delete --name ${RESOURCE_GROUP}

Använd följande steg för att ta bort resursgruppen med hjälp av IntelliJ:

1. Gå till Intellij IDEA och leta reda på namnet på resursgruppen.

2. Högerklicka på resursgruppen och välj Ta bort för att ta bort alla relaterade Azure-resurser.

Använd följande steg för att ta bort resursgruppen med hjälp av Visual Studio Code:

1. Gå till Visual Studio Code, välj Gruppera efter för att aktivera Gruppera efter resursgrupp och leta upp namnet på resursgruppen.

2. Högerklicka på resursgruppen och välj Ta bort resursgrupp... för att ta bort alla relaterade Azure-resurser.

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

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änstinstansen:

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 kommandointeraktionen:

• Totalt antal resurser att ta bort: <your-resources-total>, är du säker på att du vill fortsätta?: Tryck på y.

Konsolen matar ut meddelanden som liknar följande exempel:

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