Spring Boot-alkalmazás üzembe helyezése Linuxon az Azure App Service-ben

Ez az oktatóanyag bemutatja, hogyan lehet a Spring Boot-alkalmazást a Docker használatával konténerizálni, majd a saját Docker-képet üzembe helyezni egy Linux-gazdagépen az Azure App Serviceszolgáltatásban.

Előfeltételek

Az oktatóanyag lépéseinek elvégzéséhez a következő előfeltételekkel kell rendelkeznie:

• Azure-előfizetés; 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 Command-Line Interface (CLI).
• Egy támogatott Java Development Kit (JDK). Az Azure-beli fejlesztés során használható JDK-kkal kapcsolatos további információkért lásd Java-támogatást az Azure-ban és az Azure Stack.
• Apache Maven buildelési eszköz (3. verzió).
• Egy Git ügyfél.
• Egy Docker--ügyfél.

Jegyzet

Az oktatóanyag virtualizálási követelményei miatt nem tudja követni a jelen cikkben szereplő lépéseket egy virtuális gépen; olyan fizikai számítógépet kell használnia, amelyen engedélyezve van a virtualizálási funkció.

A Spring Boot létrehozása a Docker Első lépések webalkalmazásban

Az alábbi lépések végigvezetik az egyszerű Spring Boot-webalkalmazás létrehozásához és helyi teszteléséhez szükséges lépéseken.

1. Nyisson meg egy parancssort, és hozzon létre egy helyi könyvtárat az alkalmazás tárolásához, és váltson erre a könyvtárra; például:

   mkdir SpringBoot
   cd SpringBoot
   

2. Klónozza a Spring Boot kezdőknek Docker-rel mintaprojektet a létrehozott könyvtárba; például:

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

3. Módosítsa a könyvtárat a befejezett projektre; például:

   cd gs-spring-boot-docker/complete
   

4. A JAR-fájl létrehozása a Maven használatával; például:

   mvn package
   

5. A webalkalmazás létrehozása után módosítsa a könyvtárat arra a target könyvtárra, amelyben a JAR-fájl található, és indítsa el a webalkalmazást; például:

   cd target
   java -jar spring-boot-docker-complete-0.0.1-SNAPSHOT.jar --server.port=80
   

6. Tesztelje a webalkalmazást úgy, hogy helyileg böngész egy webböngésző használatával. Ha például elérhető a curl, és úgy konfigurálta a Tomcat-kiszolgálót, hogy a 80-ás porton fusson:

   curl http://localhost
   

7. A következő üzenet jelenik meg: Hello Docker World

   

Azure Container Registry létrehozása privát Docker-beállításjegyzékként való használatra

Az alábbi lépések végigvezetik az Azure Portal használatával egy Azure Container Registry létrehozására.

Jegyzet

Ha az Azure Portal helyett az Azure CLI-t szeretné használni, kövesse a Privát Docker-tárolóregisztrációs adatbázis létrehozása az Azure CLI 2.0használatával című szakasz lépéseit.

1. Keresse meg az Azure Portal , és jelentkezzen be.

   Miután bejelentkezett a fiókjába az Azure Portalon, kövesse a Privát Docker-tárolóregisztrációs adatbázis létrehozása az Azure Portal cikkének lépéseit, amelyeket a célszerűség kedvéért az alábbi lépésekben parafrasztál.

2. Kattintson az Újmenüikonra, válassza a Tárolókopciót, majd válassza az Azure Container Registryopciót.

   létrehozása

3. Amikor megjelenik a(z) Tárolói nyilvántartó létrehozása lap, adja meg a nyilvántartó nevét, előfizetés, erőforráscsoportés helyszín. Ezután válassza létrehozása lehetőséget.

   

4. Válassza Hozzáférési kulcsokat a Beállítások területen, és kapcsolja be a Engedélyezett kapcsolót a rendszergazdai felhasználómögött.

   

A Maven konfigurálása az Azure Container Registry rendszerképének létrehozására

1. Nyissa meg a Spring Boot-alkalmazás befejezett projektkönyvtárát – például C:\SpringBoot\gs-spring-boot-docker\complete vagy /users/robert/SpringBoot/gs-spring-boot-docker/complete – és nyissa meg a pom.xml fájlt egy szövegszerkesztővel.

2. Frissítse a <properties> gyűjteményt a pom.xml fájlban a jib-maven-pluginlegújabb verziójával, a bejelentkezési kiszolgáló értékével és az Azure Container Registry hozzáférési beállításaival az oktatóanyag előző szakaszából. Például:

   <properties>
      <jib-maven-plugin.version>3.2.0</jib-maven-plugin.version>
      <docker.image.prefix>wingtiptoysregistry.azurecr.io</docker.image.prefix>
      <java.version>1.8</java.version>
   </properties>
   

3. Adja hozzá jib-maven-plugin a <plugins> gyűjteményhez a pom.xml fájlban. Ez a példa a 3.2.0-s verziót használja.

   Adja meg az alaprendszerképet a <from>/<image>, itt mcr.microsoft.com/openjdk/jdk:11-ubuntu. Adja meg a <to>/<image>alapból létrehozandó végső rendszerkép nevét.

   A hitelesítési {docker.image.prefix} a bejelentkezési szerver a korábban bemutatott regisztrációs oldalon. A {project.artifactId} a projekt első Maven-buildjének JAR-fájljának neve és verziószáma.

   <plugin>
     <artifactId>jib-maven-plugin</artifactId>
     <groupId>com.google.cloud.tools</groupId>
     <version>${jib-maven-plugin.version}</version>
     <configuration>
        <from>
            <image>mcr.microsoft.com/openjdk/jdk:11-ubuntu</image>
        </from>
        <to>
            <image>${docker.image.prefix}/${project.artifactId}</image>
        </to>
     </configuration>
   </plugin>
   

