Nasazení webové aplikace Payara Micro pro Azure App Service s Maven

V tomto rychlém startu použijete modul plug-in Maven pro Azure App Service Web Apps k nasazení aplikace Payara Micro na Azure App Service na Linux. Pokud chcete sloučit závislosti aplikace, modul runtime a konfiguraci do jediného nasaditelného artefaktu, můžete zvolit nasazení Java SE pomocí Tomcatu a souborů WAR.

Pokud ještě nemáte předplatné Azure, vytvořte si bezplatný účet před tím, než začnete.

Požadavky

Instalace a přihlášení do Azure CLI

Nejjednodušší a nejjednodušší způsob, jak získat modul plug-in pro Maven nasazení aplikace PayaraMicro, je pomocí Azure CLI.

Pomocí Azure CLI se přihlaste ke svému účtu Azure:

az login

Postupujte podle pokynů a dokončete proces přihlášení.

Vytvoření ukázkové aplikace z úvodní služby mikroprofile

V této části vytvoříte aplikaci PayaraMicro a lokálně otestujete ji.

  1. Otevřete webový prohlížeč a přejděte k webu profil Starter .

    Mikroprofiler Starter pro Payara Micro

  2. Zadejte nebo vyberte toto pole jako následující.

    Pole Hodnota
    groupId com. Microsoft. Azure. Samples. payaramicro
    artifactId payaramicro-Hello – Azure
    Verze mikroprofilu MP 3,2
    verze Java SE Java 11
    Modul runtime mikroprofile PayaraMicro
    Příklady pro specifikace Metriky, OpenAPI
  3. Kliknutím na tlačítko Stáhnout Stáhněte projekt.

  4. Rozbalíte soubor archivu; například:

    unzip payaraMicro-hello-azure.zip
    

Spuštění aplikace v místním prostředí

  1. Přejděte do adresáře dokončeného projektu. Například:

    cd payaramicro-hello-azure/
    
  2. Sestavte projekt pomocí Maven; například:

    mvn clean package
    
  3. Spustit projekt; například:

    java -jar target/payaramicro-hello-azure-microbundle.jar
    
  4. Otestujte webovou aplikaci tak, že ji místně otevřete ve webovém prohlížeči. Pokud máte k dispozici nástroj curl, můžete například použít následující příkaz:

    curl http://localhost:8080/data/hello
    
  5. Měla by se zobrazit následující zpráva: Hello World

Konfigurace modulu plug-in Maven pro Azure App Service

V této části nakonfigurujete soubor pom.xml projektu PayaraMicro tak, aby Maven mohl nasadit aplikaci pro Azure App Service na Linux.

  1. Otevřete pom.xml soubor v editoru kódu.

  2. V <build> části <build> souboru vložte do <plugin> značky následující položku <plugins> .

    <build>
      <finalName>payaramicro-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. Potom můžete nakonfigurovat nasazení, spustit na příkazovém řádku následující příkaz Mavenu a použít číslo k výběru těchto možností na příkazovém řádku:

    mvn azure-webapp:config
    

    Parametr možnosti:

    Vstupní pole Zadat/vybrat hodnotu
    Definovat hodnotu pro operační systém (výchozí: Linux): 1. Linux
    Definovat hodnotu pro javaVersion (výchozí: Java 8): 1. Java 11
    Zadejte hodnotu pro runtimeStack (výchozí: TOMCAT 8,5): TOMCAT 8,5
    Confirm (Y/N) y

    [! Poznámka] i když nepoužíváme Tomcat, vyberte TOMCAT 8.5 v tomto čase? V konfiguraci podrobností změníme hodnotu z na TOMCAT 8.5 na Java11 pozdější. * *

    Můžete nakonfigurovat pomocí následujícího příkazu:

    mvn azure-webapp:config
    [INFO] Scanning for projects...
    [INFO] 
    [INFO] --< com.microsoft.azure.samples.payaramicro:payaramicro-hello-azure >---
    [INFO] Building payaramicro-hello-azure 1.0-SNAPSHOT
    [INFO] --------------------------------[ war ]---------------------------------
    [INFO] 
    [INFO] --- azure-webapp-maven-plugin:1.10.0:config (default-cli) @ payaramicro-hello-azure ---
    Define value for OS(Default: Linux): 
    1. linux [*]
    2. windows
    3. docker
    Enter index to use: 
    Define value for javaVersion(Default: Java 8): 
    1. Java 11
    2. Java 8 [*]
    Enter index to use: 1
    Define value for runtimeStack(Default: TOMCAT 8.5): 
    1. TOMCAT 9.0
    2. TOMCAT 8.5 [*]
    Enter index to use: 
    Please confirm webapp properties
    AppName : payaramicro-hello-azure-1601009217863
    ResourceGroup : payaramicro-hello-azure-1601009217863-rg
    Region : westeurope
    PricingTier : PremiumV2_P1v2
    OS : Linux
    RuntimeStack : TOMCAT 8.5-java11
    Deploy to slot : false
    Confirm (Y/N)? : y
    [INFO] Saving configuration to pom.
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  22.302 s
    [INFO] Finished at: 2020-09-25T13:47:11+09:00
    [INFO] ------------------------------------------------------------------------
    
  4. Upravte modul runtime z TOMCAT 8.5 na java11 a ze souboru nasazení z *.war na *.jar . Pak přidejte <appSettings> oddíl do <configuration> oddílu PORT , WEBSITES_PORT a WEBSITES_CONTAINER_START_TIME_LIMIT .
    Nakonec uvidíte následující položku XML pro azure-webapp-maven-plugin .

    <plugin>
      <groupId>com.microsoft.azure</groupId>
      <artifactId>azure-webapp-maven-plugin</artifactId>
      <version>1.9.1</version>
      <configuration>
        <schemaVersion>V2</schemaVersion>
        <resourceGroup>microprofile</resourceGroup>
        <appName>payaramicro-hello-azure-1591860934798</appName>
        <pricingTier>P1v2</pricingTier>
        <region>japaneast</region>
        <runtime>
          <os>linux</os>
          <javaVersion>java11</javaVersion>
          <webContainer>java11</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>
    

