在 Azure 应用服务中部署和配置 Tomcat 或 Java SE 应用

本文介绍应用服务中 Java 应用的最常见部署和运行时配置。 如果你从未用过 Azure 应用服务，首先应该通读 Java 快速入门。 应用服务常见问题解答中解答了有关使用应用服务且非特定于 Java 开发的一般问题。

Azure 应用服务以三种形式在完全托管的服务上运行 Java Web 应用程序：

• Java SE - 可以运行作为 JAR 包（其中包含嵌入式服务器）部署的应用（例如 Spring Boot、Dropwizard、Quarkus，或包含嵌入式 Tomcat 或 Jetty 服务器的应用）。
• Tomcat - 内置的 Tomcat 服务器可以运行作为 WAR 包部署的应用。

显示 Java 版本

az webapp config show --resource-group <resource-group-name> --name <app-name> --query linuxFxVersion

az webapp list-runtimes --os linux | grep "JAVA\|TOMCAT\|JBOSSEAP"

az webapp config show --name <app-name> --resource-group <resource-group-name> --query "[javaVersion, javaContainer, javaContainerVersion]"

az webapp list-runtimes --os windows | grep java

有关版本支持的详细信息，请参阅应用服务语言运行时支持策略。

部署应用

生成工具

Maven

使用适用于 Azure Web 应用的 Maven 插件，可以在项目根中使用一个命令来轻松为 Azure Web 应用准备 Maven Java 项目：

mvn com.microsoft.azure:azure-webapp-maven-plugin:2.13.0:config

此命令会提示你选择现有的或创建新的 Azure Web 应用，通过这种方式来添加 azure-webapp-maven-plugin 插件和相关配置。 在配置期间，它会尝试检测应用程序是否应部署到 Java SE、Tomcat。 然后可以使用以下命令将 Java 应用部署到 Azure：

mvn package azure-webapp:deploy

下面是 pom.xml 中的示例配置：

<plugin> 
  <groupId>com.microsoft.azure</groupId>  
  <artifactId>azure-webapp-maven-plugin</artifactId>  
  <version>2.11.0</version>  
  <configuration>
    <subscriptionId>111111-11111-11111-1111111</subscriptionId>
    <resourceGroup>spring-boot-xxxxxxxxxx-rg</resourceGroup>
    <appName>spring-boot-xxxxxxxxxx</appName>
    <pricingTier>B2</pricingTier>
    <region>westus</region>
    <runtime>
      <os>Linux</os>      
      <webContainer>Java SE</webContainer>
      <javaVersion>Java 17</javaVersion>
    </runtime>
    <deployment>
      <resources>
        <resource>
          <type>jar</type>
          <directory>${project.basedir}/target</directory>
          <includes>
            <include>*.jar</include>
          </includes>
        </resource>
      </resources>
    </deployment>
  </configuration>
</plugin> 

Gradle

1. 通过将适用于 Azure Web 应用的 Gradle 插件添加到 build.gradle 来设置该插件：

   plugins {
     id "com.microsoft.azure.azurewebapp" version "1.10.0"
   }
   

2. 配置 Web 应用详细信息。 如果相应的 Azure 资源不存在，则会创建它们。 下面是示例配置。有关详细信息，请查看此文档。

   azurewebapp {
       subscription = '<your subscription id>'
       resourceGroup = '<your resource group>'
       appName = '<your app name>'
       pricingTier = '<price tier like 'P1v2'>'
       region = '<region like 'westus'>'
       runtime {
         os = 'Linux'
         webContainer = 'Tomcat 10.0' // or 'Java SE' if you want to run an executable jar
         javaVersion = 'Java 17'
       }
       appSettings {
           <key> = <value>
       }
       auth {
           type = 'azure_cli' // support azure_cli, oauth2, device_code and service_principal
       }
   }
   

3. 使用一个命令进行部署。

   gradle azureWebAppDeploy
   

IDE

Azure 在常用 Java IDE 中提供了无缝的 Java 应用服务开发体验，这些 IDE 包括：

• VS Code：使用 Visual Studio Code 的 Java Web 应用
• IntelliJ IDEA：使用 IntelliJ 创建适用于 Azure 应用服务的 Hello World Web 应用
• Eclipse：使用 Eclipse 创建适用于 Azure 应用服务的 Hello World Web 应用

Kudu API

不要使用 FTP 来部署 .war 或 .jar。 FTP 工具设计用来上传启动脚本、依赖项或其他运行时文件。 它不是用于部署 Web 应用的最佳选项。

重写或重定向 URL

