生成和部署 Node.js 应用

本文介绍如何使用 Azure Pipelines 创建一个管道,该管道通过持续集成(CI)和持续部署(CD)将 Node.js 应用程序部署到 Azure 应用服务。 CI/CD 通过在应用程序代码存储库发生提交时自动构建和部署应用程序,从而减少停机时间和错误风险。

先决条件

产品 要求
Azure DevOps - 一个 Azure DevOps 项目。
- 能够在Microsoft托管代理上运行管道。 启用免费层,或购买 并行作业。
- 对 YAML 和 Azure Pipelines 的基本知识。 有关详细信息,请参阅创建第一个管道。
- 权限:
     - 若要创建管道:必须位于 “参与者 ”组中,并且该组需要将 “创建生成管道 ”权限设置为“允许”。 项目管理员组的成员可以管理管道。
    - 若要创建服务连接:必须具有服务连接的管理员或创建者角色。
GitHub - GitHub 帐户。
- 用于授权 Azure Pipelines 的 GitHub 服务连接 。
天蓝色 一个 Azure 订阅。
产品 要求
Azure DevOps - 一个 Azure DevOps 项目。
- 自托管代理。 若要创建一个代理,请参阅自托管代理。
- 对 YAML 和 Azure Pipelines 的基本知识。 有关详细信息,请参阅创建第一个管道。
- 权限:
    - 若要创建管道:必须位于 “参与者 ”组中,并且该组需要将 “创建生成管道 ”权限设置为“允许”。 项目管理员组的成员可以管理管道。
    - 若要创建服务连接:必须具有服务连接的管理员或创建者角色。
GitHub - GitHub 帐户。
- 用于授权 Azure Pipelines 的 GitHub 服务连接 。
天蓝色 一个 Azure 订阅。

注意

使用 GitHub 的过程可能需要身份验证、授权或登录到 GitHub 组织或特定存储库。 按照说明完成所需的过程。 有关详细信息,请参阅访问 GitHub 存储库。

创建示例应用程序的分支

  1. 在 GitHub 中,转到 Node.js Hello World 存储库,然后选择顶部菜单中的 分支 。

    GitHub 的屏幕截图,用于选择要分叉的 Node.js 项目。

  2. 选择您的 GitHub 组织作为派生的 所有者(如果尚未选择),然后选择创建派生。

    在 GitHub 中创建分支的屏幕截图。

浏览器将跳转至您的新分叉,网址为 https://github.com/<owner>/nodejs-docs-hello-world。

创建和部署应用服务 Web 应用

在 Azure 门户中使用 Cloud Shell 创建 Azure 应用服务 Web 应用。 若要使用 Cloud Shell,请登录到 Azure 门户 ,然后选择顶部工具栏上的 Cloud Shell 按钮。

Azure 门户工具栏上的“Azure Cloud Shell”按钮的屏幕截图。

Cloud Shell 显示在浏览器底部。 请确保在下拉菜单中选择 Bash 作为环境。

Azure Cloud Shell 的屏幕截图。

小窍门

若要粘贴到 Cloud Shell 中,请使用 Ctrl+Shift+V 或右键单击,然后从上下文菜单中选择“ 粘贴 ”。

创建和部署 Web 应用

  1. 在 Cloud Shell 中,使用以下命令将你的复刻存储库克隆到 Azure,并将 <your-forked-repository-url> 替换为你的复刻存储库的 URL。

    git clone <your-forked-repository-url>
    
  2. 将目录更改为克隆的存储库文件夹。

    cd nodejs-docs-hello-world
    
  3. 运行 az webapp up 命令来预配应用服务 Web 应用并执行第一个部署。 该 --sku F1 参数在免费定价层上创建 Web 应用,不会产生任何费用。

    在没有az webapp up参数的情况下运行name,会自动分配一个 Azure 中唯一且随机生成的 web 应用名称。 还可以使用--name <web-app-name>参数来分配 Azure 中唯一的任何名称,例如具有应用标识符的个人或公司名称。--name <your-name>-nodeapp

    az webapp up --sku F1 --name <app-name>
    

该 az webapp up 命令将应用识别为 Node.js 应用,并执行以下作:

  1. 创建默认 资源组。
  2. 创建默认 应用服务计划。
  3. 使用分配的名称和 URL <your-web-app-name>.azurewebsites.net。
  4. ZIP 部署 当前工作目录中的所有文件,并启用构建自动化。
  5. 在 .azure/config 文件中本地缓存参数,以便在使用或其他az webapp up命令从项目文件夹az webapp进行部署时,无需再次指定参数。

您可以使用命令参数,用您自己的值覆盖默认操作。 有关详细信息,请参阅 az webapp up。

该命令在运行时生成状态消息。 成功启动网站后,可以选择指向 You can launch the app at https://<your-web-app-name>.azurewebsites.netHello World Web 应用的链接。

该 az webapp up 命令为示例 Web 应用生成以下 JSON 输出:

{
  "URL": "<your-web-app-url>",
  "appserviceplan": "<your-app-service-plan-name>",
  "location": "<your-azure-region>",
  "name": "<your-web-app-name>",
  "os": "Linux",
  "resourcegroup": "<your-resource-group-name>",
  "runtime_version": "node|20-LTS",
  "runtime_version_detected": "10.0",
  "sku": "FREE",
  "src_path": "<repository-source-path>"
}

根据模板创建管道

  1. 在 Azure DevOps 项目中,从左侧导航菜单中选择 “管道 ”,然后选择“ 新建管道 ”或“ 创建管道 ”(如果此管道是项目中的第一个管道)。

  2. 在 “代码位于何处”屏幕上,选择 GitHub。

  3. 在 “选择存储库 ”屏幕上,选择分支 nodejs-docs-hello-world 存储库。

  4. Azure Pipelines 将代码识别为 Node.js 应用,并在“配置管道”页上建议多个管道模板。 选择 Node.js Express Web App to Linux on Azure。

  5. 在下一个屏幕上,选择 Azure 订阅,然后选择 “继续”。 此操作将创建到 Azure 资源的服务连接。

  6. 在下一个屏幕上,选择 Azure Web 应用,然后选择 “验证并配置”。 Azure Pipelines 创建一个 azure-pipelines.yml 文件,并将其显示在 YAML 管道编辑器中。

  7. 在 “查看管道 YAML ”屏幕上,查看管道的代码。

    管道执行以下操作:

    • 将触发器设置为在每次提交到主代码分支时激活。
    • 为服务连接、Web 应用、计算机映像和环境建立和使用变量。
    • 在生成代理上安装 Node.js,并使用 npm 运行和测试应用生成。
    • 将生成的应用程序打包到 ZIP 存档,并将 ZIP 上传到指定的上传位置。
    • 将 ZIP 包部署到应用服务应用并启动应用。

保存并运行流水线

  1. 查看代码后,选择保存并运行,然后再次选择保存并运行,以保存并运行管道。 azure-pipelines.yml 文件被保存到您的派生仓库中,代码将部署到 Azure 应用服务。

    注意

    首次运行管道时,它会请求权限以访问其创建的环境。 选择 “允许 ”以授予管道访问环境的权限。

  2. 在摘要页面上,选择作业以查看管道运行情况并跟踪其构建过程。

  3. 运行成功后,选择 Azure Web 应用部署 任务,然后选择 应用服务应用程序 URL 以查看已部署的网站。

    该屏幕截图显示了 Azure 管道中的网站 URL 位置。

  4. 请验证您是否在部署的网站 URL 上看到在 App Service 上运行的站点。

    该屏幕截图显示了在 Web 浏览器中运行的 Node.js 应用程序。

运行 CI 构建和部署

trigger: main 关键字可配置您的管道,使其在向您分叉的代码存储库的 main 分支提交更改时自动运行。 要运行 CI 构建:

  1. 转到分叉的 GitHub 存储库,并在 README.md 文件中稍作更改。
  2. 选择 “提交更改”,然后再次 提交更改 。
  3. 在 Azure Pipelines 中,请确认您的 nodejs-docs-hello-world 管道再次运行,且状态显示为单独的 CI。

清理资源

如果不再需要资源,可以删除为本文创建的资源。

  • 若要删除 Azure 应用服务资源,请在 Cloud Shell 中按顺序运行以下命令。 必须先删除 Web 应用,然后才能删除其应用服务计划,并且必须先删除应用服务计划,然后才能删除其资源组。

    az webapp delete --name <web-app-name> --resource-group <resource-group-name>
    az appservice plan delete --name <app-service-plan-name> --resource-group <resource-group-name>
    az group delete --name <resource-group-name>
    
  • 若要删除 Azure Pipelines 中的管道,请选择管道,选择管道页上右上角的“ 更多作 ”图标,然后选择“ 删除”。 若要删除 Azure DevOps 项目,请参阅 “删除项目”。

  • 若要删除分支 nodejs-docs-hello-world GitHub 存储库,请转到存储库,然后在顶部菜单栏中选择“设置”。 滚动到页面底部,然后选择“ 删除此存储库”。