教程：将 Node.js + MongoDB Web 应用部署到 Azure

• 具有活动订阅的 Azure 帐户。 如果没有 Azure 帐户，可以免费创建一个。
• 一个 GitHub 帐户。 你也可以免费获得一个。
• Express.js 开发知识。
• （可选）若要试用 GitHub Copilot，请创建一个 GitHub Copilot 帐户。 有 30 天免费试用版可用。

• 具有活动订阅的 Azure 帐户。 如果没有 Azure 帐户，可以免费创建一个。
• 已安装 Azure 开发人员 CLI。 可以使用 Azure Cloud Shell 执行这些步骤，因为它已安装 Azure 开发人员 CLI。
• Express.js 开发知识。
• （可选）若要试用 GitHub Copilot，请创建一个 GitHub Copilot 帐户。 有 30 天免费试用版可用。

2.创建应用服务和 Azure Cosmos DB

此步骤创建 Azure 资源。 本教程中使用的步骤创建一组默认安全的资源，其中包括应用服务和 Azure Cosmos DB for MongoDB。 此创建过程中，你将指定：

• Web 应用的名称。 它以 https://<app-name>-<hash>.<region>.azurewebsites.net 的形式用作应用的 DNS 名称的一部分。
• “区域”，在世界上以物理方式运行应用。 它还用作应用的 DNS 名称的一部分。
• 应用的运行时堆栈。 在此处选择要用于应用的 Node 版本。
• 应用的托管计划。 它是定价层，包括应用的一组功能和缩放容量。
• 应用的资源组。 使用资源组可将应用程序所需的所有 Azure 资源分组到一个逻辑容器中。

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

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

3.安全连接机密

创建向导已经为你生成了连接字符串作为应用设置。 但是，安全最佳做法是将机密完全保留在应用服务之外。 你需要借助服务连接器将机密移到密钥保管库，并将应用设置更改为密钥保管库引用。

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

4.部署示例代码

在此步骤中，使用 GitHub Actions 配置 GitHub 部署。 这只是部署到应用服务的许多方法之一，也是一种在部署过程中持续集成的好方法。 默认情况下，进入 GitHub 存储库的每个 git push 都会启动生成和部署操作。

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

5.浏览到应用

6.流式传输诊断日志

Azure 应用服务捕获已记录到控制台的所有消息，以帮助你诊断应用程序的问题。 示例应用在其每个终结点中输出控制台日志消息，以演示此功能。 例如，get 终结点输出有关从数据库中检索的任务数量的消息，如果出现问题，则它会输出一条错误消息。

router.get('/', function(req, res, next) {
  Task.find()
    .then((tasks) => {      
      const currentTasks = tasks.filter(task => !task.completed);
      const completedTasks = tasks.filter(task => task.completed === true);

      console.log(`Total tasks: ${tasks.length}   Current tasks: ${currentTasks.length}    Completed tasks:  ${completedTasks.length}`)
      res.render('index', { currentTasks: currentTasks, completedTasks: completedTasks });
    })
    .catch((err) => {
      console.log(err);
      res.send('Sorry! Something went wrong.');
    });
});

7.使用 Kudu 检查已部署的文件

Azure 应用服务提供了一个名为 Kudu 的基于 Web 的诊断控制台，用于检查 Web 应用的服务器托管环境。 使用 Kudu 可以查看部署到 Azure 的文件、查看应用程序的部署历史记录，甚至可以打开 SSH 会话以进入托管环境。

8.清理资源

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

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

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

开发容器已具有 Azure Developer CLI (AZD)。

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

   azd init --template nodejs-app-service-cosmos-redis-infra
   

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

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

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

   azd auth login
   

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

   azd up
   

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

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

   • 资源组：所有已创建资源的容器。
   • 应用服务计划：为应用服务定义计算资源。 将创建 B1 层中的 Linux 计划。
   • 应用服务：表示应用并在应用服务计划中运行。
   • 虚拟网络：与应用服务应用集成，并隔离后端网络流量。
   • 使用 MongoDB API 的 Azure Cosmos DB 账户：只能从其专用终结点后面访问。 将在服务器上为你创建数据库。
   • Azure Cache for Redis：只能从虚拟网络中访问。
   • 密钥保管库：只能从其专用终结点后面访问。 用于管理应用服务应用的机密。
   • 专用终结点：虚拟网络中的密钥保管库、数据库服务器和 Redis 缓存的访问终结点。
   • 专用 DNS 区域：启用虚拟网络中的 Cosmos DB 数据库、Redis 缓存和密钥保管库的 DNS 解析。
   • Log Analytics 工作区：充当应用日志传送的目标容器，还可以在其中查询日志。

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

3.验证连接字符串

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

1. 在 AZD 输出中，找到应用设置 AZURE_COSMOS_CONNECTIONSTRING。 只显示设置名称。 它们在 AZD 输出中如下所示：

    App Service app has the following app settings:
            - AZURE_COSMOS_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
            - AZURE_KEYVAULT_RESOURCEENDPOINT
            - AZURE_KEYVAULT_SCOPE
    

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

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

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

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

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

5.浏览到应用

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

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>-<hash>.azurewebsites.net/
    

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

   

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

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

6.流式传输诊断日志

Azure 应用服务捕获已记录到控制台的所有消息，以帮助你诊断应用程序的问题。 示例应用在其每个终结点中输出控制台日志消息，以演示此功能。 例如，get 终结点输出有关从数据库中检索的任务数量的消息，如果出现问题，则它会输出一条错误消息。

router.get('/', function(req, res, next) {
  Task.find()
    .then((tasks) => {      
      const currentTasks = tasks.filter(task => !task.completed);
      const completedTasks = tasks.filter(task => task.completed === true);

      console.log(`Total tasks: ${tasks.length}   Current tasks: ${currentTasks.length}    Completed tasks:  ${completedTasks.length}`)
      res.render('index', { currentTasks: currentTasks, completedTasks: completedTasks });
    })
    .catch((err) => {
      console.log(err);
      res.send('Sorry! Something went wrong.');
    });
});

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

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

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

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

7.清理资源

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

azd down