Snabbstart: Skapa och distribuera appar till Azure Spring Apps

2025-08-19

Kommentar

Planerna Basic, Standardoch Enterprise gick in i en pensionsperiod den 17 mars 2025. Mer information finns i meddelandet om azure Spring Apps-pensionering.

Den här artikeln gäller för:✅ Basic/Standard ❎ Enterprise

Den här snabbstarten förklarar hur du skapar och distribuerar Spring-program till Azure Spring Apps med hjälp av Azure CLI.

Förutsättningar

Slutförande av tidigare snabbstarter i den här serien:
- Etablera en Azure Spring Apps-tjänstinstans.
- Konfigurera Azure Spring Apps Config Server.

Ladda ned exempelprogrammet

Använd följande steg för att ladda ned exempelappen. Om du har använt Azure Cloud Shell växlar du till en lokal kommandotolk.

Skapa en ny mapp och klona exempelapplagringsplatsen.

mkdir source-code

cd source-code

git clone https://github.com/Azure-Samples/azure-spring-apps-samples

Gå till lagringsplatsens katalog.
```
cd azure-spring-apps-samples
```

Distribuera PlanetWeatherProvider

Använd följande steg för att distribuera PlanetWeatherProvider-projektet.

Skapa en app för PlanetWeatherProvider projektet i din Azure Spring Apps-instans.
```
az spring app create --name planet-weather-provider --runtime-version NetCore_31
```
Om du vill aktivera automatisk tjänstregistrering har du gett appen samma namn som värdet spring.application.name för i projektets appsettings.json-fil :
```
"spring": {
  "application": {
    "name": "planet-weather-provider"
  }
}
```
Det kan ta flera minuter att köra det här kommandot.
Ändra katalogen till projektmappen PlanetWeatherProvider .
```
cd steeltoe-sample/src/planet-weather-provider
```

Skapa binärfilerna och .zip-filen som ska distribueras.

dotnet publish -c release -o ./publish

Tips

Projektfilen innehåller följande XML för att paketera binärfilerna i en .zip fil när du har skrivit dem till mappen ./publish :

<Target Name="Publish-Zip" AfterTargets="Publish">
  <ZipDirectory SourceDirectory="$(PublishDir)" DestinationFile="$(MSBuildProjectDirectory)/publish-deploy-planet.zip" Overwrite="true" />
</Target>

Distribuera projektet till Azure.

Kontrollera att kommandotolken finns i projektmappen innan du kör följande kommando.
```
az spring app deploy \
    --name planet-weather-provider \
    --runtime-version NetCore_31 \
    --main-entry Microsoft.Azure.SpringCloud.Sample.PlanetWeatherProvider.dll \
    --artifact-path ./publish-deploy-planet.zip
```
Alternativet --main-entry anger den relativa sökvägen från .zip-filens rotmapp till den .dll fil som innehåller programmets startpunkt. När tjänsten har laddat upp .zip-filen extraherar den alla filer och mappar och försöker sedan köra startpunkten i den angivna .dll filen.

Det kan ta flera minuter att köra det här kommandot.

Distribuera SolarSystemWeather

Använd följande steg för att distribuera Projektet SolarSystemWeather.

Skapa en annan app i din Azure Spring Apps-instans för projektet.
```
az spring app create --name solar-system-weather --runtime-version NetCore_31
```
solar-system-weather är namnet som anges i SolarSystemWeather projektets appsettings.json-fil .

Det kan ta flera minuter att köra det här kommandot.
Ändra katalogen till SolarSystemWeather projektet.
```
cd ../solar-system-weather
```
Skapa binärfiler och .zip fil som ska distribueras.
```
dotnet publish -c release -o ./publish
```

Distribuera projektet till Azure.

az spring app deploy \
    --name solar-system-weather \
    --runtime-version NetCore_31 \
    --main-entry Microsoft.Azure.SpringCloud.Sample.SolarSystemWeather.dll \
    --artifact-path ./publish-deploy-solar.zip

