Rychlý start: Sestavování a nasazování aplikací do Azure Spring Apps

Článek
11/05/2024

Poznámka:

Plány Basic, Standard a Enterprise budou od poloviny března 2025 vyřazeny ze 3letého období vyřazení. Doporučujeme přejít na Azure Container Apps. Další informace najdete v oznámení o vyřazení Azure Spring Apps.

Od 30. září 2024 bude od 30. září 2024 zastaralý plán s úplným vypnutím po šesti měsících. Doporučujeme přejít na Azure Container Apps. Další informace najdete v tématu Migrace spotřeby Azure Spring Apps Úrovně Standard a vyhrazeného plánu do Azure Container Apps.

Tento článek se vztahuje na: ✔️ Basic/Standard ❌ Enterprise

Tento rychlý start vysvětluje, jak sestavovat a nasazovat aplikace Spring do Azure Spring Apps pomocí Azure CLI.

Požadavky

Dokončení předchozích rychlých startů v této řadě:
- Zřízení instance služby Azure Spring Apps
- Nastavte konfigurační server Azure Spring Apps.

Stažení ukázkové aplikace

Ukázkovou aplikaci si můžete stáhnout pomocí následujícího postupu. Pokud používáte Azure Cloud Shell, přepněte na místní příkazový řádek.

Vytvořte novou složku a naklonujte úložiště ukázkové aplikace.

mkdir source-code

cd source-code

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

Přejděte do adresáře úložiště.
```
cd azure-spring-apps-samples
```

Nasazení PlanetWeatherProvider

Pomocí následujícího postupu nasaďte projekt PlanetWeatherProvider.

Vytvořte aplikaci pro PlanetWeatherProvider projekt v instanci Azure Spring Apps.
```
az spring app create --name planet-weather-provider --runtime-version NetCore_31
```
Pokud chcete povolit automatickou registraci služby, zadali jste aplikaci stejný název jako hodnota spring.application.name v souboru appsettings.json projektu:
```
"spring": {
  "application": {
    "name": "planet-weather-provider"
  }
}
```
Spuštění tohoto příkazu může trvat několik minut.
Změňte adresář na PlanetWeatherProvider složku projektu.
```
cd steeltoe-sample/src/planet-weather-provider
```

Vytvořte binární soubory a soubor .zip , který se má nasadit.

dotnet publish -c release -o ./publish

Tip

Soubor projektu obsahuje následující kód XML pro zabalení binárních souborů do souboru .zip po zápisu do složky ./publish :

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

Nasaďte projekt do Azure.

Před spuštěním následujícího příkazu se ujistěte, že je příkazový řádek ve složce projektu.
```
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
```
Možnost --main-entry určuje relativní cestu z kořenové složky .zip souboru do .dll souboru, který obsahuje vstupní bod aplikace. Jakmile služba nahraje .zip soubor, extrahuje všechny soubory a složky a pak se pokusí spustit vstupní bod v zadaném souboru .dll .

Spuštění tohoto příkazu může trvat několik minut.

Nasazení systému SolarSystemWeather

Pomocí následujících kroků nasaďte projekt SolarSystemWeather.

Vytvořte pro projekt jinou aplikaci v instanci Azure Spring Apps.
```
az spring app create --name solar-system-weather --runtime-version NetCore_31
```
solar-system-weatherje název zadaný v SolarSystemWeather souboru appsettings.json projektu.

Spuštění tohoto příkazu může trvat několik minut.
Změňte adresář na SolarSystemWeather projekt.
```
cd ../solar-system-weather
```
Vytvořte binární soubory a .zip soubor, který se má nasadit.
```
dotnet publish -c release -o ./publish
```

Nasaďte projekt do 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

Spuštění tohoto příkazu může trvat několik minut.

Přiřazení veřejného koncového bodu

Před testováním aplikace získejte veřejný koncový bod pro požadavek HTTP GET do solar-system-weather aplikace.

Spuštěním následujícího příkazu přiřaďte koncový bod.

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

Spuštěním následujícího příkazu získejte adresu URL koncového bodu.

Windows:

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

Linux:

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

Testování aplikace

Pokud chcete aplikaci otestovat, odešlete do solar-system-weather aplikace požadavek GET. V prohlížeči přejděte na veřejnou adresu URL s /weatherforecast připojenou adresou URL. Příklad: https://servicename-solar-system-weather.azuremicroservices.io/weatherforecast

Výstup je JSON:

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

Tato odpověď ukazuje, že obě aplikace Spring fungují. Aplikace SolarSystemWeather vrátí data, která načetla z PlanetWeatherProvider aplikace.

Tento článek vysvětluje, jak se vytvářejí a nasazují aplikace Spring do Azure Spring Apps. Můžete použít Azure CLI, modul plug-in Maven nebo Intellij. Tento článek popisuje každou alternativu.

Požadavky

