練習 - 將 Web 應用程式部署至 Azure App Service

已完成

在此單元中,您會將 Java Tomcat Web 應用程式部署至 Azure App Service。

適用於 Azure App Service 的 Maven 外掛程式

Microsoft 提供適用於 Azure App Service 的 Maven 外掛程式,讓 Java 開發人員輕鬆將應用程式部署到 Azure。 透過使用此外掛程式,您可以輕鬆設定應用程式,並將其部署到 Azure。 使用下列各節中的步驟來設定外掛程式、編譯原始程式碼,以及部署應用程式。

設定適用於 Azure App Service 的 Maven 外掛程式

若要設定適用於 Azure App Service 的 Maven 外掛程式,請使用下列步驟:

  1. 使用下列命令開始設定:

    mvn com.microsoft.azure:azure-webapp-maven-plugin:2.10.0:config
    
  2. 使用 命令之後,提示中會出現一些問題,讓您能夠設定各種選項。 根據下表中的資訊設定選項和值:

    項目 輸入值
    訂閱 選擇 Azure 訂用帳戶。
    定義 OS 的值 Linux
    定義定價層的值 B1
    定義 Java 版本的值 Java 21
    定義執行階段堆疊的值 TOMCAT 10.0
    確認 (Y/N)

    設定選項之後,通常會有下列輸出:

    mvn com.microsoft.azure:azure-webapp-maven-plugin:2.10.0:config
    [INFO] Scanning for projects...
    [INFO]
    [INFO] -------------------< com.example:simple-tomcat-app >--------------------
    [INFO] Building simple-tomcat-app 1.0-SNAPSHOT
    [INFO]   from pom.xml
    [INFO] --------------------------------[ war ]---------------------------------
    [INFO]
    [INFO] --- azure-webapp:2.10.0:config (default-cli) @ simple-tomcat-app ---
    Downloading from central: https://repo.maven.apache.org/maven2/net/minidev/json-smart/maven-metadata.xml
    Downloading from ossrh: https://oss.sonatype.org/content/repositories/snapshots/net/minidev/json-smart/maven-metadata.xml
    Downloading from shibboleth-repo: https://build.shibboleth.net/nexus/content/repositories/releases/net/minidev/json-smart/maven-metadata.xml
    Downloaded from central: https://repo.maven.apache.org/maven2/net/minidev/json-smart/maven-metadata.xml (1.3 kB at 6.3 kB/s)
    Please choose which part to config [Application]:
    * 1: Application
      2: Runtime
      3: DeploymentSlot
    Enter your choice: 1
    Define value for appName [simple-tomcat-app]: tomcatmavendemo
    Define value for resourceGroup [tomcatmavendemo-rg]: MyResourceGroup
    Define value for region [{azure.region}]: centralus
    Define value for pricingTier [B1]:
    *  1: B1
       2: B2
       3: B3
       4: D1
       5: EP1
       6: EP2
       7: EP3
       8: F1
       9: P1v2
      10: P1v3
      11: P2v2
      12: P2v3
      13: P3v2
      14: P3v3
      15: S1
      16: S2
      17: S3
      18: Y1
    Enter your choice: 1
    Please confirm webapp properties
    AppName : tomcatmavendemo
    ResourceGroup : MyResourceGroup
    Region : centralus
    PricingTier : B1
    OS : Linux
    Java Version: 21
    Web server stack: Tomcat 10.1
    Deploy to slot : false
    Confirm (Y/N) [Y]: Y
    [INFO] Saving configuration to pom.
    [INFO] ------------------------------------------------------------------------
    [INFO] BUILD SUCCESS
    [INFO] ------------------------------------------------------------------------
    [INFO] Total time:  01:49 min
    [INFO] Finished at: 2024-11-07T09:54:55-08:00
    [INFO] ------------------------------------------------------------------------
    
  3. 您的 pom.xml 檔案中的 <plugins> 區段現在包含了一個新的子區段。 如果您想要變更資源組名、實例名稱或部署位置,請變更、 <resourceGroup><appName> 元素中的<region>值。 下列範例顯示典型的 pom.xml 檔案:

          <!-- Azure Web App Maven Plugin -->
    <plugin>
        <groupId>com.microsoft.azure</groupId>
        <artifactId>azure-webapp-maven-plugin</artifactId>
        <version>2.10.0</version>
        <configuration>
            <resourceGroup>MyResourceGroup</resourceGroup>
            <appName>tomcatmavendemo</appName>
            <region>centralus</region>
            <pricingTier>B1</pricingTier>
            <runtime>
                <os>linux</os>
                <javaVersion>21</javaVersion>
                <webContainer>Tomcat 10.1</webContainer>
            </runtime>
            <deployment>
                <resources>
                    <resource>
                        <directory>${project.build.directory}</directory>
                        <includes>
                            <include>*.war</include>
                        </includes>
                    </resource>
                </resources>
            </deployment>
        </configuration>
    </plugin>
    