4. Lépjen a Spring Boot-alkalmazás befejezett projektkönyvtárára, és futtassa a következő parancsot az alkalmazás újraépítéséhez és a tároló azure container registrybe való leküldéséhez:

   az acr login --name wingtiptoysregistry && mvn compile jib:build
   

Jegyzet

A az acr login ... parancs megpróbál bejelentkezni az Azure Container Registry-be, ellenkező esetben meg kell adnia a <username> és <password> adatokat a jib-maven-plugin számára. Lásd: Hitelesítési módszerek a jib-ben.

Ha Jib használatával küldi le a rendszerképet az Azure Container Registrybe, a rendszerkép nem használja a Dockerfile-t. A részletekért tekintse meg ezt a dokumentumot.

Webalkalmazás létrehozása Linuxon az Azure App Service-ben a tárolórendszerkép használatával

1. Keresse meg az Azure Portal , és jelentkezzen be.

2. Kattintson a Erőforrás létrehozásamenüikonra, válassza a Számításopciót, majd a Webalkalmazáslehetőséget.

   

3. Amikor megjelenik a Web App on Linux lap, adja meg a következő információkat:

   • Válassza ki előfizetését a legördülő listából.

   • Válasszon ki egy meglévő erőforráscsoportot, vagy adjon meg egy nevet egy új erőforráscsoport létrehozásához.

   • Adjon meg egy egyedi nevet a alkalmazásnév; például: wingtiptoyslinux

   • Adja meg a Docker Container-tól -ig közzétételi.

   • Az Operációs rendszer mezőben válassza a Linuxlehetőséget.

   • Válassza Régiólehetőséget.

   • Fogadja el a Linux-csomagot, és válasszon egy már meglévő App Service-csomagot, vagy válassza az Új létrehozása lehetőséget, hogy új App Service-csomagot hozzon létre.

   • Kattintson a Tovább: Dockergombra.

   

   A Web App lapon válassza Dockerlehetőséget, és adja meg a következő adatokat:

   • Válassza az egytárolóslehetőséget.

   • Nyilvántartás-: Válassza ki a tárolót, például a következőt: wingtiptoysregistry.

   • Kép: Válassza ki a korábban létrehozott képet, például: spring-boot-docker.

   • Címke: Válassza ki a kép címkéjét, például: legújabb.

   • Indítási parancs: Hagyja üresen, mivel a rendszerkép már tartalmazza az indítási parancsot

   Miután megadta az összes fenti információt, válassza a Áttekintés + létrehozáslehetőséget.

   

   • Válassza Véleményezés + létrehozáslehetőséget.

Tekintse át az információkat, és válassza létrehozása lehetőséget.

Amikor az üzembe helyezés befejeződött, válassza Ugrás az erőforráshoz. Az üzembe helyezési oldal megjeleníti az alkalmazás eléréséhez szükséges URL-címet.

URL-címének lekérése

Jegyzet

Az Azure automatikusan megfelelteti az internetes kéréseket a 80-ás porton futó beágyazott Tomcat-kiszolgálóra. Ha azonban úgy konfigurálta a beágyazott Tomcat-kiszolgálót, hogy a 8080-s vagy az egyéni porton fusson, hozzá kell adnia egy környezeti változót a webalkalmazáshoz, amely meghatározza a beágyazott Tomcat-kiszolgáló portját. Ehhez kövesse az alábbi lépéseket:

1. Keresse meg az Azure Portal , és jelentkezzen be.

2. Válassza Web Appsikonját, és válassza ki az alkalmazást az App Services lapon.

3. Válassza Konfigurációs lehetőséget a bal oldali navigációs panelen.

4. Az Alkalmazásbeállítások szakaszban adjon hozzá egy új, WEBSITES_PORT nevű beállítást, és adja meg az érték egyéni portszámát.

5. Válassza OKlehetőséget. Ezután válassza a Mentéslehetőséget.

Erőforrások törlése

Ha már nincs rá szükség, a Azure Portal használatával törölheti a cikkben létrehozott erőforrásokat a váratlan költségek elkerülése érdekében.

Következő lépések

Ha többet szeretne megtudni a Springről és az Azure-ról, lépjen tovább a Spring on Azure dokumentációs központjába.

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:

• Spring Boot-alkalmazás üzembe helyezése a Kubernetes-fürtön az Azure konténerszolgáltatásban

Az Azure Javával való használatáról további információt az „Azure for Java fejlesztőknek” és a „Munka az Azure DevOps és a Java segítségével” cikkekben olvashatsz.

A Docker mintaprojekt Spring Boot használatával kapcsolatos további részletekért lásd Spring Boot a Dockeron: Az első lépések.

Ha segítségre van szüksége a saját Spring Boot-alkalmazások használatának megkezdéséhez, tekintse meg a Spring Initializrhttps://start.spring.io/.

Az egyszerű Spring Boot-alkalmazás létrehozásának első lépéseiről bővebb információt a Spring Initializr platformon talál a https://start.spring.io/.

További példák az egyéni Docker-rendszerképek Azure-ral való használatára: Egyéni Docker-rendszerkép használata az Azure Web Apphoz Linuxon.