Dokončení předchozích rychlých startů v této řadě:
- Zřízení instance služby Azure Spring Apps
- Nastavte konfigurační server Azure Spring Apps.
JDK 17
Maven 3.0 nebo vyšší
Předplatné Azure. Pokud předplatné nemáte, vytvořte si před zahájením bezplatný účet .
Volitelně můžete azure CLI verze 2.45.0 nebo vyšší. Nainstalujte rozšíření Azure Spring Apps pomocí následujícího příkazu: az extension add --name spring
Volitelně můžete sadu Azure Toolkit for IntelliJ.

Místní sestavování aplikací Spring

Pomocí následujících příkazů naklonujte ukázkové úložiště, přejděte do ukázkové složky a pak sestavte projekt.

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

Kompilace projektu trvá 5 až 10 minut. Při kompilaci projektu byste měli mít jednotlivé soubory JAR pro každou službu v příslušných složkách.

Vytváření a nasazování aplikací v Azure Spring Apps

Pomocí následujícího postupu vytvořte a nasadíte aplikace v Azure Spring Apps pomocí rozhraní příkazového řádku.

Pokud jste v předchozích rychlých startech nespusili následující příkazy, spusťte je a nastavte výchozí hodnoty rozhraní příkazového řádku.
```
az configure --defaults group=<resource-group-name> spring=<service-name>
```

Vytvořte dvě základní aplikace Spring pro PetClinic: api-gateway a 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

Nasaďte soubory JAR vytvořené v předchozím kroku.

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"

Po nasazení zadejte dotaz na stav aplikace pomocí následujícího příkazu.

az spring app list --output table

Tento příkaz vytvoří výstup podobný následujícímu příkladu:

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                    -

Ověření služeb

Přístup k api-gateway customers-service prohlížeči s veřejnou adresou URL zobrazenou dříve ve formátu https://<service name>-api-gateway.azuremicroservices.io.

Tip

Při řešení potíží s nasazením můžete pomocí následujícího příkazu získat streamování protokolů v reálném čase při každém spuštění az spring app logs --name <app name> --followaplikace.

Nasazení dalších aplikací

Pokud chcete, aby aplikace PetClinic fungovala se všemi funkcemi, jako je admin server, návštěvy a veterinární lékaři, nasaďte ostatní aplikace pomocí následujících příkazů:

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"

Místní sestavování aplikací Spring

Pomocí následujících příkazů naklonujte ukázkové úložiště, přejděte do ukázkové složky a pak sestavte projekt.

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

Kompilace projektu trvá 5 až 10 minut. Při kompilaci projektu byste měli mít jednotlivé soubory JAR pro každou službu v příslušných složkách.

Generování konfigurací a nasazení do Azure Spring Apps

Následující kroky ukazují, jak vygenerovat konfigurace a nasadit je do Azure Spring Apps:

