Quickstart: Uw eerste toepassing implementeren in Azure Spring Apps

Notitie

De eerste 50 vCPU-uren en 100 GB-uren aan geheugen zijn elke maand gratis. Zie Prijsverlaging - Azure Spring Apps doet meer, kost minder! op de Blog Apps op Azure voor meer informatie.

Notitie

Azure Spring Apps is de nieuwe naam voor de Azure Spring Cloud-service. Hoewel de service een nieuwe naam heeft, ziet u de oude naam een tijdje op sommige plaatsen terwijl we assets, zoals schermopnamen, video's en diagrammen, bijwerken.

Dit artikel is van toepassing op: ✔️ Enterprise-laag Basic/Standard-laag ✔️

In deze quickstart wordt uitgelegd hoe u een kleine toepassing implementeert om uit te voeren in Azure Spring Apps.

De toepassingscode die in deze zelfstudie wordt gebruikt, is een eenvoudige app. Wanneer u dit voorbeeld hebt voltooid, is de toepassing online toegankelijk en kunt u deze beheren via de Azure Portal.

In deze quickstart wordt het volgende uitgelegd:

• Genereer een eenvoudig Spring-project.
• Een service-exemplaar inrichten.
• Bouw en implementeer een app met een openbaar eindpunt.
• Resources opschonen.

Aan het einde van deze quickstart hebt u een werkende spring-app die wordt uitgevoerd in Azure Spring Apps.

Azure-CLI

Vereisten

• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account aan voordat u begint.
• Azure CLI. Installeer de Azure Spring Apps-extensie met de volgende opdracht: az extension add --name spring
• Als u de Azure Spring Apps Enterprise-laag voor het eerst implementeert in het doelabonnement, raadpleegt u de sectie Vereisten van Azure Spring Apps Enterprise-laagaanbieding weergeven in Azure Marketplace.

Een exemplaar van Azure Spring Apps inrichten

Gebruik de volgende stappen om een service-exemplaar in te richten.

1. Selecteer Uitproberen en meld u aan bij uw Azure-account in Azure Cloud Shell.

   az account show
   

2. Azure Cloud Shell-werkruimten zijn tijdelijk. Bij de eerste start wordt u in de shell gevraagd om een Azure Storage-exemplaar te koppelen aan uw abonnement om bestanden in verschillende sessies te behouden.

   

3. Nadat u zich hebt aangemeld, gebruikt u de volgende opdracht om een lijst met uw abonnementen weer te geven.

   az account list --output table
   

4. Gebruik de volgende opdracht om uw abonnement te kiezen en er een koppeling naar te maken.

   az account set --subscription <subscription-id>
   

5. Gebruik de volgende opdracht om een resourcegroep te maken.

   az group create \
       --resource-group <name-of-resource-group> \
       --location eastus
   

6. Gebruik de volgende opdracht om een Azure Spring Apps-service-exemplaar te maken.

   az spring create \
       --resource-group <name-of-resource-group> \
       --name <service-instance-name>
   

7. Kies Y om de Azure Spring Apps-extensie te installeren en uit te voeren.

Een app maken in uw Azure Spring Apps-exemplaar

Gebruik de volgende opdracht om de naam van de app in Azure Spring Apps op te geven als hellospring.

az spring app create \
    --resource-group <name-of-resource-group> \
    --service <service-instance-name> \
    --name hellospring \
    --assign-endpoint true

Het Spring Boot-voorbeeldproject klonen en bouwen

Gebruik de volgende stappen om het Spring Boot-voorbeeldproject te klonen.

1. Gebruik de volgende opdracht om het Spring Boot-voorbeeldproject te klonen vanuit GitHub.

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

2. Gebruik de volgende opdracht om naar de projectmap te gaan.

   cd gs-spring-boot/complete
   

3. Gebruik de volgende Maven-opdracht om het project te bouwen.

   mvn clean package -DskipTests
   

De lokale app implementeren in Azure Spring Apps

Gebruik de volgende opdracht om het JAR-bestand voor de app te implementeren (target/spring-boot-complete-0.0.1-SNAPSHOT.jar in Windows).

az spring app deploy \
    --resource-group <name-of-resource-group> \
    --service <service-instance-name> \
    --name hellospring \
    --artifact-path target/spring-boot-complete-0.0.1-SNAPSHOT.jar

Het implementeren van de toepassing kan enkele minuten duren.

IntelliJ

Vereisten

• Een Azure-abonnement. Als u geen abonnement hebt, maakt u een gratis account aan voordat u begint.
• IntelliJ IDEA.
• Azure-toolkit voor IntelliJ.
• Als u de Azure Spring Apps Enterprise-laag voor het eerst implementeert in het doelabonnement, raadpleegt u de sectie Vereisten van Azure Spring Apps Enterprise-laagaanbieding weergeven in Azure Marketplace.

Een Spring-project genereren

Gebruik de volgende stappen om het project te maken:

1. Gebruik Spring Initializr om een voorbeeldproject te genereren met aanbevolen afhankelijkheden voor Azure Spring Apps. De volgende URL bevat standaardinstellingen voor u.

https://start.spring.io/#!type=maven-project&language=java&platformVersion=2.6.10&packaging=jar&jvmVersion=11&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 Initializr-instellingen voor het hellospring-voorbeeldproject .

In dit voorbeeld wordt Java versie 11 gebruikt. Als u een andere Java-versie wilt gebruiken, wijzigt u de java-versie-instelling onder Projectmetagegevens.