若要重写或重定向 URL，请使用可用的 URL 重写程序之一，例如 UrlRewriteFilter。

日志记录和调试应用

可以通过 Azure 门户对每个应用使用性能报告、流量可视化和运行状况检查。

流式传输诊断日志

az webapp log config --name <app-name> --resource-group <resource-group-name> --docker-container-logging filesystem

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

az webapp log config --resource-group <resource-group-name> --name <app-name> --docker-container-logging filesystem --level Verbose

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

Linux 中的 SSH 控制台访问

若要通过容器打开直接的 SSH 会话，应用应该处于正在运行状态。

将以下 URL 粘贴到浏览器中，将 <app-name> 替换为应用名称：

https://<app-name>.scm.chinacloudsites.cn/webssh/host

如果尚未进行身份验证，则需通过要连接的 Azure 订阅进行身份验证。 完成身份验证以后，可以看到一个浏览器内 shell，可以在其中的容器中运行命令。

若要从本地计算机打开远程 SSH 会话，请参阅从远程 shell 打开 SSH 会话。

Linux 故障排除工具

内置的 Java 映像建立在 Alpine Linux 操作系统上。 使用 apk 包管理器安装任何故障排除工具或命令。

Java 探查器

Azure 应用服务上的所有 Java 运行时都附带 JDK 运行情况记录器，用于分析 Java 工作负载。 你可以使用它来记录 JVM、系统和应用程序事件，并排查应用程序中的问题。

若要了解有关 Java 探查器的详细信息，请访问 Azure Application Insights 文档。

网络流量记录器

应用服务上的所有 Java 运行时都附带 Java Flight Recorder。 可以使用它来记录 JVM、系统和应用程序事件，并对 Java 应用程序中的问题进行故障排除。

078990bbcd11:/home# jcmd
Picked up JAVA_TOOL_OPTIONS: -Djava.net.preferIPv4Stack=true
147 sun.tools.jcmd.JCmd
116 /home/site/wwwroot/app.jar

jcmd 116 JFR.start name=MyRecording settings=profile duration=30s filename="/home/jfr_example.jfr"

az webapp config appsettings set -g <your_resource_group> -n <your_app_name> --settings JAVA_OPTS=-XX:StartFlightRecording=disk=true,name=continuous_recording,dumponexit=true,maxsize=1024m,maxage=1d

jcmd <pid> JFR.dump name=continuous_recording filename="/home/recording1.jfr"

jcmd <pid> JFR.start name=TimedRecording settings=profile duration=30s filename="C:\home\timed_recording_example.JFR"

分析 .jfr 文件

使用 FTPS 将 JFR 文件下载到本地计算机。 如果要分析 JFR 文件，请下载并安装 Java Mission Control。 有关 Java Mission Control 的说明，请参阅 JMC 文档和安装说明。

应用日志记录

如果应用程序使用 Logback 或 Log4j 进行跟踪，则你可以遵照在 Application Insights 中浏览 Java 跟踪日志中的日志记录框架配置说明，将这些用于审查的跟踪写入到 Azure Application Insights。

自定义和优化

Azure 应用服务原生支持通过 Azure 门户和 CLI 进行优化和自定义。 请查看以下文章了解非特定于 Java 的 Web 应用配置：

• 配置应用设置
• 设置自定义域
• 配置 TLS/SSL 绑定
• 配置 Kudu 站点

在本地复制应用内容

将应用设置 JAVA_COPY_ALL 设为 true，以将应用内容从共享文件系统复制到本地辅助角色。 此设置有助于解决文件锁定问题。

设置 Java 运行时选项

若要设置分配的内存或其他 JVM 运行时选项，请使用这些选项创建名为 JAVA_OPTS 的应用设置。 应用服务在启动时，会将此设置作为环境变量传递给 Java 运行时。

若要通过 Maven 插件配置应用设置，请在 Azure 插件部分中添加设置/值标记。 以下示例设置特定的最小和最大 Java 堆大小：

<appSettings>
    <property>
        <name>JAVA_OPTS</name>
        <value>-Xms1024m -Xmx1024m</value>
    </property>
</appSettings>

在应用服务计划中运行包含一个部署槽位的单个应用程序的开发人员可以使用以下选项：

• B1 和 S1 实例：-Xms1024m -Xmx1024m
• B2 和 S2 实例：-Xms3072m -Xmx3072m
• B3 和 S3 实例：-Xms6144m -Xmx6144m
• P1v2 实例：-Xms3072m -Xmx3072m
• P2v2 实例：-Xms6144m -Xmx6144m
• P3v2 实例：-Xms12800m -Xmx12800m
• P1v3 实例：-Xms6656m -Xmx6656m
• P2v3 实例：-Xms14848m -Xmx14848m
• I1 实例：-Xms3072m -Xmx3072m
• I2 实例：-Xms6144m -Xmx6144m
• I3 实例：-Xms12800m -Xmx12800m
• I1v2 实例：-Xms6656m -Xmx6656m
• I2v2 实例：-Xms14848m -Xmx14848m
• I3v2 实例：-Xms30720m -Xmx30720m

优化应用程序堆设置时，请查看应用服务计划详细信息，并考虑多个应用程序和部署槽位方面的需求，以得出最佳内存分配。

启用 Web 套接字

在 Azure 门户中应用程序的“应用程序设置”中启用 Web 套接字支持。 需要重启应用程序才能使设置生效。

在 Azure CLI 中使用以下命令启用 Web 套接字支持：

az webapp config set --name <app-name> --resource-group <resource-group-name> --web-sockets-enabled true

然后重启应用程序：

az webapp stop --name <app-name> --resource-group <resource-group-name>
az webapp start --name <app-name> --resource-group <resource-group-name>

设置默认的字符编码

在 Azure 门户中 Web 应用的“应用程序设置”下，创建名为 JAVA_OPTS 且包含值 -Dfile.encoding=UTF-8 的新应用设置。

或者，可以使用应用服务 Maven 插件配置应用设置。 在插件配置中添加设置名称和值标记：

<appSettings>
    <property>
        <name>JAVA_OPTS</name>
        <value>-Dfile.encoding=UTF-8</value>
    </property>
</appSettings>

日志中的 robots933456

你可能会在容器日志中看到以下消息：

2019-04-08T14:07:56.641002476Z "-" - - [08/Apr/2019:14:07:56 +0000] "GET /robots933456.txt HTTP/1.1" 404 415 "-" "-"

可以放心忽略此消息。 /robots933456.txt 是一个虚拟 URL 路径，应用服务使用它来检查容器能否为请求提供服务。 404 响应只是指示该路径不存在，但它让应用服务知道容器处于正常状态并已准备就绪，可以响应请求。

选择 Java 运行时版本

应用服务允许用户选择 JVM 的主版本（例如 Java 8 或 Java 11）和补丁版本（例如 1.8.0_232 或 11.0.5）。 还可以选择在新的次要版本可用时自动更新补丁版本。 在大多数情况下，生产应用应使用 JVM 的固定补丁版本。 这可防止在补丁版本自动更新期间发生意外中断。 所有 Java Web 应用都使用 64 位 JVM，这是不可配置的。

如果选择固定次要版本，则需要定期更新应用上 JVM 的次要版本。 为了确保应用程序在较新的次要版本上运行，请创建一个过渡槽并在暂存站点上递增次要版本。 确认应用程序在新的次要版本上正常运行后，可以交换过渡槽和生产槽。

<Connector port="${port.http}" address="127.0.0.1" maxHttpHeaderSize="16384" compression="on" URIEncoding="UTF-8" connectionTimeout="${site.connectionTimeout}" maxThreads="${catalina.maxThreads}" maxConnections="${catalina.maxConnections}" protocol="HTTP/1.1" redirectPort="8443"/>

az webapp config appsettings set --resource-group myResourceGroup --name myApp --settings WEBSITE_TOMCAT_CONNECTION_TIMEOUT=120000

az webapp config appsettings set --resource-group myResourceGroup --name myApp --settings WEBSITE_CATALINA_MAXTHREADS=100

az webapp config appsettings set --resource-group myResourceGroup --name myApp --settings WEBSITE_CATALINA_MAXCONNECTIONS=5000

<Host appBase="${site.appbase}" xmlBase="${site.xmlbase}" unpackWARs="${site.unpackwars}" workDir="${site.tempdir}" errorReportValveClass="com.microsoft.azure.appservice.AppServiceErrorReportValve" name="localhost" autoDeploy="true">

<Valve prefix="site_access_log.${catalina.instance.name}" pattern="%h %l %u %t &quot;%r&quot; %s %b %D %{x-arr-log-id}i" directory="${site.logdir}/http/RawLogs" maxDays="${site.logRetentionDays}" className="org.apache.catalina.valves.AccessLogValve" suffix=".txt"/>

后续步骤

请访问面向 Java 开发人员的 Azure 中心查找 Azure 快速入门、教程和 Java 参考文档。

• 应用服务 Linux 常见问题解答
• 环境变量和应用设置参考