Přejděte do složky spring-petclinic-customers-service . Vygenerujte konfigurace spuštěním následujícího příkazu. Pokud jste se už přihlásili pomocí Azure CLI, příkaz automaticky převezme přihlašovací údaje. V opačném případě vás přihlásí pomocí výzvy s pokyny. Další informace najdete v tématu Ověřování na wikiwebu azure-maven-plugins .
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=customers-service
```
Zobrazí se výzva k zadání následujících hodnot:
- Předplatné: Předplatné, které jste použili k vytvoření instance Azure Spring Apps.
- Instance služby: Název vaší instance Azure Spring Apps.
- Veřejný koncový bod: Určuje, jestli se má k aplikaci přiřadit veřejný koncový bod. Vyberte možnost Ne.

Ověřte správnost appName prvků v souborech POM:

<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 teď obsahuje závislosti a konfigurace modulu plug-in.

Nasaďte aplikace pomocí následujícího příkazu:
```
mvn azure-spring-apps:deploy
```
Přejděte do složky spring-petclinic-api-gateway . Spuštěním následujících příkazů vygenerujte konfiguraci a nasaďte api-gateway. Vyberte ano pro veřejný koncový bod.
```
mvn com.microsoft.azure:azure-spring-apps-maven-plugin:1.19.0:config -DappName=api-gateway
mvn azure-spring-apps:deploy
```

Ověření služeb

Příkaz úspěšného nasazení vrátí adresu URL ve formuláři: https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io. Slouží k přechodu na spuštěnou službu.

Adresu URL najdete také na webu Azure Portal.

Přejděte do služby.
Zvolte Aplikace.
Vyberte api-gateway.
Vyhledání adresy URL na bráně api-gateway | Stránka s přehledem

Nasazení dalších aplikací

Pokud chcete, aby aplikace PetClinic fungovala se všemi oddíly, jako je Admin Server, Visits a Veterinární lékaři, můžete nasadit další aplikace Spring. Spusťte znovu konfigurační příkaz a vyberte následující aplikace.

admin-server
vets-service
visits-service

Opravte názvy aplikací v každém souboru pom.xml pro tyto moduly a pak příkaz spusťte deploy znovu.

Import ukázkového projektu v IntelliJ

K importu ukázkového projektu v IntelliJ použijte následující postup.

Stáhněte a rozbalte zdrojové úložiště pro tento kurz nebo ho naklonujte pomocí Gitu: git clone https://github.com/azure-samples/spring-petclinic-microservices
Otevřete úvodní dialogové okno IntelliJ a výběrem možnosti Importovat projekt otevřete průvodce importem.
Vyberte složku spring-petclinic-microservices.

Nasazení aplikace api-gateway do Azure Spring Apps

Pokud chcete nasadit do Azure, musíte se přihlásit pomocí svého účtu Azure pomocí sady Azure Toolkit for IntelliJ a zvolit své předplatné. Podrobnosti o přihlášení najdete v tématu Vytvoření webové aplikace Hello World pro službu Aplikace Azure Service pomocí IntelliJ.

Klikněte pravým tlačítkem na projekt v Průzkumníku projektů IntelliJ a vyberte Azure ->Deploy to Azure Spring Apps.
V poli Název připojte :api-gateway k existujícímu názvu.
V textovém poli Artefakt vyberte spring-petclinic-api-gateway-3.0.1.
V textovém poli Předplatné ověřte své předplatné.
V textovém poli Spring Apps vyberte instanci Azure Spring Apps, kterou jste vytvořili v instanci Zřizování azure Spring Apps.
V textovém poli Aplikace: vyberte Vytvořit aplikaci....
Zadejte api-gateway a pak vyberte OK.
Nastavte veřejný koncový bod na povolení.
Nastavte možnosti paměti na 2.0Gi a JVM na -Xms2048m -Xmx2048mhodnotu .
V části Před spuštěním dialogového okna poklikejte na Spustit cíl Mavenu.
V textovém poli Pracovní adresář přejděte do složky spring-petclinic-microservices/spring-petclinic-api-gateway .
Do textového pole příkazového řádku zadejte package -DskipTests. Vyberte OK.
Spusťte nasazení tak, že v dolní části dialogového okna Nasazení aplikace Azure Spring Apps vyberete tlačítko Spustit. Modul plug-in spustí příkaz mvn package v api-gateway aplikaci a nasadí soubor JAR vygenerovaný příkazem package .

Nasazení služeb zákazníků a dalších aplikací do Azure Spring Apps

Zopakujte předchozí kroky pro nasazení customers-service a další aplikace Pet Clinic do azure Spring Apps:

Upravte název a artefakt a identifikujte customers-service aplikaci.
V textovém poli Aplikace vyberte Vytvořit aplikaci... a vytvořte customers-service aplikaci.
Ověřte, že je možnost Veřejný koncový bod nastavená na Zakázáno.
V části Před spuštěním dialogového okna přepněte pracovní adresář do složky petclinic/customers-service.
Spusťte nasazení tak, že v dolní části dialogového okna Nasazení aplikace Azure Spring Apps vyberete tlačítko Spustit.

Ověření služeb

Přejděte na adresu URL formuláře: https://<service name>-spring-petclinic-api-gateway.azuremicroservices.io

Adresu URL najdete také na webu Azure Portal.

Přejděte do služby.
Zvolte Aplikace
Výběr rozhraní API-gateway
Vyhledání adresy URL na bráně api-gateway | Stránka Přehled

Nasazení dalších aplikací

Podobně je možné nasadit i další aplikace Spring, které jsou součástí této ukázky.

admin-server
vets-service
visits-service

Vyčištění prostředků

Pokud chcete pokračovat v práci s dalšími rychlými starty a kurzy, můžete tyto prostředky ponechat na místě. Pokud už ji nepotřebujete, odstraňte skupinu prostředků, která odstraní prostředky ve skupině prostředků. Pokud chcete odstranit skupinu prostředků pomocí Azure CLI, použijte následující příkazy:

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

Další kroky

Rychlý start: Nastavení pracovního prostoru služby Log Analytics

Sdílet prostřednictvím

Rychlý start: Sestavování a nasazování aplikací do Azure Spring Apps

Požadavky

Stažení ukázkové aplikace

Nasazení PlanetWeatherProvider

Nasazení systému SolarSystemWeather

Přiřazení veřejného koncového bodu

Testování aplikace

Požadavky

Místní sestavování aplikací Spring

Vytváření a nasazování aplikací v Azure Spring Apps

Ověření služeb

Nasazení dalších aplikací

Místní sestavování aplikací Spring

Generování konfigurací a nasazení do Azure Spring Apps

Ověření služeb

Nasazení dalších aplikací

Import ukázkového projektu v IntelliJ

Nasazení aplikace api-gateway do Azure Spring Apps

Nasazení služeb zákazníků a dalších aplikací do Azure Spring Apps

Ověření služeb

Nasazení dalších aplikací

Vyčištění prostředků

Další kroky

Váš názor

Další materiály