Quickstart: Een Java Spring Boot-app implementeren in Azure Service Fabric

Artikel
06/01/2023

In deze quickstart implementeert u een Java Spring Boot-toepassing in Azure Service Fabric met behulp van vertrouwde opdrachtregelprogramma's in Linux of macOS. Azure Service Fabric is een platform voor gedistribueerde systemen voor het implementeren en distribueren van microservices en containers.

Het voorbeeld downloaden

Voer in een terminalvenster de volgende opdracht uit om het Aan de slag-voorbeeld voor Spring Boot te klonen op de lokale computer.

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

De Spring Boot-toepassing compileren

Voer in de map gs-spring-boot/complete de onderstaande opdracht uit om de toepassing te compileren

./gradlew build

De Spring Boot-toepassing inpakken

Voer in de map gs-spring-boot van uw kloon de opdracht yo azuresfguest uit.
Voer de volgende details in voor elke prompt.
Maak in de map SpringServiceFabric/SpringServiceFabric/SpringGettingStartedPkg/code een bestand met de naam entryPoint.sh. Voeg de volgende code toe aan het entryPoint.sh-bestand.
```
#!/bin/bash
BASEDIR=$(dirname $0)
cd $BASEDIR
java -jar *spring-boot*.jar
```

Voeg de Eindpunten-resource toe aan het bestand gs-spring-boot/SpringServiceFabric/SpringServiceFabric/SpringGettingStartedPkg/ServiceManifest.xml

    <Resources>
      <Endpoints>
        <Endpoint Name="WebEndpoint" Protocol="http" Port="8080" />
      </Endpoints>
   </Resources>

De ServiceManifest.xml ziet er nu als volgt uit:

<?xml version="1.0" encoding="utf-8"?>
<ServiceManifest Name="SpringGettingStartedPkg" Version="1.0.0"
                 xmlns="http://schemas.microsoft.com/2011/01/fabric" xmlns:xsd="https://www.w3.org/2001/XMLSchema" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" >

   <ServiceTypes>
      <StatelessServiceType ServiceTypeName="SpringGettingStartedType" UseImplicitHost="true">
   </StatelessServiceType>
   </ServiceTypes>

   <CodePackage Name="code" Version="1.0.0">
      <EntryPoint>
         <ExeHost>
            <Program>entryPoint.sh</Program>
            <Arguments></Arguments>
            <WorkingFolder>CodePackage</WorkingFolder>
         </ExeHost>
      </EntryPoint>
   </CodePackage>
    <Resources>
      <Endpoints>
        <Endpoint Name="WebEndpoint" Protocol="http" Port="8080" />
      </Endpoints>
   </Resources>
 </ServiceManifest>

In dit stadium hebt u een Service Fabric-toepassing voor het Spring Boot Aan de slag-voorbeeld gemaakt die u kunt implementeren in Service Fabric.

De toepassing lokaal uitvoeren

Start het lokale cluster op Ubuntu-computers door de volgende opdracht uit te voeren:
```
sudo /opt/microsoft/sdk/servicefabric/common/clustersetup/devclustersetup.sh
```
Als u een Mac gebruikt, start u het lokale cluster vanuit de Docker-installatiekopie (hierbij wordt verondersteld dat is voldaan aan de vereisten voor het instellen van het lokale cluster voor Mac).
```
docker run --name sftestcluster -d -p 19080:19080 -p 19000:19000 -p 25100-25200:25100-25200 -p 8080:8080 mysfcluster
```
Het starten van het lokale cluster kan enige tijd duren. Open Service Fabric Explorer op http://localhost:19080 om te controleren of het cluster volledig naar behoren functioneert. Als de vijf knooppunten in orde zijn, is het lokale cluster actief.
Open de map gs-spring-boot/SpringServiceFabric.
Voer de volgende opdracht uit om verbinding te maken met het lokale cluster.
```
sfctl cluster select --endpoint http://localhost:19080
```
Voer het script install.sh uit.
```
./install.sh
```
Open uw favoriete webbrowser en open de toepassing op http://localhost:8080.

U hebt nu toegang tot de Spring Boot-toepassing die werd geïmplementeerd in een Service Fabric-cluster.

Zie het Aan de slag-voorbeeld voor Spring Boot op de Spring-website voor meer informatie.

Toepassingen en services voor schalen in een cluster

Services kunnen eenvoudig worden geschaald in een cluster om een wijziging in de belasting voor de services aan te kunnen. U schaalt een service door het aantal exemplaren te wijzigen dat wordt uitgevoerd in het cluster. Er zijn veel manieren waarop u services kunt schalen. U kunt bijvoorbeeld scripts of opdrachten van Service Fabric CLI (sfctl) gebruiken. In de volgende stappen wordt Service Fabric Explorer gebruikt.

Service Fabric Explorer kan worden uitgevoerd in alle Service Fabric-clusters en is toegankelijk door vanuit een browser te bladeren naar de HTTP-beheerpoort (19080) van het cluster, bijvoorbeeld http://localhost:19080.

Voer de volgende stappen uit om de web-front-endservice te schalen:

Open Service Fabric Explorer in het cluster - bijvoorbeeld: http://localhost:19080.
Selecteer het beletselteken (...) naast het knooppunt fabric:/SpringServiceFabric/SpringGettingStarted in de structuurweergave en selecteer Service schalen.

U kunt er nu voor kiezen om het aantal exemplaren van de service te schalen.

Wijzig het aantal in 3 en selecteer Service schalen.

Een alternatieve manier om de service te schalen met behulp van de opdrachtregel gaat als volgt.

# Connect to your local cluster
sfctl cluster select --endpoint https://<ConnectionIPOrURL>:19080 --pem <path_to_certificate> --no-verify

# Run Bash command to scale instance count for your service
sfctl service update --service-id 'SpringServiceFabric~SpringGettingStarted' --instance-count 3 --stateless

Selecteer het knooppunt fabric:/SpringServiceFabric/SpringGettingStartedt in de structuurweergave en vouw het partitieknooppunt uit (vertegenwoordigd door een GUID).

De service heeft drie exemplaren en de structuurweergave laat zien op welke knooppunten de exemplaren worden uitgevoerd.

Met deze eenvoudige beheertaak hebt u het aantal beschikbare resources voor het verwerken van gebruikersbelasting voor de front-endservice verdubbeld. Het is belangrijk te weten dat u niet meerdere exemplaren van een service nodig hebt om ervoor te zorgen dat deze op betrouwbare wijze wordt uitgevoerd. Als de service mislukt, wordt in Service Fabric een nieuw exemplaar van de service uitgevoerd in het cluster.

Failoverservices in een cluster

Het opnieuw opstarten van een knooppunt kan worden gesimuleerd met behulp van Service Fabric Explorer om failover van de service te demonstreren. Zorg ervoor dat maar één exemplaar van de service wordt uitgevoerd.

Open Service Fabric Explorer in het cluster - bijvoorbeeld: http://localhost:19080.
Selecteer het beletselteken (...) naast het knooppunt waarop het service-exemplaar wordt uitgevoerd, en start het knooppunt opnieuw.
Het service-exemplaar wordt naar een ander knooppunt verplaatst en er treedt geen downtime op voor de toepassing.