編譯及部署到 Azure App Service

現在您已完成設定以部署至 Azure App Service 的設定,請使用下列步驟來編譯原始碼,並將您的應用程式部署至 Azure App Services:

  1. 使用下列命令再次編譯原始碼:

    mvn clean package
    
  2. 編譯原始碼之後,請使用下列命令來部署您的應用程式:

    mvn azure-webapp:deploy
    

部署完成時,通常會有下列輸出:

[INFO] Successfully deployed the artifact to https://tomcatmavendemo.azurewebsites.net
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time:  06:55 min
[INFO] Finished at: 2024-11-07T10:05:19-08:00
[INFO] ------------------------------------------------------------------------

如您所見,該輸出會提供已部署應用程式的公用URL: Successfully deployed the artifact to https://tomcatmavendemo.azurewebsites.net

當您瀏覽至應用程式時,看起來應該類似下列螢幕快照:

顯示瀏覽器中已部署 Web 應用程式的螢幕快照。

確認記錄數據流

若要存取記錄資料流,請使用下列命令:

az webapp log tail \
    --resource-group <your-resource-group> \
    --name <your-app-name>

下列輸出是典型的:

2024-11-07T18:14:37  Welcome, you are now connected to log-streaming service.
Starting Log Tail -n 10 of existing logs ----
/appsvctmp/volatile/logs/runtime/container.log
2024-11-07T18:06:05.3874260Z  java.base/java.lang.Thread.run(Thread.java:1583)
2024-11-07T18:06:05.5635356Z Nov 07, 2024 6:06:05 PM org.apache.coyote.AbstractProtocol stop
2024-11-07T18:06:05.5636042Z INFO: Stopping ProtocolHandler ["http-nio-127.0.0.1-80"]
2024-11-07T18:06:05.6020767Z Nov 07, 2024 6:06:05 PM org.apache.coyote.AbstractProtocol stop
2024-11-07T18:06:05.6021438Z INFO: Stopping ProtocolHandler ["http-nio-169.254.129.3-80"]
2024-11-07T18:06:05.6423756Z Nov 07, 2024 6:06:05 PM org.apache.coyote.AbstractProtocol destroy
2024-11-07T18:06:05.6424403Z INFO: Destroying ProtocolHandler ["http-nio-127.0.0.1-80"]
2024-11-07T18:06:05.6893602Z Nov 07, 2024 6:06:05 PM org.apache.coyote.AbstractProtocol destroy
2024-11-07T18:06:05.6894311Z INFO: Destroying ProtocolHandler ["http-nio-169.254.129.3-80"]
2024-11-07T18:06:05.7849816Z Done processing signal SIGTERM. Exiting now!
Ending Log Tail of existing logs ---
Starting Live Log Stream ---

練習摘要

在本單元中,您已瞭解如何使用 Maven 建立 Tomcat Web 應用程式。 您也瞭解如何建立 servlet 及其運作方式。 接下來,您已使用 Tomcat 在本機部署 Web 應用程式。 最後,您已部署至 Azure App Service,供世界上任何人存取。