如何将Microsoft Bot Framework Composer部署为Azure Web App

结论：完全可以部署到Azure Web App，Linux或Windows实例均支持，以下是详细操作步骤：

一、前置准备 #

• 本地环境满足Composer运行要求：Node.js LTS 14.x、Yarn、.NET Core SDK 3.1或更高版本
• 已创建Azure Web App实例：
  • 选Linux实例时，运行时环境指定Node.js 14.x
  • 选Windows实例时，运行时环境指定.NET Core 3.1或更高版本
• 本地完成Composer代码克隆与构建：

  git clone https://github.com/microsoft/BotFramework-Composer.git
  cd BotFramework-Composer/Composer
  yarn install
  yarn build
  

二、调整部署配置 #

1. 在Composer目录下创建.env文件，添加核心环境变量：

   PORT=8080  # Azure Web App默认监听端口
   NODE_ENV=production
   BASE_PATH=/  # 若需自定义访问路径可修改
   

2. 确认Composer/package.json中包含启动脚本，无则添加：

   "scripts": {
     "start": "node ./dist/server.js",
     // 保留原有其他脚本
   }
   

三、部署到Azure Web App #

方式1：Azure CLI手动部署 #

1. 登录Azure账号：

   az login
   

2. 切换到目标订阅：

   az account set --subscription <你的订阅ID>
   

3. 进入Composer目录，执行部署命令：

   az webapp up --name <你的Web App名称> --resource-group <资源组名称> --sku B1 --runtime "NODE|14-lts"
   

   Windows实例部署时，将--runtime参数改为"DOTNETCORE|3.1"

方式2：GitHub Actions自动部署 #

1. 进入Azure Web App的「部署中心」，选择GitHub作为部署源，关联你的BotFramework-Composer仓库分支
2. 配置构建步骤：
   • 指定Node.js版本为14.x
   • 设置构建命令：cd Composer && yarn install && yarn build
   • 设置部署路径为Composer/dist

四、验证部署 #

部署完成后，直接访问Azure Web App的公网URL，即可进入Composer的Web界面。首次访问可能需要1-2分钟加载资源。

关键注意事项 #

• Linux实例需确保启动命令正确，Azure会自动读取package.json中的start脚本
• 若出现启动失败，可在Azure Web App的「日志流」中查看错误信息，常见问题包括端口冲突、依赖缺失
• 建议使用至少B1级别的应用服务计划，避免资源不足导致运行异常

内容的提问来源于stack exchange，提问作者deetwo-id