Det kan ta flera minuter att köra det här kommandot.

Tilldela offentlig slutpunkt

Innan du testar programmet, skaffar du en offentlig slutpunkt för en HTTP GET-begäran till solar-system-weather-programmet.

Kör följande kommando för att tilldela slutpunkten.

az spring app update --name solar-system-weather --assign-endpoint true

Kör följande kommando för att hämta slutpunktens URL.

Windows:

az spring app show --name solar-system-weather --output table

Linux:

az spring app show --name solar-system-weather | grep url

Testa programmet

Om du vill testa programmet skickar du en GET-begäran till solar-system-weather appen. I en webbläsare navigerar du till den offentliga URL:en med /weatherforecast bifogad. Till exempel: https://servicename-solar-system-weather.azuremicroservices.io/weatherforecast

Utdata är JSON:

[{"Key":"Mercury","Value":"very warm"},{"Key":"Venus","Value":"quite unpleasant"},{"Key":"Mars","Value":"very cool"},{"Key":"Saturn","Value":"a little bit sandy"}]

Det här svaret visar att båda Spring-apparna fungerar. Appen SolarSystemWeather returnerar data som den hämtade från PlanetWeatherProvider appen.

Den här artikeln beskriver hur du skapar och distribuerar Spring-program till Azure Spring Apps. Du kan använda Azure CLI, Plugin-programmet Maven eller IntelliJ. I den här artikeln beskrivs varje alternativ.

Förutsättningar

Slutförande av tidigare snabbstarter i den här serien:
- Etablera en Azure Spring Apps-tjänstinstans.
- Konfigurera Azure Spring Apps Config Server.
JDK 17
Maven 3.0 eller senare
En prenumeration på Azure Om du inte har någon prenumeration skapar du ett kostnadsfritt konto innan du börjar.
Du kan också använda Azure CLI version 2.45.0 eller senare. Installera Azure Spring Apps-tillägget med följande kommando: az extension add --name spring
Alternativt, Azure Toolkit för IntelliJ.

Skapa Spring-programmen lokalt

Använd följande kommandon för att klona exempellagringsplatsen, navigera till exempelmappen och skapa sedan projektet.

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

Det tar 5–10 minuter att kompilera projektet. När projektet kompileras bör du ha enskilda JAR-filer för varje tjänst i respektive mappar.

Skapa och distribuera appar i Azure Spring Apps

Använd följande steg för att skapa och distribuera appar i Azure Spring Apps med hjälp av CLI.

Om du inte körde följande kommandon i föregående snabbstarter kör du dem nu för att ange CLI-standardvärdena.
```
az configure --defaults group=<resource-group-name> spring=<service-name>
```

Skapa de två spring-kärnprogrammen för PetClinic: api-gateway och customers-service.

az spring app create \
    --name api-gateway \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi \
    --assign-endpoint
az spring app create \
    --name customers-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi

Distribuera JAR-filerna som skapades i föregående steg.

az spring app deploy \
    --name api-gateway \
    --artifact-path spring-petclinic-api-gateway/target/api-gateway-3.0.1.jar \
    --jvm-options="-Xms2048m -Xmx2048m"
az spring app deploy \
    --name customers-service \
    --artifact-path spring-petclinic-customers-service/target/customers-service-3.0.1.jar \
    --jvm-options="-Xms2048m -Xmx2048m"

Fråga appens status efter distributioner med följande kommando.

az spring app list --output table

Det här kommandot genererar utdata som liknar följande exempel:

Name               Location    ResourceGroup    Production Deployment    Public Url                                           Provisioning Status    CPU    Memory    Running Instance    Registered Instance    Persistent Storage
-----------------  ----------  ---------------  -----------------------  ---------------------------------------------------  ---------------------  -----  --------  ------------------  ---------------------  --------------------
api-gateway        eastus      xxxxxx-sp         default                  https://<service name>-api-gateway.azuremicroservices.io   Succeeded              1      2         1/1                 1/1                    -
customers-service  eastus      <service name>         default                                                                       Succeeded              1      2         1/1                 1/1                    -

Verifiera tjänsterna

Åtkomma api-gateway och customers-service från en webbläsare med den offentliga URL:en som visades tidigare, i formatet https://<service name>-api-gateway.azuremicroservices.io.

Tips

Om du vill felsöka distributioner kan du använda följande kommando för att hämta loggströmning i realtid när appen kör az spring app logs --name <app name> --follow.

Installera extra appar

Om du vill att PetClinic-appen ska fungera med alla funktioner som adminserver, besök och veterinärer distribuerar du de andra apparna med följande kommandon:

az spring app create \
    --name admin-server \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi \
    --assign-endpoint
az spring app create \
    --name vets-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app create \
    --name visits-service \
    --runtime-version Java_17 \
    --instance-count 1 \
    --memory 2Gi
az spring app deploy \
    --name admin-server \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-admin-server/target/admin-server-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name vets-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-vets-service/target/vets-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"
az spring app deploy \
    --name visits-service \
    --runtime-version Java_17 \
    --artifact-path spring-petclinic-visits-service/target/visits-service-3.0.1.jar \
    --jvm-options="-Xms1536m -Xmx1536m"

Skapa Spring-programmen lokalt

Använd följande kommandon för att klona exempellagringsplatsen, navigera till exempelmappen och skapa sedan projektet.

git clone https://github.com/azure-samples/spring-petclinic-microservices
cd spring-petclinic-microservices
mvn clean package -DskipTests -Denv=cloud

Det tar 5–10 minuter att kompilera projektet. När projektet kompileras bör du ha enskilda JAR-filer för varje tjänst i respektive mappar.

Generera konfigurationer och distribuera till Azure Spring Apps

Följande steg visar hur du genererar konfigurationer och distribuerar till Azure Spring Apps:

Gå till mappen spring-petclinic-customers-service . Generera konfigurationer genom att köra följande kommando. Om du redan har loggat in med Azure CLI hämtar kommandot automatiskt autentiseringsuppgifterna. Annars loggas du in med hjälp av en uppmaning med instruktioner. Mer information finns i Autentisering på wikin azure-maven-plugins .
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=customers-service
```
Du uppmanas att ange följande värden:
- Prenumeration: Den prenumeration som du använde för att skapa en Azure Spring Apps-instans.
- Tjänstinstans: Namnet på din Azure Spring Apps-instans.
- Offentlig slutpunkt: Om du vill tilldela en offentlig slutpunkt till appen. Välj Nej.

Kontrollera att elementen appName i POM-filerna är korrekta:

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

POM innehåller nu plugin-beroenden och konfigurationer.

Distribuera apparna med hjälp av följande kommando:
```
mvn azure-spring-apps:deploy
```
Gå till mappen spring-petclinic-api-gateway . Kör följande kommandon för att generera konfigurationen och distribuera api-gateway. Välj Ja för Offentlig slutpunkt.
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=api-gateway
mvn azure-spring-apps:deploy
```

Verifiera tjänsterna

Ett lyckat distributionskommando returnerar en URL i formuläret: https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io. Använd den för att navigera till den tjänst som körs.

Du kan också navigera i Azure Portal för att hitta URL:en.

Navigera till tjänsten.
Välj Program.
Välj api-gateway.
Hitta URL:en på sidan api-gateway | Översikt.

Installera extra appar

Om du vill att PetClinic-appen ska fungera med alla avsnitt som Administrationsserver, Besök och Veterinärer kan du distribuera de andra Spring-programmen. Kör konfigurationskommandot igen och välj följande program.

administratörsserver
Veterinärservice
besöksservice

Korrigera appnamnen i varje pom.xml fil för dessa moduler och kör deploy sedan kommandot igen.

Importera exempelprojekt i IntelliJ