Nasadit aplikaci do Azure

Jakmile nakonfigurujete všechna nastavení v předchozích částech tohoto článku, budete připraveni nasadit webovou aplikaci do Azure. Můžete to udělat podle následujících kroků:

  1. Pokud jste provedli nějaké změny v souboru pom.xml, na příkazovém řádku nebo v okně terminálu, které jste používali dříve, znovu zkompilujte soubor JAR pomocí Mavenu. Například:

    mvn clean package
    
  2. Nasaďte webovou aplikaci do Azure pomocí Mavenu. Například:

    mvn azure-webapp:deploy
    

    Pokud jste nasazení úspěšně nadokončili, můžete se podívat na následující zprávu v konzole.

    mvn azure-webapp:deploy
    
    [INFO] Successfully deployed the artifact to https://payaramicro-hello-azure-1601009217863.azurewebsites.net
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  01:58 min
    [INFO] Finished at: 2020-09-25T13:55:13+09:00
    [INFO] ------------------------------------------------------------------------
    

    Maven nasadí vaši webovou aplikaci do Azure. Pokud webová aplikace nebo plán webové aplikace ještě neexistuje, vytvoří se pro vás. Může trvat několik minut, než bude webová aplikace viditelná na adrese URL zobrazené ve výstupu. Ve webovém prohlížeči přejděte na příslušnou adresu URL. Měla by se zobrazit následující obrazovka.

    Přední stránka Payara Micro

    Po nasazení webu ho budete moct spravovat prostřednictvím Azure Portal.

    • Vaše webová aplikace bude uvedena ve skupině prostředků mikroprofilu :

    Webová aplikace uvedená v seznamu App Services na webu Azure Portal

    • A ke své webové aplikaci máte přístup kliknutím na Browse tlačítko v Browse webové aplikace.
      Ověřte, že nasazení proběhlo úspěšně a běželo. Měla by se zobrazit následující obrazovka:

    Vyhledání adresy URL webové aplikace v App Services na webu Azure Portal

Potvrďte spuštění datového proudu protokolu App Service

Můžete zobrazit (neboli "koncově") protokoly ze spuštěných App Service. Všechna volání console.log v kódu lokality se zobrazí v terminálu.

az webapp log tail -g microprofile -n payaramicro-hello-azure-1601009217863

Potvrďte datový proud protokolu

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

Pokud už nasazené prostředky Azure nepotřebujete, vyčistěte je odstraněním skupiny prostředků.

  • Na webu Azure Portal vyberte v nabídce nalevo Skupina prostředků.
  • Do pole filtrovat podle názvu zadejte mikroprofile . skupina prostředků vytvořená v tomto kurzu by měla mít tuto předponu.
  • Vyberte skupinu prostředků, kterou jste vytvořili v tomto kurzu.
  • V horní nabídce vyberte Odstranit skupinu prostředků.

Další kroky

Pokud se chcete dozvědět víc o mikroprofilech a Azure, přejděte k mikroprofilu v centru dokumentace Azure.

Další materiály

Další informace o různých technologiích probíraných v tomto článku najdete v následujících článcích: