Kumuluz Enterprise kiadás Web App üzembe helyezése a Maven szolgáltatás Azure-alkalmazás

Ebben a rövid útmutatóban a Azure-alkalmazás Service Web AppsHez készült Maven beépülő modult fogja használni egy Kumuluz Enterprise kiadás-alkalmazás üzembe helyezéséhez a Linuxon futó szolgáltatás Azure-alkalmazás. Célszerű a Java SE-telepítést választani Tomcat-és WAR-fájlok helyett, ha egyetlen üzembe helyezhető összetevőben szeretné összevonni az alkalmazás függőségeit, futtatókörnyezetét és konfigurációját.

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

Előfeltételek

Bejelentkezés az Azure CLI-be

A Legegyszerűbb és legegyszerűbb módja annak, hogy a Maven beépülő modul üzembe helyezze a Kumuluz Enterprise kiadás alkalmazást az Azure CLI használatával.

Jelentkezzen be az Azure-fiókjába az Azure CLI használatával:

az login

A bejelentkezési folyamat végrehajtásához kövesse az utasításokat.

Mintaalkalmazás létrehozása a MicroProfile Starterből

Ebben a szakaszban létrehoz egy Kumuluz Enterprise kiadás alkalmazást, és helyileg teszteli azt.

Java Standard kiadás 8 alapprojekt létrehozása

  1. Nyisson meg egy webböngészőt, és keresse meg a MicroProfile Starter webhelyet.

    Képernyőkép a MicroProfile Starterről, amelyen a Kumuluz Enterprise kiadás futtatókörnyezet van kiválasztva.

  2. Adja meg vagy jelölje ki a mezőt az alábbiak szerint.

    Mező Érték
    groupId com.microsoft.azure.samples.kumuluzee
    artifactId kumuluz Enterprise kiadás-hello-azure
    MicroProfile-verzió MP 3.2
    Java Standard kiadás verziója Java 8
    MicroProfile-futtatókörnyezet Kumuluz Enterprise kiadás
    Példák specifikációkra Metrikák, OpenAPI
  3. A projekt letöltéséhez válassza a LETÖLTÉS lehetőséget.

  4. Bontsa ki az archív fájlt; például:

    unzip kumuluzEE-hello-azure.zip
    

Az alkalmazás futtatása helyi környezetben

  1. Váltsa a könyvtárat a befejezett projektre, például:

    cd kumuluzEE-hello-azure/
    
  2. A projekt létrehozása a Maven használatával; például:

    mvn clean package
    
  3. Futtassa az alkalmazást a következő paranccsal:

    java -jar target/kumuluzEE-hello-azure.jar
    
  4. Tesztelje a webalkalmazást. Ehhez nyissa meg helyileg egy webböngészőben. Használhatja például a következő parancsot, ha elérhető a curl:

    curl http://localhost:8080/data/hello
    
  5. A következő üzenet jelenik meg: "Helló világ!" alkalmazás.

A Maven Plugin for Azure App Service konfigurálása

Ebben a szakaszban konfigurálja a Kumuluz Enterprise kiadás projektfájlt pom.xml, hogy a Maven üzembe tudja helyezni az alkalmazást Azure-alkalmazás Linuxon futó szolgáltatásban.

  1. Nyissa meg a pom.xml fájlt egy kódszerkesztőben.

  2. <build> A pom.xml fájl szakaszában szúrja be a következő <plugin> bejegyzést a <plugins> címkébe.

    <build>
      <finalName>kumuluzEE-hello-azure</finalName>
      <plugins>
        <plugin>
          <groupId>com.microsoft.azure</groupId>
          <artifactId>azure-webapp-maven-plugin</artifactId>
          <version>1.10.0</version>
        </plugin>
      </plugins>
    </build>
    
  3. Ezután konfigurálhatja az üzembe helyezést. Futtassa a következő Maven-parancsot:

    mvn azure-webapp:config
    

    Amikor a rendszer kéri, válassza a következő beállításokat:

    Beviteli mező Bemenet/Érték kiválasztása
    Az operációs rendszer értékének meghatározása (alapértelmezett: Linux): 1. linux
    A javaVersion értékének meghatározása (alapértelmezett: Java 8): 2. Java 8
    Confirm (Y/N) (Megerősítés: I/N) y

    Ez a parancs az alábbi példához hasonló kimenetet hoz létre:

    [INFO] Scanning for projects...
    [INFO]
    [INFO] ----< com.microsoft.azure.samples.kumuluzee:kumuluzEE-hello-azure >-----
    [INFO] Building kumuluzEE-hello-azure 1.0-SNAPSHOT
    [INFO] --------------------------------[ jar ]---------------------------------
    [INFO]
    [INFO] --- azure-webapp-maven-plugin:1.10.0:config (default-cli) @ kumuluzEE-hello-azure ---
    1. linux [*]
    2. windows
    3. docker
    Enter index to use: 1
    Define value for javaVersion(Default: Java 8):
    1. Java 11
    2. Java 8 [*]
    Enter index to use: 2
    Please confirm webapp properties
    AppName : kumuluzEE-hello-azure-1601006602397
    ResourceGroup : kumuluzEE-hello-azure-1601006602397-rg
    Region : westeurope
    PricingTier : PremiumV2_P1v2
    OS : Linux
    RuntimeStack : JAVA 8-jre8
    Deploy to slot : false
    Confirm (Y/N)? : y
    [INFO] Saving configuration to pom.
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  44.223 s
    [INFO] Finished at: 2020-09-25T13:04:02+09:00
    [INFO] ------------------------------------------------------------------------
    
  4. Adja hozzá a <appSettings> szakaszt az <configuration>PORT, WEBSITES_PORTés WEBSITES_CONTAINER_START_TIME_LIMIT. Az XML-bejegyzés azure-webapp-maven-plugin a következő példához hasonlóan fog kinézni:

    <plugin>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>azure-webapp-maven-plugin</artifactId>
      <version>1.10.0</version>
      <configuration>
        <schemaVersion>V2</schemaVersion>
        <resourceGroup>microprofile</resourceGroup>
        <appName>kumuluzEE-hello-azure-1601006602397</appName>
        <pricingTier>P1v2</pricingTier>
        <region>japaneast</region>
        <runtime>
          <os>linux</os>
          <javaVersion>jre8</javaVersion>
          <webContainer>jre8</webContainer>
        </runtime>
        <appSettings>
          <property>
            <name>PORT</name>
            <value>8080</value>
          </property>
          <property>
            <name>WEBSITES_PORT</name>
            <value>8080</value>
          </property>
          <property>
            <name>WEBSITES_CONTAINER_START_TIME_LIMIT</name>
            <value>600</value>
          </property>
        </appSettings>
        <deployment>
          <resources>
            <resource>
              <directory>${project.basedir}/target</directory>
              <includes>
                <include>*.jar</include>
              </includes>
            </resource>
          </resources>
        </deployment>
      </configuration>
    </plugin>
    