Använd följande steg för att importera exempelprojektet i IntelliJ.

Ladda ned och packa upp källkodsförrådet för den här handledningen, eller klona det via Git: git clone https://github.com/azure-samples/spring-petclinic-microservices
Öppna dialogrutan Välkommen till IntelliJ och välj Importera projekt för att öppna importguiden.
Välj mappen spring-petclinic-microservices.

Distribuera api-gateway-appen till Azure Spring Apps

Om du vill distribuera till Azure måste du logga in med ditt Azure-konto med Azure Toolkit for IntelliJ och välja din prenumeration. Information om inloggning finns i Skapa en Hello World-webbapp för Azure App Service med IntelliJ.

Högerklicka på projektet i IntelliJ-projektutforskaren och välj Azure -Deploy to Azure Spring Apps (Azure ->Deploy to Azure Spring Apps).
I fältet Namn lägger du till :api-gateway i det befintliga namnet.
I textrutan Artefakt väljer du spring-petclinic-api-gateway-3.0.1.
Kontrollera din prenumeration i textrutan Prenumeration.
I textrutan Spring Apps väljer du den instans av Azure Spring Apps som du skapade i Etablera Azure Spring Apps-instans.
I textrutan App: väljer du Skapa app....
Ange api-gateway och välj sedan OK.
Ställ in Offentlig slutpunkt till Aktivera.
Ange Minne till 2.0Gi och JVM-alternativ till -Xms2048m -Xmx2048m.
Dubbelklicka på Kör Maven-mål i avsnittet Före start i dialogrutan.
I textrutan Arbetskatalog går du till mappen spring-petclinic-microservices/spring-petclinic-api-gateway.
I textrutan Kommandorad anger du package -DskipTests. Välj OK.
Starta distributionen genom att välja knappen Kör längst ned i dialogrutan Distribuera Azure Spring Apps-appen . Plugin-programmet kör kommandot mvn package i api-gateway appen och distribuerar JAR-filen som genereras av package kommandot.

Distribuera kunders tjänst och andra appar till Azure Spring Apps

Upprepa föregående steg för att distribuera customers-service och andra Pet Clinic-appar till Azure Spring Apps:

Ändra namn och artefakt för att identifiera customers-service appen.
I textrutan App: väljer du Skapa app... för att skapa customers-service en app.
Kontrollera att alternativet Offentlig slutpunkt är inställt på Inaktiverad.
I avsnittet Före start i dialogrutan växlar du arbetskatalogen till mappen petclinic/customers-service.
Starta distributionen genom att välja knappen Kör längst ned i dialogrutan Distribuera Azure Spring Apps-appen .

Verifiera tjänsterna

Gå till formulärets URL: https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io

Du kan också navigera i Azure Portal för att hitta URL:en.

Navigera till tjänsten
Välj Appar
Välj api-gateway
Hitta URL:en på api-gatewayen | Översiktssida

Installera extra appar

Andra Spring-program som ingår i det här exemplet kan distribueras på samma sätt.

administratörsserver
Veterinärservice
besöksservice

Rensa resurser

Om du planerar att fortsätta arbeta med efterföljande snabbstarter och självstudier kanske du vill lämna dessa resurser på plats. Ta bort resursgruppen när den inte längre behövs, vilket tar bort resurserna i resursgruppen. 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

Snabbstart: Konfigurera en Log Analytics-arbetsyta

Feedback

Var den här sidan till hjälp?

Dela via

Snabbstart: Skapa och distribuera appar till Azure Spring Apps

Förutsättningar

Ladda ned exempelprogrammet

Distribuera PlanetWeatherProvider

Distribuera SolarSystemWeather

Tilldela offentlig slutpunkt

Testa programmet

Förutsättningar

Skapa Spring-programmen lokalt

Skapa och distribuera appar i Azure Spring Apps

Verifiera tjänsterna

Installera extra appar

Rensa resurser

Nästa steg

Feedback

Ytterligare resurser