Azure 应用服务可让 Java 开发人员在完全托管服务中快速生成、部署和缩放其 Java SE、Tomcat 和 JBoss EAP Web 应用程序。 可以在命令行或者 IntelliJ、Eclipse 或 Visual Studio Code 等编辑器中使用 Maven 插件部署应用程序。
本指南为使用应用服务的 Java 开发人员提供了重要概念和说明。 如果你从未用过 Azure 应用服务,首先应该通读 Java 快速入门。 应用服务常见问题解答中解答了有关使用应用服务且非特定于 Java 开发的一般问题。
部署应用
可以使用适用于 Maven 的 Azure Web 应用插件来部署 .war 或 .jar 文件。 Azure Toolkit for IntelliJ 或 Azure Toolkit for Eclipse 还支持通过流行的 IDE 进行部署。
否则,则部署方法将取决于存档类型:
Java SE
若要将 .jar 文件部署到 Java SE,请使用 Kudu 站点的 /api/zipdeploy/ 终结点。 有关此 API 的详细信息,请参阅此文档。
Tomcat
若要将 .war 文件部署到 Tomcat,请使用 /api/wardeploy/ 终结点对存档文件执行 POST 操作。 有关此 API 的详细信息,请参阅此文档。
JBoss EAP
若要将 .war 文件部署到 JBoss,请使用 /api/wardeploy/ 终结点对存档文件执行 POST 操作。 有关此 API 的详细信息,请参阅此文档。
若要部署 .ear 文件,请使用 FTP。
不要使用 FTP 来部署 .war 或 .jar。 FTP 工具设计用来上传启动脚本、依赖项或其他运行时文件。 它不是用于部署 Web 应用的最佳选项。
日志记录和调试应用
可以通过 Azure 门户对每个应用使用性能报告、流量可视化和运行状况检查。 有关详细信息,请参阅 Azure 应用服务诊断概述。
流式传输诊断日志
若要在应用服务中从应用程序代码内部访问生成的控制台日志,请在 Cloud Shell 中运行以下命令,打开诊断日志记录:
az webapp log config --resource-group <resource-group-name> --name <app-name> --application-logging true --level Verbose
--level 的可能值为:Error、Warning、Info 和 Verbose。 每个后续级别包括上一个级别。 例如:Error 仅包含错误消息,Verbose 则包含所有消息。
启用诊断日志记录功能以后,请运行以下命令来查看日志流:
az webapp log tail --resource-group <resource-group-name> --name <app-name>
如果没有立即看到控制台日志,请在 30 秒后重新查看。
Note: 也可通过浏览器在
https://<app-name>.scm.azurewebsites.net/api/logs/docker中检查日志文件。
若要随时停止日志流式处理,请键入 Ctrl+C。
可以访问在容器中生成的控制台日志。
首先,请运行以下命令,以便启用容器日志记录功能:
az webapp log config --name <app-name> --resource-group <resource-group-name> --docker-container-logging filesystem
将 <app-name> 和 <resource-group-name> 替换为适合 Web 应用的名称。
启用容器日志记录功能以后,请运行以下命令来查看日志流:
az webapp log tail --name <app-name> --resource-group <resource-group-name>
如果没有立即看到控制台日志,请在 30 秒后重新查看。
若要随时停止日志流式处理,可键入 Ctrl+C 。
也可通过浏览器在 https://<app-name>.scm.azurewebsites.net/api/logs/docker 中检查日志文件。
有关详细信息,请参阅在 Cloud Shell 中流式传输日志。
SSH 控制台访问
若要通过容器打开直接的 SSH 会话,应用应该处于正在运行状态。
将以下 URL 粘贴到浏览器中,将 <app-name> 替换为应用名称:
https://<app-name>.scm.azurewebsites.net/webssh/host
如果尚未进行身份验证,则需通过要连接的 Azure 订阅进行身份验证。 完成身份验证以后,可以看到一个浏览器内 shell,可以在其中的容器中运行命令。
SSH 连接
Note: 在 /home 目录之外进行的任何更改均存储在容器本身中,在应用重启后不保留。
若要从本地计算机打开远程 SSH 会话,请参阅从远程 shell 打开 SSH 会话。
故障排除工具
内置的 Java 映像建立在 Alpine Linux 操作系统上。 使用 apk 包管理器安装任何故障排除工具或命令。
网络流量记录器
应用服务上使用 Azul JVM 的所有 Java 运行时均附带 Zulu 网络流量记录器。 可以使用它来记录 JVM、系统和应用程序事件,并对 Java 应用程序中的问题进行故障排除。
计时记录
若要进行定时记录,需要 Java 应用程序的 PID(进程 ID)。 若要查找 PID,请在 https://中打开 web 应用的 SCM 站点的浏览器 <> 你的 scm.azurewebsites.net/ProcessExplorer/。 此页面显示 Web 应用中正在运行的进程。 在表中找到名为“java”的进程,并复制相应的 PID(进程 ID)。
接下来,打开 SCM 站点顶部工具栏中的“调试控制台”,运行以下命令。 将 <pid> 替换为此前复制的进程 ID。 此命令会启动对 Java 应用程序的 30 秒探查器记录,并在 D:\home 目录中生成名为 timed_recording_example.jfr 的文件。
jcmd <pid> JFR.start name=TimedRecording settings=profile duration=30s filename="D:\home\timed_recording_example.JFR"
使用 SSH 进入应用服务,运行 jcmd 命令以查看所有正在运行的 Java 进程的列表。 除了 jcmd 本身,你还会看到正在运行的 Java 应用程序以及进程 ID 号 (PID)。
078990bbcd11:/home# jcmd
Picked up JAVA_TOOL_OPTIONS: -Djava.net.preferIPv4Stack=true
147 sun.tools.jcmd.JCmd
116 /home/site/wwwroot/app.jar
执行以下命令以启动对 JVM 的 30 秒记录。 此操作将分析 JVM 并创建一个名为“jfr_example.jfr”的 JFR 文件。 (将 116 替换为 Java 应用的 PID。)
jcmd 116 JFR.start name=MyRecording settings=profile duration=30s filename="/home/jfr_example.jfr"
在 30 秒的间隔内,你可以通过运行 jcmd 116 JFR.check 来验证记录是否正在进行。 这会显示给定 Java 进程的所有记录。
连续记录
你可以使用 Zulu 网络流量记录器在对运行时的性能影响最小的情况下连续分析 Java 应用程序(源)。 为此,请运行以下 Azure CLI 命令,通过必要的配置创建名为 JAVA_OPTS 的应用设置。 应用启动后,JAVA_OPTS 应用设置的内容会被传递到 java 命令。
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
开始记录后,你可以使用 JFR.dump 命令随时转储当前的记录数据。
jcmd <pid> JFR.dump name=continuous_recording filename="/home/recording1.jfr"
分析 .jfr 文件
使用 FTPS 将 JFR 文件下载到本地计算机。 如果要分析 JFR 文件,请下载并安装 Zulu Mission Control。 有关 Zulu Mission Control 的说明,请参阅 Azul 文档和安装说明。
应用日志记录
通过 Azure 门户或 Azure CLI 启用应用程序日志记录,以将应用服务配置为向本地文件系统或 Azure Blob 存储写入应用程序的标准控制台输出和标准控制台错误流。 在完成配置并经过 12 个小时后,将禁用记录到应用服务本地文件系统实例。 如果需要保留日志更长时间,请将应用程序配置为向 Blob 存储容器写入输出。 Java 和 Tomcat 应用日志位于 /home/LogFiles/Application/ 目录中。
通过 Azure 门户或 Azure CLI 启用应用程序日志记录,以将应用服务配置为向本地文件系统或 Azure Blob 存储写入应用程序的标准控制台输出和标准控制台错误流。 如果需要保留日志更长时间,请将应用程序配置为向 Blob 存储容器写入输出。 Java 和 Tomcat 应用日志位于 /home/LogFiles/Application/ 目录中。
只能使用 Azure Monitor(预览版)配置适用于基于 Linux 的应用服务的 Azure Blob 存储日志记录功能
如果应用程序使用 Logback 或 Log4j 进行跟踪,则你可以遵照在 Application Insights 中浏览 Java 跟踪日志中的日志记录框架配置说明,将这些用于审查的跟踪写入到 Azure Application Insights。
自定义和优化
适用于 Linux 的 Azure 应用服务原生支持通过 Azure 门户和 CLI 进行优化和自定义。 请查看以下文章,了解非特定于 Java 的 Web 应用配置:
设置 Java 运行时选项
若要设置分配的内存或其他 JVM 运行时选项,请使用这些选项创建名为 JAVA_OPTS 的应用设置。 应用服务在启动时,会将此设置作为环境变量传递给 Java 运行时。
在 Azure 门户中 Web 应用的“应用程序设置”下,创建名为 JAVA_OPTS 且包含其他设置的新应用设置,例如 -Xms512m -Xmx1204m。
若要通过 Maven 插件配置应用设置,请在 Azure 插件部分中添加设置/值标记。 以下示例设置特定的最小和最大 Java 堆大小:
<appSettings>
<property>
<name>JAVA_OPTS</name>
<value>-Xms512m -Xmx1204m</value>
</property>
</appSettings>
在应用服务计划中运行包含一个部署槽位的单个应用程序的开发人员可以使用以下选项:
- B1 和 S1 实例:
-Xms1024m -Xmx1024m - B2 和 S2 实例:
-Xms3072m -Xmx3072m - B3 和 S3 实例:
-Xms6144m -Xmx6144m
优化应用程序堆设置时,请查看应用服务计划详细信息,并考虑多个应用程序和部署槽位方面的需求,以得出最佳内存分配。
启用 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>
预编译 JSP 文件
要提高 Tomcat 应用程序的性能,可以先编译 JSP 文件,再部署到应用服务。 你可以使用由 Apache Sling 提供的 Maven 插件,也可以使用此 Ant 生成文件。
安全应用程序
在应用服务中运行的 Java 应用程序与其他应用程序具有相同的一组 安全最佳做法 。
对用户进行身份验证(简易身份验证)
在 Azure 门户中使用“身份验证和授权”选项设置应用身份验证。 在此处,可以使用 Azure Active Directory 或社交登录名(例如 Facebook、Google、或 GitHub)启用身份验证。 仅当配置单个身份验证提供程序时,Azure 门户配置才起作用。 有关详细信息,请参阅将应用服务应用配置为使用 Azure Active Directory 登录,以及其他标识提供者的相关文章。 如果需要启用多个登录提供程序,请遵照自定义应用服务身份验证一文中的说明。
Java SE
Spring Boot 开发人员可以使用 Azure Active Directory Spring Boot Starter 通过熟悉的 Spring Security 注释和 API 来保护应用程序。 务必增加 application.properties 文件中的最大标头大小。 我们建议值为 16384。
Tomcat
Tomcat 应用程序可通过将 Principal 对象强制转换为 Map 对象这种方式,直接从 Servlet 访问用户的声明。 Map 对象会将每个声明类型映射到该类型的声明集合。 在下面的代码中,request 是 HttpServletRequest 的实例。
Map<String, Collection<String>> map = (Map<String, Collection<String>>) request.getUserPrincipal();
现在,你可以检查 Map 对象是否有任何特定的声明。 例如,以下代码片段循环访问所有声明类型,并输出各集合的内容。
for (Object key : map.keySet()) {
Object value = map.get(key);
if (value != null && value instanceof Collection {
Collection claims = (Collection) value;
for (Object claim : claims) {
System.out.println(claims);
}
}
}
若要注销用户,请使用 /.auth/ext/logout 路径。 若要执行其他操作,请参阅介绍应用服务身份验证和授权的用法的文档。 还可以阅读关于 Tomcat HttpServletRequest 接口及其方法的官方文档。 以下 Servlet 方法是基于你的应用服务配置解除冻结的:
public boolean isSecure()
public String getRemoteAddr()
public String getRemoteHost()
public String getScheme()
public int getServerPort()
要禁用此功能,请创建一个名为 WEBSITE_AUTH_SKIP_PRINCIPAL 的应用程序设置,其值为 1。 若要禁用应用服务添加的所有 servlet 筛选器,请创建名为 WEBSITE_SKIP_FILTERS、值为 1 的设置。
配置 TLS/SSL
按照在 Azure 应用服务中使用 SSL 绑定保护自定义 DNS 名称中的说明上传现有的 SSL 证书,并将其绑定到应用程序的域名。 默认情况下,应用程序仍允许 HTTP 连接 - 请遵循教程中的具体步骤来强制实施 SSL 和 TLS。
使用 Key Vault 引用
Azure Key Vault 通过访问策略和审核历史记录提供集中式机密管理。 你可以在 Key Vault 中存储机密(例如密码或连接字符串),并通过环境变量在应用程序中访问这些机密。
首先,请按照说明执行以下操作:授予应用对 Key Vault 的访问权限以及在应用程序设置中创建对机密的 Key Vault 引用。 你可以验证在远程访问应用服务终端时,该引用是否通过输出环境变量解析为机密。
若要在 Spring 或 Tomcat 配置文件中注入这些机密,请使用环境变量注入语法(即 ${MY_ENV_VAR})。 请参阅有关外化配置的文档,了解 Spring 配置文件。
使用 Java 密钥存储
在容器启动时,系统会默认将上传到应用服务 Linux 的公用或专用证书都加载到各自的 Java 密钥存储中。 上传证书后,你需要重启应用服务,以便将它加载到 Java 密钥存储中。 系统会将公用证书加载到位于 $JAVA_HOME/jre/lib/security/cacerts 的密钥存储中,将专用证书存储到 $JAVA_HOME/lib/security/client.jks 中。
如果要在 Java 密钥存储中使用证书加密 JDBC 连接,可能需要其他配置。 请参阅适用于你所选的 JDBC 驱动程序的文档。
初始化 Java 密钥存储
要初始化 import java.security.KeyStore 对象,请使用密码加载密钥存储文件。 两个密钥存储的默认密码均为“changeit”。
KeyStore keyStore = KeyStore.getInstance("jks");
keyStore.load(
new FileInputStream(System.getenv("JAVA_HOME")+"/lib/security/cacets"),
"changeit".toCharArray());
KeyStore keyStore = KeyStore.getInstance("pkcs12");
keyStore.load(
new FileInputStream(System.getenv("JAVA_HOME")+"/lib/security/client.jks"),
"changeit".toCharArray());
手动加载密钥存储
可以手动向密钥存储加载证书。 创建应用设置 SKIP_JAVA_KEYSTORE_LOAD,将其值设置为 1,以禁止应用服务自动将证书加载到密钥存储。 所有通过 Azure 门户上传到应用服务的公用证书都存储在 /var/ssl/certs/ 下。 专用证书则存储在 /var/ssl/private/ 下。
打开与应用服务的 SSH 连接并运行命令 keytool,即可与 Java 密钥工具进行交互或对它进行调试。 请参阅密钥工具文档,获取命令列表。 有关密钥存储 API 的详细信息,请参阅官方文档。
配置 APM 平台
本部分介绍如何使用 NewRelic 和 AppDynamics 应用程序性能监视 (APM) 平台连接在 Linux 上的 Azure 应用服务上部署的 Java 应用程序。
配置 NewRelic
-
在 NewRelic.com 上创建一个 NewRelic 帐户
-
从 NewRelic 下载 Java 代理,该代理的文件名类似于 newrelic-java-x.x.x.zip。
-
复制你的许可证密钥,稍后需要使用它来配置代理。
-
通过 SSH 登录到应用服务实例,并创建新目录 /home/site/wwwroot/apm。
-
将解压缩的 NewRelic Java 代理文件上传到 /home/site/wwwroot/apm 下的一个目录中。 代理的文件应位于 /home/site/wwwroot/apm/newrelic 中。
-
修改位于 /home/site/wwwroot/apm/newrelic/newrelic.yml 处的 YAML 文件,并将占位符许可证值替换为你自己的许可证密钥。
-
在 Azure 门户中,浏览到你在应用服务中的应用程序并创建一个新的应用程序设置。
- 对于 Java SE 应用,请创建一个名为
JAVA_OPTS且值为-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar的环境变量。 - 对于 Tomcat,请创建一个名为
CATALINA_OPTS且值为-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar的环境变量。
- 对于 Java SE 应用,请创建一个名为
-
在 NewRelic.com 上创建一个 NewRelic 帐户
-
从 NewRelic 下载 Java 代理,该代理的文件名类似于 newrelic-java-x.x.x.zip。
-
复制你的许可证密钥,稍后需要使用它来配置代理。
-
通过 SSH 登录到应用服务实例,并创建新目录 /home/site/wwwroot/apm。
-
将解压缩的 NewRelic Java 代理文件上传到 /home/site/wwwroot/apm 下的一个目录中。 代理的文件应位于 /home/site/wwwroot/apm/newrelic 中。
-
修改位于 /home/site/wwwroot/apm/newrelic/newrelic.yml 处的 YAML 文件,并将占位符许可证值替换为你自己的许可证密钥。
-
在 Azure 门户中,浏览到你在应用服务中的应用程序并创建一个新的应用程序设置。
- 对于 Java SE 应用,请创建一个名为
JAVA_OPTS且值为-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar的环境变量。 - 对于 Tomcat,请创建一个名为
CATALINA_OPTS且值为-javaagent:/home/site/wwwroot/apm/newrelic/newrelic.jar的环境变量。
- 对于 Java SE 应用,请创建一个名为
如果你已有
JAVA_OPTS或CATALINA_OPTS的环境变量,请将-javaagent:/...选项追加到当前值的末尾。
配置 AppDynamics
-
在 AppDynamics.com 上创建一个 AppDynamics 帐户
-
从 AppDynamics 网站下载 Java 代理,文件名将类似于 AppServerAgent-x.x.x.xxxxx.zip
-
使用 Kudu 控制台创建新目录 /home/site/wwwroot/apm。
-
将 Java 代理文件上传到 /home/site/wwwroot/apm 下的一个目录中。 代理的文件应位于 /home/site/wwwroot/apm/appdynamics 中。
-
在 Azure 门户中,浏览到你在应用服务中的应用程序并创建一个新的应用程序设置。
- 对于 Java SE 应用,请创建一个名为
JAVA_OPTS且值为-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>的环境变量,其中,<app-name>是你的应用服务名称。 - 对于 Tomcat 应用,请创建一个名为
CATALINA_OPTS且值为-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>的环境变量,其中,<app-name>是你的应用服务名称。
- 对于 Java SE 应用,请创建一个名为
-
在 AppDynamics.com 上创建一个 AppDynamics 帐户
-
从 AppDynamics 网站下载 Java 代理,文件名将类似于 AppServerAgent-x.x.x.xxxxx.zip
-
通过 SSH 登录到应用服务实例,并创建新目录 /home/site/wwwroot/apm。
-
将 Java 代理文件上传到 /home/site/wwwroot/apm 下的一个目录中。 代理的文件应位于 /home/site/wwwroot/apm/appdynamics 中。
-
在 Azure 门户中,浏览到你在应用服务中的应用程序并创建一个新的应用程序设置。
- 对于 Java SE 应用,请创建一个名为
JAVA_OPTS且值为-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>的环境变量,其中,<app-name>是你的应用服务名称。 - 对于 Tomcat 应用,请创建一个名为
CATALINA_OPTS且值为-javaagent:/home/site/wwwroot/apm/appdynamics/javaagent.jar -Dappdynamics.agent.applicationName=<app-name>的环境变量,其中,<app-name>是你的应用服务名称。
- 对于 Java SE 应用,请创建一个名为
Note: 如果你已有
JAVA_OPTS或CATALINA_OPTS的环境变量,请将-javaagent:/...选项追加到当前值的末尾。
配置数据源
Java SE
若要连接 Spring Boot 中的数据源,我们建议创建连接字符串并将它们注入 application.properties 文件中。
-
在应用服务页面的“配置”部分,为字符串设置一个名称,将 JDBC 连接字符串粘贴到值字段中,然后将类型设置为“自定义”。 你可以选择将此连接字符串设置为槽设置。
此连接字符串可作为名为
CUSTOMCONNSTR_<your-string-name>的环境变量供应用程序访问。 例如,我们在上面创建的连接字符串将被命名为CUSTOMCONNSTR_exampledb。 -
在 application.properties 文件中,通过环境变量名称引用此连接字符串。 在我们的示例中,我们将使用以下代码。
app.datasource.url=${CUSTOMCONNSTR_exampledb}
请查看有关数据访问的 Spring Boot 文档和外化配置,详细了解此主题。
Tomcat
这些说明适用于所有数据库连接。 你需要使用你选择的数据库的驱动程序类名称和 JAR 文件来填充占位符。 下面提供了一个表,其中包含了常见数据库的类名称和驱动程序下载。
| 数据库 | 驱动程序类名称 | JDBC 驱动程序 |
|---|---|---|
| PostgreSQL | org.postgresql.Driver |
下载 |
| MySQL | com.mysql.jdbc.Driver |
下载(选择“独立于平台”) |
| SQL Server | com.microsoft.sqlserver.jdbc.SQLServerDriver |
下载 |
若要将 Tomcat 配置为使用 Java Database Connectivity (JDBC) 或 Java 持久性 API (JPA),请先自定义在启动时由 Tomcat 读取的 CATALINA_OPTS 环境变量。 在应用服务 Maven 插件中通过某个应用设置来设置这些值:
<appSettings>
<property>
<name>CATALINA_OPTS</name>
<value>"$CATALINA_OPTS -Ddbuser=${DBUSER} -Ddbpassword=${DBPASSWORD} -DconnURL=${CONNURL}"</value>
</property>
</appSettings>
或者在 Azure 门户的“配置” > “应用程序设置”页中设置环境变量 。
接下来,确定数据源应当供一个应用程序使用,还是供在 Tomcat servlet 上运行的所有应用程序使用。
应用程序级的数据源
-
在项目的 META-INF/ 目录中创建一个 META-INF/ 文件 。 如果没有 META-INF/ 目录,则创建一个。
-
在 context.xml 中,添加一个
Context元素以将数据源链接到 JNDI 地址。 将driverClassName占位符替换为上表中你的驱动程序的类名称。<Context> <Resource name="jdbc/dbconnection" type="javax.sql.DataSource" url="${dbuser}" driverClassName="<insert your driver class name>" username="${dbpassword}" password="${connURL}" /> </Context> -
更新应用程序的 web.xml,以便在应用程序中使用该数据源。
<resource-env-ref> <resource-env-ref-name>jdbc/dbconnection</resource-env-ref-name> <resource-env-ref-type>javax.sql.DataSource</resource-env-ref-type> </resource-env-ref>
完成配置
最后,将驱动程序 JAR 放在 Tomcat 类路径中并重启应用服务。 将 JDBC 驱动程序文件放入 /home/tomcat/lib 目录,确保它们可供 Tomcat 类加载器使用。 (如果此目录尚未存在,请创建它。)若要将这些文件上传到应用服务实例,请执行以下步骤:
-
在 Cloud Shell 中,安装 webapp 扩展:
az extension add -–name webapp -
运行以下 CLI 命令,创建从本地系统到应用服务的 SSH 隧道:
az webapp remote-connection create --resource-group <resource-group-name> --name <app-name> --port <port-on-local-machine> -
使用 SFTP 客户端连接到本地隧道端口,并将文件上传到 /home/tomcat/lib 文件夹。
另外,也可以使用某个 FTP 客户端上传 JDBC 驱动程序。 请遵循这些用于获取 FTP 凭据的说明。
Tomcat
这些说明适用于所有数据库连接。 你需要使用你选择的数据库的驱动程序类名称和 JAR 文件来填充占位符。 下面提供了一个表,其中包含了常见数据库的类名称和驱动程序下载。
| 数据库 | 驱动程序类名称 | JDBC 驱动程序 |
|---|---|---|
| PostgreSQL | org.postgresql.Driver |
下载 |
| MySQL | com.mysql.jdbc.Driver |
下载(选择“独立于平台”) |
| SQL Server | com.microsoft.sqlserver.jdbc.SQLServerDriver |
下载 |
若要将 Tomcat 配置为使用 Java Database Connectivity (JDBC) 或 Java 持久性 API (JPA),请先自定义在启动时由 Tomcat 读取的 CATALINA_OPTS 环境变量。 在应用服务 Maven 插件中通过某个应用设置来设置这些值:
<appSettings>
<property>
<name>CATALINA_OPTS</name>
<value>"$CATALINA_OPTS -Ddbuser=${DBUSER} -Ddbpassword=${DBPASSWORD} -DconnURL=${CONNURL}"</value>
</property>
</appSettings>
或者在 Azure 门户的“配置” > “应用程序设置”页中设置环境变量 。
接下来,确定数据源应当供一个应用程序使用,还是供在 Tomcat servlet 上运行的所有应用程序使用。
应用程序级的数据源
-
在项目的 META-INF/ 目录中创建一个 META-INF/ 文件 。 如果没有 META-INF/ 目录,则创建一个。
-
在 context.xml 中,添加一个
Context元素以将数据源链接到 JNDI 地址。 将driverClassName占位符替换为上表中你的驱动程序的类名称。<Context> <Resource name="jdbc/dbconnection" type="javax.sql.DataSource" url="${dbuser}" driverClassName="<insert your driver class name>" username="${dbpassword}" password="${connURL}" /> </Context> -
更新应用程序的 web.xml以便在应用程序中使用该数据源。
<resource-env-ref> <resource-env-ref-name>jdbc/dbconnection</resource-env-ref-name> <resource-env-ref-type>javax.sql.DataSource</resource-env-ref-type> </resource-env-ref>
共享的服务器级资源
添加共享的服务器级数据源需要编辑 Tomcat 的 server.xml。 首先,上传启动脚本,然后在“配置” > “启动命令”中设置该脚本的路径 。 你可以使用 FTP 上传启动脚本。
启动脚本将进行 xsl 转换,转换为 server.xml 文件,并将所得的 xml 文件输出到 /usr/local/tomcat/conf/server.xml。 启动脚本应通过 apk 安装 libxslt。 你的 xsl 文件和启动脚本均可通过 FTP 上传。 下面是一个示例启动脚本。
# Install libxslt. Also copy the transform file to /home/tomcat/conf/
apk add --update libxslt
# Usage: xsltproc --output output.xml style.xsl input.xml
xsltproc --output /home/tomcat/conf/server.xml /home/tomcat/conf/transform.xsl /usr/local/tomcat/conf/server.xml
下面提供了一个示例 xsl 文件。 该文件向 Tomcat server.xml 添加了一个新的连接器节点。
<xsl:stylesheet version="1.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<xsl:output method="xml" indent="yes"/>
<xsl:template match="@* | node()" name="Copy">
<xsl:copy>
<xsl:apply-templates select="@* | node()"/>
</xsl:copy>
</xsl:template>
<xsl:template match="@* | node()" mode="insertConnector">
<xsl:call-template name="Copy" />
</xsl:template>
<xsl:template match="comment()[not(../Connector[@scheme = 'https']) and
contains(., '<Connector') and
(contains(., 'scheme="https"') or
contains(., "scheme='https'"))]">
<xsl:value-of select="." disable-output-escaping="yes" />
</xsl:template>
<xsl:template match="Service[not(Connector[@scheme = 'https'] or
comment()[contains(., '<Connector') and
(contains(., 'scheme="https"') or
contains(., "scheme='https'"))]
)]
">
<xsl:copy>
<xsl:apply-templates select="@* | node()" mode="insertConnector" />
</xsl:copy>
</xsl:template>
<!-- Add the new connector after the last existing Connnector if there is one -->
<xsl:template match="Connector[last()]" mode="insertConnector">
<xsl:call-template name="Copy" />
<xsl:call-template name="AddConnector" />
</xsl:template>
<!-- ... or before the first Engine if there is no existing Connector -->
<xsl:template match="Engine[1][not(preceding-sibling::Connector)]"
mode="insertConnector">
<xsl:call-template name="AddConnector" />
<xsl:call-template name="Copy" />
</xsl:template>
<xsl:template name="AddConnector">
<!-- Add new line -->
<xsl:text>
</xsl:text>
<!-- This is the new connector -->
<Connector port="8443" protocol="HTTP/1.1" SSLEnabled="true"
maxThreads="150" scheme="https" secure="true"
keystroreFile="${{user.home}}/.keystore" keystorePass="changeit"
clientAuth="false" sslProtocol="TLS" />
</xsl:template>
</xsl:stylesheet>
完成配置
最后,将驱动程序 JAR 放置在 Tomcat 类路径中并重启你的应用服务。
-
将 JDBC 驱动程序文件放入 /home/tomcat/lib 目录,确保它们可供 Tomcat 类加载器使用。 (如果此目录尚未存在,请创建它。)若要将这些文件上传到应用服务实例,请执行以下步骤:
- 在 Cloud Shell 中,安装 webapp 扩展:
az extension add -–name webapp- 运行以下 CLI 命令,创建从本地系统到应用服务的 SSH 隧道:
az webapp remote-connection create --resource-group <resource-group-name> --name <app-name> --port <port-on-local-machine>- 使用 SFTP 客户端连接到本地隧道端口,并将文件上传到 /home/tomcat/lib 文件夹。
另外,也可以使用某个 FTP 客户端上传 JDBC 驱动程序。 请遵循这些用于获取 FTP 凭据的说明。
-
如果你创建了服务器级数据源,请重启应用服务 Linux 应用程序。 Tomcat 会将
CATALINA_BASE重置为/home/tomcat,并使用更新后的配置。
JBoss EAP
使用 JBoss EAP 注册数据源时,有三个核心步骤:上传 JDBC 驱动程序、添加 JDBC 驱动程序作为模块以及注册此模块。 应用服务是一种无状态托管服务,因此,必须对用于添加和注册数据源模块的配置命令编写脚本并在容器启动时应用该脚本。
-
获取数据库的 JDBC 驱动程序。
-
为 JDBC 驱动程序创建 XML 模块定义文件。 下面显示的示例是 PostgreSQL 的模块定义。
<?xml version="1.0" ?> <module xmlns="urn:jboss:module:1.1" name="org.postgres"> <resources> <!-- ***** IMPORTANT : REPLACE THIS PLACEHOLDER *******--> <resource-root path="/home/site/deployments/tools/postgresql-42.2.12.jar" /> </resources> <dependencies> <module name="javax.api"/> <module name="javax.transaction.api"/> </dependencies> </module> -
将 JBoss CLI 命令放入名为
jboss-cli-commands.cli的文件中。 JBoss 命令必须添加模块,并将其注册为数据源。 以下示例显示了用于 PostgreSQL 的 JBoss CLI 命令。#!/usr/bin/env bash module add --name=org.postgres --resources=/home/site/deployments/tools/postgresql-42.2.12.jar --module-xml=/home/site/deployments/tools/postgres-module.xml /subsystem=datasources/jdbc-driver=postgres:add(driver-name="postgres",driver-module-name="org.postgres",driver-class-name=org.postgresql.Driver,driver-xa-datasource-class-name=org.postgresql.xa.PGXADataSource) data-source add --name=postgresDS --driver-name=postgres --jndi-name=java:jboss/datasources/postgresDS --connection-url=${POSTGRES_CONNECTION_URL,env.POSTGRES_CONNECTION_URL:jdbc:postgresql://db:5432/postgres} --user-name=${POSTGRES_SERVER_ADMIN_FULL_NAME,env.POSTGRES_SERVER_ADMIN_FULL_NAME:postgres} --password=${POSTGRES_SERVER_ADMIN_PASSWORD,env.POSTGRES_SERVER_ADMIN_PASSWORD:example} --use-ccm=true --max-pool-size=5 --blocking-timeout-wait-millis=5000 --enabled=true --driver-class=org.postgresql.Driver --exception-sorter-class-name=org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter --jta=true --use-java-context=true --valid-connection-checker-class-name=org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker -
创建调用此 JBoss CLI 命令的启动脚本
startup_script.sh。 以下示例演示了如何调用jboss-cli-commands.cli。 稍后,你需要将应用服务配置为在容器启动时运行此脚本。$JBOSS_HOME/bin/jboss-cli.sh --connect --file=/home/site/deployments/tools/jboss-cli-commands.cli -
使用所选的 FTP 客户端,将 JDBC 驱动程序、
jboss-cli-commands.cli、startup_script.sh和模块定义上传到/site/deployments/tools/。 -
将站点配置为在容器启动时运行
startup_script.sh。 在 Azure 门户中,导航到“配置” > “通用设置” > “启动命令” 。 将“启动命令”字段设置为/home/site/deployments/tools/startup_script.sh。 单击“保存”以保存更改。
若要确认已将数据源添加到 JBoss 服务器,请使用 SSH 进入 webapp 并运行 $JBOSS_HOME/bin/jboss-cli.sh --connect。 连接到 JBoss 后,运行 /subsystem=datasources:read-resource 以打印数据源列表。
日志中的 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 的固定次要版本。 这将防止在次要版本自动更新期间发生意外中断。
如果选择固定次要版本,则需要定期更新站点上 JVM 的次要版本。 为了确保应用程序在较新的次要版本上运行,请创建一个过渡槽并在暂存站点上递增次要版本。 确认应用程序在新的次要版本上正常运行后,可以交换过渡槽和生产槽。
JBoss EAP 硬件选项
JBoss EAP 仅适用于高级和独立硬件选项。 在公共预览期间在免费层、共享层、基本层或标准层上创建了 JBoss EAP 站点的客户应纵向扩展到“高级”或“独立”硬件层,以避免出现意外行为。
Java 运行时支持声明
JDK 版本和维护
Azure 支持的 Java 开发工具包 (JDK) 为提供 Azul Systems 提供的 Zulu。 Azul Zulu Enterprise 内部版 OpenJDK 是适用于 Azure 和 Azure Stack 的 OpenJDK 的免费、多平台、生产就绪型发行版,由 Microsoft 及 Azul Systems 提供支持。 这些版本包含构建和运行 Java SE 应用程序所需的所有组件。 你可以通过 Java JDK 安装安装 JDK。
主要版本更新将通过 Azure 应用服务中的新运行时选项提供。 客户可以通过配置应用服务部署来更新到这些较新的 Java 版本,他们需要负责测试和确保重大更新符合其需求。
支持的 JDK 将在每年的 1 月、4 月、7 月和 10 月按季度自动修补。 有关 Azure 上的 Java 的详细信息,请参阅此支持文档。
安全更新
重大安全漏洞的修补程序和修复程序将在 Azul Systems 提供后立即发布。 “重大”漏洞是根据 NIST 常见漏洞评分系统版本 2 提供的基本评分 9.0 或以上来定义的。
Tomcat 8.0 已经在 2018 年 9 月 30 日生命周期终止 (EOL)。 尽管该运行时在 Azure 应用服务上仍然可用,但 Azure 不会为 Tomcat 8.0 应用安全更新。 如果可能,请将你的应用程序迁移到 Tomcat 8.5 或 9.0。 Tomcat 8.5 和 9.0 在 Azure 应用服务上都可用。 有关详细信息,请查看 Tomcat 官方网站。
弃用和停用
如果即将停用某个受支持的 Java 运行时,则从停用该运行时之前的至少六个月开始,使用受影响运行时的 Azure 开发人员会收到弃用通知。
本地开发
开发人员可以从 Azul 下载站点下载 Azul Zulu Enterprise JDK Production Edition 进行本地开发。
开发支持
使用符合条件的 Azure 支持计划进行 Azure 或 Azure Stack 方面的开发时,可以通过 Microsoft 获得对 Azure 支持的 Azul Zulu JDK 的产品支持。
后续步骤
请访问面向 Java 开发人员的 Azure 中心查找 Azure 快速入门、教程和 Java 参考文档。
应用服务 Linux 常见问题解答中解答了并不特定于 Java 开发的、适用于 Linux 的应用服务的一般用法问题。
历史资料。此文对应 2022-08-12 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 jasonfreeberg)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
