教程：使用 Linux 上的 Azure 应用服务和 MySQL 生成 Tomcat Web 应用

• 拥有有效订阅的 Azure 帐户。 如果没有 Azure 帐户，可以免费创建一个。
• 一个 GitHub 帐户。 你也可以免费获得一个。
• 具备 Tomcat 开发的 Java 知识。
• （可选） 要尝试 GitHub Copilot，需要一个 GitHub Copilot 帐户。 提供 30 天试用期。

• 拥有有效订阅的 Azure 帐户。 如果没有 Azure 帐户， 可以创建一个。
• 已安装 Azure Developer CLI。
• 具备 Tomcat 开发的 Java 知识。
• （可选） 要尝试 GitHub Copilot，需要一个 GitHub Copilot 帐户。 提供 30 天试用期。

2.创建应用服务和 MySQL

首先，创建 Azure 资源。 本教程中使用的步骤创建一组默认安全的资源，其中包括应用服务和 Azure Database for MySQL。 对于创建过程，需要指定：

• Web 应用程序的名称。 它用作 DNS 名称的一部分。
• 用于在世界上实际运行应用的区域。 它还用作应用的 DNS 名称的一部分。
• 应用的运行时堆栈。 在此处选择要用于应用的 PHP 版本。
• 应用程序的托管计划。 定价层为您的应用提供了一组功能和可扩展的容量。
• 应用的资源组。 使用资源组可将应用程序所需的所有 Azure 资源分组到一个逻辑容器中。

登录到 Azure 门户并按照以下步骤创建 Azure 应用服务资源。

1. 在 Azure 门户中：

   • 在顶部的搜索栏中，输入 应用服务。
   • 在 “服务 ”标题下，选择 “应用服务”。
   • 选择“创建”“Web 应用”>。

   还可以直接转到 创建向导。

2. 在“创建 Web 应用”页面的“基本信息”选项卡上，按如下所示填写表单：

   • 资源组：选择“新建”，并使用名称 msdocs-tomcat-mysql-tutorial。
   • 名称：msdocs-tomcat-mysql-XYZ，其中 XYZ 是任意三个随机字符。
   • 运行时堆栈：Java 25。
   • Java Web 服务器堆栈：Apache Tomcat 11.0。
   • 作系统： Linux。
   • 区域：你附近的任何 Azure 区域。
   • 定价计划： 基本。 准备就绪后，可以纵向扩展到生产定价层。

3. 选择“ 数据库 ”选项卡并配置数据库：

   • 选择“ 创建数据库”。
   • 在 “引擎”中，选择 “MySQL 灵活服务器”。 Azure Database for MySQL - 灵活服务器是 Azure 上完全托管的 MySQL 数据库即服务，与最新社区版兼容。
   • 不要选择“创建Azure Cache for Redis”。

4. 选择“查看 + 创建”。 验证完成后，选择“创建”。

5. 部署完成后，选择“ 转到资源 ”按钮。 你将直接进入 App Service 应用。

将创建以下资源：

• 资源组：所有已创建资源的容器。
• 应用服务计划：为应用服务定义计算资源。 创建了一个属于Basic层的 Linux 计划。
• 应用服务：表示应用并在应用服务计划中运行。
• 虚拟网络：与应用服务应用集成，并隔离后端网络流量。
• Azure Database for MySQL 灵活服务器：只能从虚拟网络访问。 你的数据库和用户创建于此服务器上。
• 专用 DNS 区域：在虚拟网络中启用数据库服务器的 DNS 解析。

遇到问题？ 检查 “故障排除”部分。

3.确认 JNDI 数据源

如果应用设置包含适用于 Oracle、SQL Server、PostgreSQL 或 MySQL 的有效 JDBC 连接字符串，并且应用设置 WEBSITE_AUTOCONFIGURE_DATABASE 设为 true，App Service 会在 Tomcat 服务器的 context.xml 文件中为其添加一个 Java 命名和目录接口 (JNDI) 数据源。 在此步骤中，将添加此应用设置，然后使用 SSH 连接到应用容器来验证 JNDI 数据源。 在此过程中，你将了解如何访问 Tomcat 容器的 SSH shell。

遇到问题？ 检查 “故障排除”部分。

6.打开应用程序

遇到问题？ 检查 “故障排除”部分。

7. 实时传输诊断日志

Azure 应用服务会捕获输出到控制台的所有消息，以帮助你诊断应用程序的问题。 示例应用程序包括标准 Log4j 日志记录语句，用于演示此功能，如以下代码片段所示：

@WebServlet(urlPatterns = "/")
public class ViewServlet extends HttpServlet {
    private static Logger logger = LogManager.getLogger(ViewServlet.class.getName());

    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

        logger.info("GET /");

        EntityManagerFactory emf = (EntityManagerFactory) req.getServletContext().getAttribute("EMFactory");

在为 .NET、Node.js、Python 和 Java 应用程序启用 Azure Monitor OpenTelemetry 系列教程中详细了解 Java 应用中的日志记录。

遇到问题？ 检查 “故障排除”部分。

8.清理资源

完成后，可以通过删除资源组，从Azure订阅中删除所有资源。

2.创建 Azure 资源并部署示例应用

在此步骤中，将创建Azure资源，并将示例应用部署到Linux 上的应用服务。 本教程中使用的步骤创建一组默认安全的资源，其中包括应用服务和 Azure Database for MySQL。

开发容器已具有 Azure Developer CLI （AZD）。

1. 从存储库根路径，运行 azd init。

   azd init --template tomcat-app-service-mysql-infra .
   

2. 出现提示时，请提供以下答案：

   Question	回答
   当前目录不为空。 是否要在此处初始化“<your-directory>”中的项目？	Y
   你希望对这些文件执行哪些操作？	使现有文件保持不变
   输入新环境名称	键入唯一名称。 AZD 模板将此名称用作 Azure（<app-name>-<hash>.chinacloudsites.cn）中 Web 应用的 DNS 名称的一部分。 允许使用字母数字字符和下划线。

3. 通过运行 azd auth login 命令并按照提示登录到 Azure：

   azd auth login
   

4. 使用 azd up 命令创建必要的 Azure 资源并部署应用代码。 按照提示为 Azure 资源选择所需的订阅和位置。

   azd up
   

   该 azd up 命令需要大约 10 分钟才能完成。 它还会编译和部署应用程序代码，但你稍后将修改代码以使用应用服务。 在运行时，该命令会提供有关预配和部署过程的消息，包括指向 Azure 中部署的链接。 完成后，命令还会显示指向部署应用程序的链接。

   此 AZD 模板包含使用以下 Azure 资源生成安全默认体系结构的文件（azure.yaml 和 infra 目录）：

   • 资源组：所有已创建资源的容器。
   • 应用服务计划：为应用服务定义计算资源。 在 B1 层中创建了一个 Linux 计划。
   • 应用服务：表示应用并在应用服务计划中运行。
   • 虚拟网络：与应用服务应用集成，并隔离后端网络流量。
   • Azure Database for MySQL 灵活服务器：只能通过 DNS 区域集成从虚拟网络访问。 将在服务器上为你创建数据库。
   • Azure托管 Redis：只能通过虚拟网络内部访问。
   • 专用终结点：访问虚拟网络中密钥保管库和托管 Redis 实例的终结点。
   • 专用 DNS 区域：在虚拟网络中启用对密钥保管库、数据库服务器和托管 Redis 实例的 DNS 解析。
   • Log Analytics 工作区：充当应用交付日志的目标容器，还可以在其中查询日志。
   • 密钥保管库：使用 AZD 重新部署时，用于保留数据库密码。

   一旦命令完成创建资源和首次部署应用程序代码的操作，已部署的示例应用就无法运行，因为你必须进行微小的更改才能使其连接到 Azure 中的数据库。

遇到问题？ 检查 “故障排除”部分。

3.验证连接字符串

你使用的 AZD 模板已为你生成了连接变量作为应用设置，并将它们输出到终端，以方便你使用。 使用应用设置可以将连接机密保留在代码存储库之外。

1. 在 AZD 输出中，找到应用设置 AZURE_MYSQL_CONNECTIONSTRING。 仅显示设置名称。 在 AZD 输出中，它们看起来是这样的：

    App Service app has the following connection strings:
            - AZURE_MYSQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
            - AZURE_KEYVAULT_RESOURCEENDPOINT
            - AZURE_KEYVAULT_SCOPE
    

   AZURE_MYSQL_CONNECTIONSTRING 包含 Azure 中 MySQL 数据库的连接字符串。 稍后需要在代码中使用它。

2. 为方便起见，AZD 模板会显示应用的应用设置页的直接链接。 找到该链接并在新的浏览器选项卡中打开它。

   如果添加包含有效 Oracle、SQL Server、PostgreSQL 或 MySQL 连接字符串的应用设置，则应用服务会在 Tomcat 服务器的 context.xml 文件中将其添加为 Java 命名和目录接口 (JNDI) 数据源。

遇到问题？ 检查 “故障排除”部分。

4.确认 JNDI 数据源

在此步骤中，使用与应用容器的 SSH 连接来验证 Tomcat 服务器中的 JNDI 数据源。 在此过程中，你将了解如何访问 Tomcat 容器的 SSH shell。

1. 在 AZD 输出中，找到 SSH 会话的 URL，并在浏览器中导航到该 URL。 输出结果如下：

    Open SSH session to App Service container at: <URL>
    

2. 在 SSH 终端中运行 cat /usr/local/tomcat/conf/context.xml。 你应会看到已添加名为 jdbc/AZURE_MYSQL_CONNECTIONSTRING_DS 的 JNDI 资源。 稍后你将使用该数据源。 应用服务会自动创建此数据源，因为 AZD 模板将应用设置 WEBSITE_AUTOCONFIGURE_DATABASE 设置为 true。

   

遇到问题？ 检查 “故障排除”部分。

5.修改示例代码并重新部署

遇到问题？ 检查 “故障排除”部分。

6.打开应用程序

1. 在 AZD 输出中，找到应用的 URL 并在浏览器中导航到该 URL。 该 URL 在 AZD 输出中如下所示：

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: <URL>
    

2. 将一些任务添加到列表。

   

   恭喜，你已在 Azure 应用服务中运行了一个 Web 应用，并安全连接到了 Azure Database for MySQL。

遇到问题？ 检查 “故障排除”部分。

7. 实时传输诊断日志

Azure 应用服务可以捕获控制台日志，以帮助你诊断应用程序的问题。 为方便起见，AZD 模板已启用对本地文件系统的日志记录以及将日志传送到 Log Analytics 工作区。

示例应用程序包括标准 Log4j 日志记录语句，用于演示此功能，如以下代码片段所示：

@WebServlet(urlPatterns = "/")
public class ViewServlet extends HttpServlet {
    private static Logger logger = LogManager.getLogger(ViewServlet.class.getName());

    @Override
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {

        logger.info("GET /");

        EntityManagerFactory emf = (EntityManagerFactory) req.getServletContext().getAttribute("EMFactory");

在 AZD 输出中，找到流式传输应用服务日志的链接，并在浏览器中导航到该链接。 该链接在 AZD 输出中如下所示：

Stream App Service logs at: <URL>

在为 .NET、Node.js、Python 和 Java 应用程序启用 Azure Monitor OpenTelemetry 系列教程中详细了解 Java 应用中的日志记录。

遇到问题？ 检查 “故障排除”部分。

8.清理资源

若要删除当前部署环境中的所有 Azure 资源，请运行 azd down 并按照提示进行操作。

azd down