Az alkalmazás üzembe helyezése az Azure-ban

Miután konfigurálta a cikk előző szakaszaiban szereplő összes beállítást, készen áll a webalkalmazás Azure-ban való üzembe helyezésére. Ehhez a következőket kell tennie:

  1. A korábban használt parancssorból vagy a terminálablakből hozza létre újra a JAR-fájlt a Mavennel, ha módosította a pom.xml fájlt, például:

    mvn clean package
    
  2. Helyezze üzembe a webalkalmazást az Azure-on a Mavennel, például:

    mvn azure-webapp:deploy
    

Ha az üzembe helyezés sikeres volt, a következő kimenet jelenik meg.

[INFO] Successfully deployed the artifact to https://kumuluzee-hello-azure-1601006602397.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  01:23 min
[INFO] Finished at: 2020-09-25T13:13:14+09:00
[INFO] ------------------------------------------------------------------------

A Maven üzembe helyezi a webalkalmazást az Azure-ban. Ha a webalkalmazás vagy a webalkalmazás-csomag még nem létezik, akkor az Ön számára jön létre. A webalkalmazás megjelenése a kimeneti URL-címen néhány percet is igénybe vehet. Nyissa meg az URL-címet egy webböngészőben. A következő képernyőnek kell megjelennie.

Képernyőkép a Kumuluz Enterprise kiadás kezdőlapját megjelenítő webböngészőről.

A web üzembe helyezése után az Azure Portalon kezelheti.

A webalkalmazás megjelenik a mikroprofil-erőforráscsoportban .

A webalkalmazáshoz úgy férhet hozzá, ha a webalkalmazás Áttekintés lapján a Tallózás lehetőséget választja. Ellenőrizze, hogy az üzembe helyezés sikeres volt-e, és fut-e.

A naplóstream megerősítése a futó App Service-ből

A naplókat a futó App Service-ből tekintheti meg (vagy "tail"). A helykódban lévő összes hívás console.log megjelenik a terminálban.

az webapp log tail \
    --resource-group microprofile \
    --name kumuluzEE-hello-azure-1601006602397

Képernyőkép a naplóstreamet megjelenítő terminálablakról.

Az erőforrások eltávolítása

Ha már nincs szükség az Azure-erőforrásokra, törölje az üzembe helyezett erőforrásokat az erőforráscsoport törlésével.

  • Az Azure Portalon válassza az Erőforráscsoport lehetőséget a bal oldali menüben.
  • Írja be a mikroprofilt a Szűrő név alapján mezőbe, az oktatóanyagban létrehozott erőforráscsoportnak rendelkeznie kell ezzel az előtaggal.
  • Válassza ki az ebben a cikkben létrehozott erőforráscsoportot.
  • A felső menüben válassza az Erőforráscsoport törlése lehetőséget.

Következő lépések

Ha többet szeretne megtudni a MicroProfile-ról és az Azure-ról, folytassa a MicroProfile-tal az Azure dokumentációs központjában.

További erőforrások

A cikkben tárgyalt különféle technológiákkal kapcsolatos további információkért tekintse meg az alábbi cikkeket: