Spring Data használata az Apache Cassandra API-hoz készült Azure Cosmos DB-vel

Ez a cikk végigvezeti a Java-webalkalmazások linuxos Azure App Service-ben való létrehozásának, konfigurálásának, üzembe helyezésének, hibaelhárításának és skálázásának folyamatán.

A következő összetevők használatát mutatja be:

Előfeltételek

A cikk lépéseinek végrehajtásához a következő előfeltételek szükségesek:

Egy Java-webalkalmazás felhőben való üzembe helyezéséhez Azure-előfizetésre van szükség. Ha még nem rendelkezik Azure-előfizetéssel, aktiválhatja MSDN-előfizetői előnyeit, vagy regisztrálhat egy ingyenes Azure-fiókra.
Azure CLI 2.0
Java 8 JDK
Maven 3

Fontos

A cikkben ismertetett lépések elvégzéséhez a Spring Boot 2.5-ös vagy újabb verziójára van szükség.

A Java-webalkalmazás-mintaadattár klónozása

Ebben a gyakorlatban a Spring Todo alkalmazást használni fogja, amely a Spring Boot, a Spring Data for Azure Cosmos DB és az Azure Cosmos DBsegítségével készült.

Klónozza a Spring Todo alkalmazást, és másolja a .prep mappa tartalmát a projekt inicializálásához:

Ha Basht használ:

git clone --recurse-submodules https://github.com/Azure-Samples/e2e-java-experience-in-app-service-linux-part-2.git
yes | cp -rf .prep/* .

Windows esetén:

git clone --recurse-submodules https://github.com/Azure-Samples/e2e-java-experience-in-app-service-linux-part-2.git
cd e2e-java-experience-in-app-service-linux-part-2
xcopy .prep /f /s /e /y

Módosítsa a könyvtárat a következő mappára a klónozott adattárban:
```
cd initial\spring-todo-app
```

Azure Cosmos DB létrehozása az Azure CLI-ből

Az alábbi eljárás parancssori felülettel hozza létre az Azure Cosmos DB-adatbázist.

Jelentkezzen be az Azure CLI-be, és állítsa be az előfizetés azonosítóját.
```
az login
```
Szükség esetén állítsa be az előfizetés azonosítóját.
```
az account set -s <your-subscription-id>
```
Hozzon létre egy Azure-erőforráscsoportot, és mentse el az erőforráscsoport nevét későbbi használatra.
```
az group create \
    --name <your-azure-group-name> \
    --location <your-resource-group-region>
```
Hozza létre az Azure Cosmos DB-t, és adja meg a típust GlobalDocumentDB néven. Az Azure Cosmos DB nevének csak kisbetűket kell használnia. Ügyeljen arra, hogy feljegyezze a válasz documentEndpoint mezőjét. Később szüksége lesz erre az értékre.
```
az cosmosdb create \
    --resource-group <your-resource-group-name> \
    --name <your-azure-COSMOS-DB-name-in-lower-case-letters> \
    --kind GlobalDocumentDB
```

Szerezze be az Azure Cosmos DB-kulcsokat, és jegyezze fel a primaryMasterKey értéket későbbi használatra.

az cosmosdb keys list \
    --resource-group <your-azure-group-name> \
    --name <your-azure-COSMOSDB-name>

Az alkalmazás helyi létrehozása és futtatása

Az alábbi eljárás futtatja az alkalmazást a fejlesztői számítógépen.

A választott konzolon belül konfigurálja a következő kódszakaszokban látható környezeti változókat a cikkben korábban összegyűjtött Azure- és Azure Cosmos DB-kapcsolati adatokkal. Meg kell adnia a WEBAPP_NAME egyedi nevét és az REGION változók értékét.

Linux (Bash) esetén:

export COSMOS_URI=<put-your-COSMOS-DB-documentEndpoint-URI-here>
export COSMOS_KEY=<put-your-COSMOS-DB-primaryMasterKey-here>
export COSMOS_DATABASE=<put-your-COSMOS-DATABASE-name-here>
export RESOURCEGROUP_NAME=<put-your-resource-group-name-here>
export WEBAPP_NAME=<put-your-Webapp-name-here>
export REGION=<put-your-REGION-here>
export SUBSCRIPTION_ID=<put-your-SUBSCRIPTION_ID-here>

Windows esetén (parancssor):

set COSMOS_URI=<put-your-COSMOS-DB-documentEndpoint-URI-here>
set COSMOS_KEY=<put-your-COSMOS-DB-primaryMasterKey-here>
set COSMOS_DATABASE=<put-your-COSMOS-DATABASE-name-here>
set RESOURCEGROUP_NAME=<put-your-resource-group-name-here>
set WEBAPP_NAME=<put-your-Webapp-name-here>
set REGION=<put-your-REGION-here>
set SUBSCRIPTION_ID=<put-your-SUBSCRIPTION_ID-here>

Jegyzet

Ha szkripttel szeretné kiépíteni ezeket a változókat, a .prep könyvtárban található egy Bash-sablon, amelyet kiindulópontként másolhat és használhat.

Módosítsa a könyvtárat a következő paranccsal:
```
cd initial/spring-todo-app
```
Futtassa helyileg a Spring Todo alkalmazást a következő paranccsal:
```
mvn package spring-boot:run
```
Miután az alkalmazás elindult, ellenőrizheti az üzembe helyezést a Spring Todo alkalmazás ide kattintva: http://localhost:8080/.

helyileg futó Spring-alkalmazás

Üzembe helyezés Az App Service Linuxon

Az alábbi eljárás üzembe helyezi az alkalmazást Linuxon az Azure-ban.

Nyissa meg a korábban az adattár kezdeti/spring-todo-app könyvtárába másolt pom.xml fájlt. Győződjön meg arról, hogy az Azure App Service Maven beépülő modulja az alábbi pom.xml fájlban látható módon szerepel. Ha a verzió nincs beállítva 1.14.0-ra, akkor frissítse az értéket.

<plugins> 

    <!--*************************************************-->
    <!-- Deploy to Java SE in App Service Linux           -->
    <!--*************************************************-->

    <plugin>
        <groupId>com.microsoft.azure</groupId>
        <artifactId>azure-webapp-maven-plugin</artifactId>
        <version>1.14.0</version>
        <configuration>
            <schemaVersion>v2</schemaVersion>
            <subscriptionId>${SUBSCRIPTION_ID}</subscriptionId>
            <!-- Web App information -->
            <resourceGroup>${RESOURCEGROUP_NAME}</resourceGroup>
            <appName>${WEBAPP_NAME}</appName>
            <region>${REGION}</region>
            <pricingTier>P1v2</pricingTier>
            <!-- Java Runtime Stack for Web App on Linux-->
            <runtime>
                <os>Linux</os>
                <javaVersion>Java 8</javaVersion>
                <webContainer>Java SE</webContainer>
            </runtime>
            <deployment>
                <resources>
                    <resource>
                        <directory>${project.basedir}/target</directory>
                        <includes>
                            <include>*.jar</include>
                        </includes>
                    </resource>
                </resources>
            </deployment>
            <appSettings>
                <property>
                    <name>COSMOS_URI</name>
                    <value>${COSMOS_URI}</value>
                </property>
                <property>
                    <name>COSMOS_KEY</name>
                    <value>${COSMOS_KEY}</value>
                </property>
                <property>
                    <name>COSMOS_DATABASE</name>
                    <value>${COSMOS_DATABASE}</value>
                </property>
                <property>
                    <name>JAVA_OPTS</name>
                    <value>-Dserver.port=80</value>
                </property>
            </appSettings>

        </configuration>
    </plugin>            
    ...
</plugins>

Üzembe helyezés az App Service Linuxon a Java SE-ben

mvn azure-webapp:deploy

// Deploy
bash-3.2$ mvn azure-webapp:deploy
[INFO] Scanning for projects...
[INFO]
[INFO] -------< com.azure.spring.samples:spring-todo-app >--------
[INFO] Building spring-todo-app 2.0-SNAPSHOT
[INFO] --------------------------------[ jar ]---------------------------------
[INFO]
[INFO] --- azure-webapp-maven-plugin:1.14.0:deploy (default-cli) @ spring-todo-app ---
Auth type: AZURE_CLI
Default subscription: Consoto Subscription(subscription-id-xxx)
Username: user@contoso.com
[INFO] Subscription: Consoto Subscription(subscription-id-xxx)
[INFO] Creating app service plan...
[INFO] Successfully created app service plan asp-spring-todo-app.
[INFO] Creating web app spring-todo-app...
[INFO] Successfully created Web App spring-todo-app.
[INFO] Trying to deploy artifact to spring-todo-app...
[INFO] Successfully deployed the artifact to https://spring-todo-app.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  02:05 min
[INFO] Finished at: 2021-05-28T09:43:19+08:00
[INFO] ------------------------------------------------------------------------

Keresse fel a Java SE-n futó webalkalmazást az App Service Linux szolgáltatásban.
```
https://<WEBAPP_NAME>.azurewebsites.net
```

Spring-alkalmazás fut az App Service-ben Linuxon

Spring Todo-alkalmazás hibaelhárítása az Azure-ban a naplók megtekintésével

Az alábbi eljárás naplófájlokat nyit meg az Azure-ban.

Naplók konfigurálása a linuxos Azure App Service-ben üzembe helyezett Java-webalkalmazáshoz:

az webapp log config \
    --name ${WEBAPP_NAME} \
    --resource-group ${RESOURCEGROUP_NAME} \
    --web-server-logging filesystem

Nyissa meg a Java Web App távoli naplóstreamet egy helyi gépről:

az webapp log tail \
    --name ${WEBAPP_NAME} \
    --resource-group ${RESOURCEGROUP_NAME}

bash-3.2$ az webapp log tail --name ${WEBAPP_NAME}  --resource-group ${RESOURCEGROUP_NAME}
2021-05-28T01:46:08.000655632Z   _____                               
2021-05-28T01:46:08.000701432Z   /  _  \ __________ _________   ____  
2021-05-28T01:46:08.000708133Z  /  /_\  \___   /  |  \_  __ \_/ __ \ 
2021-05-28T01:46:08.000711733Z /    |    \/    /|  |  /|  | \/\  ___/ 
2021-05-28T01:46:08.000714933Z \____|__  /_____ \____/ |__|    \___  >
2021-05-28T01:46:08.000718233Z         \/      \/                  \/ 
2021-05-28T01:46:08.000721333Z A P P   S E R V I C E   O N   L I N U X
2021-05-28T01:46:08.000724233Z Documentation: http://aka.ms/webapp-linux
...
...
2021-05-28T01:46:18.925044188Z   .   ____          _            __ _ _
2021-05-28T01:46:18.925481392Z  /\\ / ___'_ __ _ _(_)_ __  __ _ \ \ \ \
2021-05-28T01:46:18.926004297Z ( ( )\___ | '_ | '_| | '_ \/ _` | \ \ \ \
2021-05-28T01:46:18.926587603Z  \\/  ___)| |_)| | | | | || (_| |  ) ) ) )
2021-05-28T01:46:18.926599403Z   '  |____| .__|_| |_|_| |_\__, | / / / /
2021-05-28T01:46:18.926841806Z  =========|_|==============|___/=/_/_/_/
2021-05-28T01:46:18.931157849Z  :: Spring Boot ::                (v2.4.5)
...
...
2021-05-28T01:46:29.842553633Z 2021-05-28 01:46:29.842  INFO 124 --- [           main] c.azure.spring.   samples.TodoApplication   : Started TodoApplication in 12.635 seconds (JVM running for 17.664)
2021-05-28T01:46:30.477951594Z 2021-05-28 01:46:30.477  INFO 124 --- [p-nio-80-exec-1] o.a.c.c.C.   [Tomcat].[localhost].[/]       : Initializing Spring DispatcherServlet 'dispatcherServlet'
2021-05-28T01:46:30.483316162Z 2021-05-28 01:46:30.483  INFO 124 --- [p-nio-80-exec-1] o.s.web.   servlet.DispatcherServlet        : Initializing Servlet 'dispatcherServlet'
2021-05-28T01:46:30.485411088Z 2021-05-28 01:46:30.484  INFO 124 --- [p-nio-80-exec-1] o.s.web.   servlet.DispatcherServlet        : Completed initialization in 0 ms
2021-05-28T01:47:19.683003828Z 2021-05-28 01:47:19.682  INFO 124 --- [p-nio-80-exec-9] c.a.s.s.   controller.TodoListController    : GET request access '/api/todolist' path.
2021-05-28T01:47:26.069984388Z 2021-05-28 01:47:26.069  INFO 124 --- [-nio-80-exec-10] c.a.s.s.   controller.TodoListController    : POST request access '/api/todolist' path with item: Milk
2021-05-28T01:47:26.649080678Z 2021-05-28 01:47:26.648  INFO 124 --- [p-nio-80-exec-1] c.a.s.s.   controller.TodoListController    : GET request access '/api/todolist' path.

A Spring Todo alkalmazás vertikális felskálázása

Az alkalmazás méretezéséhez használja az alábbi eljárást.

A Java-webalkalmazás horizontális felskálázása az Azure CLI használatával:

az appservice plan update \
    --number-of-workers 2 \
    --name ${WEBAPP_PLAN_NAME} \
    --resource-group ${RESOURCEGROUP_NAME}

Következő lépések

Java az App Service Linux fejlesztői útmutatójában
Azure for Java Developers A Spring és az Azure megismeréséhez folytassa a Spring on Azure dokumentációs központtal.

Spring az Azure

Lásd még:

A Spring Boot-alkalmazások Azure-beli használatáról az alábbi cikkekben talál további információt:

Az Azure Javával való használatáról további információkat az Azure for Java Developers, valamint a Azure DevOps és Javacímű cikkekben talál.

A Spring Framework egy nyílt forráskódú megoldás, amely segít a Java-fejlesztőknek nagyvállalati szintű alkalmazások létrehozásában. A platformra épülő egyik népszerűbb projekt a Spring Boot, amely leegyszerűsíti a különálló Java-alkalmazások létrehozását. A fejlesztőknek a Spring Boot használatának megkezdéséhez számos minta Spring Boot-csomag érhető el a https://github.com/spring-guides/. Az alapszintű Spring Boot-projektek listájának kiválasztása mellett a Spring Initializr segít a fejlesztőknek az egyéni Spring Boot-alkalmazások létrehozásának megkezdésében.

Visszajelzés

Hasznosnak találta ezt az oldalt?

Last updated on 2025-08-19