Distribuera Spring Boot-program med Maven

Kommentar

Azure Spring Apps är det nya namnet på Azure Spring Cloud-tjänsten. Även om tjänsten har ett nytt namn ser du det gamla namnet på vissa platser ett tag medan vi arbetar med att uppdatera tillgångar som skärmbilder, videor och diagram.

Den här artikeln gäller för: ✔️ Java ❌ C#

Den här artikeln gäller för: ✔️ Basic/Standard ✔️ Enterprise

Den här artikeln visar hur du använder Plugin-programmet Azure Spring Apps Maven för att konfigurera och distribuera program till Azure Spring Apps.

Förutsättningar

• Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
• En redan etablerad Azure Spring Apps-instans.
• JDK 8 eller JDK 11
• Apache Maven
• Azure CLI version 2.45.0 eller senare med Azure Spring Apps-tillägget. Du kan installera tillägget med hjälp av följande kommando: az extension add --name spring

Generera ett Spring-projekt

Använd följande steg för att skapa ett Spring-projekt för användning i den här artikeln:

1. Gå till Spring Initializr för att generera ett exempelprojekt med de rekommenderade beroendena för Azure Spring Apps. Den här länken använder följande URL för att ange standardinställningar åt dig.

   https://start.spring.io/#!type=maven-project&language=java&platformVersion=2.5.7&packaging=jar&jvmVersion=1.8&groupId=com.example&artifactId=hellospring&name=hellospring&description=Demo%20project%20for%20Spring%20Boot&packageName=com.example.hellospring&dependencies=web,cloud-eureka,actuator,cloud-config-client
   

   Följande bild visar den rekommenderade Spring Initializr-installationen för det här exempelprojektet.

   

   I det här exemplet används Java version 8. Om du vill använda Java version 11 ändrar du alternativet under Projektmetadata.

2. Välj Generera när alla beroenden har angetts.

3. Ladda ned och packa upp paketet och skapa sedan en webbstyrenhet för ett webbprogram. Lägg till filen src/main/java/com/example/hellospring/HelloController.java med följande innehåll:

   package com.example.hellospring;
   
   import org.springframework.web.bind.annotation.RestController;
   import org.springframework.web.bind.annotation.RequestMapping;
   
   @RestController
   public class HelloController {
   
       @RequestMapping("/")
       public String index() {
           return "Greetings from Azure Spring Apps!";
       }
   
   }
   

Skapa Spring-programmen lokalt

Kör följande kommandon för att skapa projektet med hjälp av Maven:

cd hellospring
mvn clean package -DskipTests -Denv=cloud

Det tar flera minuter att kompilera projektet. När den är klar bör du ha enskilda JAR-filer för varje tjänst i respektive mappar.

Etablera en instans av Azure Spring Apps

Följande procedur skapar en instans av Azure Spring Apps med hjälp av Azure-portalen.

1. Öppna Azure-portalen på en ny flik.

2. Sök efter Azure Spring Apps i den översta sökrutan.

3. Välj Azure Spring Apps i resultatet.

   

4. På sidan Azure Spring Apps väljer du Skapa.

   

5. Fyll i formuläret på sidan Skapa Azure Spring Apps. Läs igenom följande riktlinjer:

   • Prenumeration: Välj den prenumeration som du vill debiteras för den här resursen.
   • Resursgrupp: Det är bästa praxis att skapa nya resursgrupper för nya resurser. Du använder den här resursgruppen i senare steg som <resursgruppnamn>.
   • Tjänstinformation/namn: Ange namnet på tjänstinstansen<>. 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.
   • Plats: Välj region för din tjänstinstans.

   

6. Välj Granska och skapa.

Generera konfigurationer och distribuera till Azure Spring Apps

Följ dessa steg för att generera konfigurationer och distribuera appen:

1. Kör följande kommando från rotmappen hellospring , som innehåller POM-filen. Om du redan har loggat in med Azure CLI hämtar kommandot automatiskt autentiseringsuppgifterna. Annars uppmanas du att använda inloggningsinstruktioner för kommandot. Mer information finns i Autentisering på lagringsplatsen azure-maven-plugins på GitHub.

   mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.10.0:config
   

   Du uppmanas att välja:

   • Prenumerations-ID – den prenumeration som du använde för att skapa en Azure Spring Apps-instans.
   • Tjänstinstans – namnet på din Azure Spring Apps-instans.
   • Appnamn – ett valfritt appnamn eller använd standardvärdet artifactId.
   • Den offentliga slutpunkten - är sann för att exponera appen för offentlig åtkomst, annars falskt.

2. Kontrollera att elementet appName i POM-filen har rätt värde. Den relevanta delen av POM-filen bör se ut ungefär som i följande exempel.

   <build>
       <plugins>
           <plugin>
               <groupId>com.microsoft.azure</groupId>
               <artifactId>azure-spring-apps-maven-plugin</artifactId>
               <version>1.10.0</version>
               <configuration>
                   <subscriptionId>xxxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx</subscriptionId>
                   <clusterName>v-spr-cld</clusterName>
                   <appName>hellospring</appName>
   

   POM-filen innehåller nu plugin-beroenden och konfigurationer.

3. Distribuera appen med hjälp av följande kommando.

   mvn azure-spring-apps:deploy
   

Verifiera tjänsterna

När distributionen har slutförts kan du komma åt appen på https://<service instance name>-hellospring.azuremicroservices.io/.

Rensa resurser

Om du planerar att fortsätta arbeta med exempelprogrammet kanske du vill lämna resurserna på plats. Ta bort resursgruppen som innehåller din Azure Spring Apps-instans när den inte längre behövs. Om du vill ta bort resursgruppen med hjälp av Azure CLI använder du följande kommandon:

echo "Enter the Resource Group name:" &&
read resourceGroupName &&
az group delete --name $resourceGroupName &&
echo "Press [ENTER] to continue ..."

Nästa steg

• Förbereda Spring-programmet för Azure Spring Apps
• Läs mer om Plugin-programmet Azure Spring Apps Maven