1. Wanneer alle afhankelijkheden zijn ingesteld, selecteert u Genereren.

2. Download en pak het pakket uit en maak vervolgens een webcontroller voor uw webtoepassing door het bestand src/main/java/com/example/hellospring/HelloController.java toe te voegen 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!";
       }
   
   }
   

Een exemplaar van Azure Spring Apps inrichten

Gebruik de volgende stappen om een exemplaar van Azure Spring Apps te maken met behulp van de 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 waarvoor u voor deze resource gefactureerd wilt worden.
   • Resourcegroep: Het is een best practice om nieuwe resourcegroepen te maken voor nieuwe resources.
   • Servicenaam: geef de naam van het service-exemplaar op. U gebruikt deze naam verderop in dit artikel waar de <tijdelijke aanduiding service-exemplaarnaam> wordt weergegeven. 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.
   • Regio: Selecteer de regio voor uw service-exemplaar.

   

6. Selecteer Controleren en maken.

Het project importeren

Gebruik de volgende stappen om het project te importeren.

1. Open IntelliJ IDEA en selecteer Vervolgens Openen.

2. Selecteer in het dialoogvenster Bestand of Project openen de map hellospring .

   

Uw app bouwen en implementeren

Notitie

Als u het project lokaal wilt uitvoeren, voegt u toe spring.config.import=optional:configserver: aan het bestand application.properties van het project.

Gebruik de volgende stappen om uw app te bouwen en te implementeren.

1. Als u de Azure-toolkit voor IntelliJ nog niet hebt geïnstalleerd, volgt u de stappen in De Azure-toolkit voor IntelliJ installeren.

2. Klik met de rechtermuisknop op uw project in het venster IntelliJ Project en selecteer vervolgens Azure ->Implementeren naar Azure Spring Apps.

   

3. Accepteer de naam voor de app in het veld Naam . Naam verwijst naar de configuratie, niet naar de naam van de app. Meestal hoeft u dit niet te wijzigen.

4. Selecteer maven:com.example:hellospring-0.0.1-SNAPSHOT in het tekstvak Artefact.

5. Controleer in het tekstvak Abonnement of uw abonnement juist is.

6. Selecteer in het tekstvak Service het exemplaar van Azure Spring Apps dat u hebt gemaakt in Een exemplaar van Azure Spring Apps inrichten.

7. Selecteer in het tekstvak App het plusteken (+) om een nieuwe app te maken.

   

8. Voer in het tekstvak App-naam: onder Basisbeginselen van apphellospring in en schakel vervolgens het selectievakje Meer instellingen in.

9. Selecteer de knop Inschakelen naast Openbaar eindpunt. De knop verandert in Uitschakelen <om ingeschakeld te zijn>.

10. Als u Java 11 gebruikt, selecteert u Java 11 voor de optie Runtime .

11. Selecteer OK.

    

12. Selecteer onder Voor het startende optie Maven-doel 'hellospring:package' uitvoeren en selecteer vervolgens het potloodpictogram om de opdrachtregel te bewerken.

    

13. Voer in het tekstvak Opdrachtregel-DskipTests na pakket in en selecteer OK.

    

14. Als u de implementatie wilt starten, selecteert u de knop Uitvoeren onderaan het dialoogvenster Azure Spring Apps-app implementeren . De invoegtoepassing voert de opdracht mvn package -DskipTests uit op de hellospring app en implementeert het JAR-bestand dat door de package opdracht is gegenereerd.

Visual Studio Code

Vereisten

• Als u de Azure Spring Apps Enterprise-laag voor het eerst implementeert in het doelabonnement, raadpleegt u de sectie Vereisten van Azure Spring Apps Enterprise-laagaanbieding weergeven in Azure Marketplace.

Een Spring Boot-web-app implementeren in Azure Spring Apps met Visual Studio Code

Als u een Spring Boot-web-app wilt implementeren in Azure Spring Apps, volgt u de stappen in Java in Azure Spring Apps.

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

Resources opschonen

Als u van plan bent om verder te gaan met volgende snelstarts en zelfstudies, kunt u deze resources het beste intact laten. Wanneer u de resources niet meer nodig hebt, verwijdert u ze door de resourcegroep te verwijderen. Gebruik de volgende opdrachten om de resourcegroep te verwijderen:

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

Volgende stappen

In deze quickstart hebt u geleerd hoe u een eenvoudig Spring-project kunt genereren, een service-exemplaar kunt inrichten, een app met een openbaar eindpunt kunt bouwen en implementeren en de resources kunt opschonen.

U hebt ook toegang tot krachtige logboeken, metrische gegevens en gedistribueerde traceringsmogelijkheden van de Azure Portal. Zie Quickstart: Azure Spring Apps-apps bewaken met logboeken, metrische gegevens en tracering voor meer informatie.

Als u wilt weten hoe u meer mogelijkheden van Azure Spring kunt gebruiken, gaat u verder met de quickstart-reeks waarmee een voorbeeldtoepassing wordt geïmplementeerd in Azure Spring Apps:

Inleiding tot de voorbeeld-app

Zie Spring Boot PetClinic Microservices Application Deployed to Azure Spring Apps (Spring Boot PetClinic Microservices Application Deployed to Azure Spring Apps) voor een app-sjabloon met azure Spring Apps-infrastructuur die is ingericht met Bicep.

Meer voorbeelden zijn beschikbaar op GitHub: Azure Spring Apps-voorbeelden.