Spring Boot-toepassingen implementeren met Maven

Dit artikel is van toepassing op:✅ Java ❎ C#

Dit artikel is van toepassing op:✅ Basic/Standard ✅ Enterprise

In dit artikel leest u hoe u de Azure Spring Apps Maven-invoegtoepassing gebruikt om toepassingen te configureren en te implementeren in Azure Spring Apps.

Vereisten

• Een Azure-account met een actief abonnement. Gratis een account maken
• Een al ingericht Azure Spring Apps-exemplaar.
• JDK 8 of JDK 11
• Apache Maven
• Azure CLI versie 2.45.0 of hoger met de Azure Spring Apps-extensie. U kunt de extensie installeren met behulp van de volgende opdracht: az extension add --name spring

Een Spring-project genereren

Als u een Spring-project wilt maken voor gebruik in dit artikel, gebruikt u de volgende stappen:

1. Navigeer naar Spring Initializr om een voorbeeldproject te genereren met de aanbevolen afhankelijkheden voor Azure Spring Apps. Deze koppeling gebruikt de volgende URL om standaardinstellingen voor u op te geven.

   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
   

   In de volgende afbeelding ziet u de aanbevolen Spring Initializr-installatie voor dit voorbeeldproject.

   

   In dit voorbeeld wordt Java-versie 8 gebruikt. Als u Java versie 11 wilt gebruiken, wijzigt u de optie onder ProjectMetagegevens.

2. Selecteer Genereren wanneer alle afhankelijkheden zijn ingesteld.

3. Download en pak het pakket uit en maak vervolgens een webcontroller voor een webtoepassing. Voeg het bestand src/main/java/com/example/hellospring/HelloController.java toe met de volgende inhoud:

   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!";
       }
   
   }
   

Spring-toepassingen lokaal bouwen

Voer de volgende opdrachten uit om het project te bouwen met behulp van Maven:

cd hellospring
mvn clean package -DskipTests -Denv=cloud

Het compileren van het project duurt enkele minuten. Nadat dit is voltooid, moet u afzonderlijke JAR-bestanden voor elke service in hun respectieve mappen hebben.

Een exemplaar van Azure Spring Apps inrichten

Met de volgende procedure maakt u een exemplaar van Azure Spring Apps met behulp van Azure Portal.

1. Open Azure Portal op een nieuw tabblad.

2. Zoek in het bovenste zoekvak naar Azure Spring Apps.

3. Selecteer Azure Spring Apps in de resultaten.

4. Selecteer Maken op de pagina Azure Spring Apps.

   

5. Vul het formulier in op de pagina Azure Spring Apps Maken . Houd rekening met de volgende richtlijnen:

   • Abonnement: Selecteer het abonnement dat u wilt factureren voor deze resource.
   • Resourcegroep: Het maken van nieuwe resourcegroepen voor nieuwe resources is een goede werkwijze. U zult deze resourcegroep in latere stappen gebruiken als <resourcegroepnaam>.
   • Servicedetails/-naam: geef de naam<>service-exemplaar op. De naam moet tussen de 4 en 32 tekens lang zijn en mag alleen kleine letters, cijfers en afbreekstreepjes bevatten. Het eerste teken van de servicenaam moet een letter zijn en het laatste teken moet een letter of een cijfer zijn.
   • Locatie: Selecteer de regio voor uw service-exemplaar.

   

6. Selecteer Overzicht en aanmaken.

Configuraties genereren en implementeren in De Azure Spring Apps

Voer de volgende stappen uit om configuraties te genereren en de app te implementeren:

1. Voer de volgende opdracht uit vanuit de hoofdmap hellospring , die het POM-bestand bevat. Als u zich al hebt aangemeld met Azure CLI, zal de opdracht automatisch de referenties ophalen. Anders zal de opdracht u vragen om inloginstructies te volgen. Zie Verificatie in de opslagplaats azure-maven-plugins op GitHub voor meer informatie.

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

   U wordt gevraagd het volgende te selecteren:

   • Abonnements-id : het abonnement dat u hebt gebruikt om een Azure Spring Apps-exemplaar te maken.
   • Service-exemplaar : de naam van uw Azure Spring Apps-exemplaar.
   • App-naam : een app-naam van uw keuze of gebruik de standaardwaarde artifactId.
   • Openbaar eindpunt - true om de app beschikbaar te maken voor publieke toegang; anders false.

2. Controleer of het element in het appName POM-bestand de juiste waarde heeft. Het relevante gedeelte van het POM-bestand moet er ongeveer uitzien als in het volgende voorbeeld.

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

   Het POM-bestand bevat nu de afhankelijkheden en configuraties van de invoegtoepassing.

3. Implementeer de app met behulp van de volgende opdracht.

   mvn azure-spring-apps:deploy
   

De services controleren

Nadat de implementatie is voltooid, hebt u toegang tot de app op https://<service instance name>-hellospring.azuremicroservices.io/.

Middelen opschonen

Als u van plan bent om door te gaan met de voorbeeldtoepassing, wilt u de resources mogelijk behouden. Wanneer u deze niet meer nodig hebt, verwijdert u de resourcegroep met uw Azure Spring Apps-exemplaar. Als u de resourcegroep wilt verwijderen met behulp van Azure CLI, gebruikt u de volgende opdrachten:

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

Volgende stappen

• Spring-toepassing voorbereiden voor Azure Spring Apps
• Meer informatie over de Azure Spring Apps Maven-invoegtoepassing