使用Azure DevOps Pipeline部署MS Bot替代az webapp部署遇问题求助

你的判断完全正确 #

当includeRootFolder: true时，ArchiveFiles任务会把$(System.DefaultWorkingDirectory)这个目录本身作为子目录打包进zip文件。部署后，Azure App Service的/home/site/wwwroot下会多出一层不必要的目录，导致Bot的启动脚本、依赖引用路径全部错乱，自然无法正常运行。

部署失败的核心原因 #

你本地用az webapp deployment source config-zip能成功，是因为你的MY_BOT_ZIP已经在本地执行过npm install，包含了完整的node_modules依赖文件夹。但Azure DevOps Pipeline里直接打包源码，跳过了依赖安装步骤，部署后的环境缺少bunyan这类依赖文件，才触发了ENOENT找不到文件的错误。

更优的部署方式 #

方案1：完善现有Pipeline（推荐） #

添加依赖安装步骤，确保打包的zip包含所有运行必需的文件：

# 1. 安装对应版本的Node.js（根据你的Bot实际使用版本调整）
- task: NodeTool@0
  inputs:
    versionSpec: '18.x'
  displayName: '安装Node.js环境'

# 2. 安装项目依赖
- script: |
    npm install
  displayName: '安装依赖包'

# 3. 打包文件（保持includeRootFolder: false，确保目录结构和本地一致）
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(System.DefaultWorkingDirectory)'
    includeRootFolder: false
    archiveType: 'zip'
    archiveFile: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'
    replaceExistingArchive: true

# 4. 部署到Azure Web App
- task: AzureWebApp@1
  inputs:
    azureSubscription: MY_SUBSCRIPTION
    appType: webAppLinux
    appName: MY_RESOURCE_NAME
    package: '$(Build.ArtifactStagingDirectory)/$(Build.BuildId).zip'

方案2：和本地逻辑完全对齐，用Azure CLI部署 #

如果想完全复刻本地az命令的部署逻辑，可以直接在Pipeline中调用Azure CLI：

# 1. 安装Node.js并安装依赖（若源码未预打包依赖）
- task: NodeTool@0
  inputs:
    versionSpec: '18.x'
  displayName: '安装Node.js环境'

- script: |
    npm install
  displayName: '安装依赖包'

# 2. 打包出和本地一致结构的zip
- task: ArchiveFiles@2
  inputs:
    rootFolderOrFile: '$(System.DefaultWorkingDirectory)'
    includeRootFolder: false
    archiveType: 'zip'
    archiveFile: '$(Build.ArtifactStagingDirectory)/bot.zip'
    replaceExistingArchive: true

# 3. 调用Azure CLI部署
- task: AzureCLI@2
  inputs:
    azureSubscription: MY_SUBSCRIPTION
    scriptType: 'bash'
    scriptLocation: 'inlineScript'
    inlineScript: |
      az webapp deployment source config-zip --resource-group MY_RESOURCE_GROUP --name MY_RESOURCE_NAME --src $(Build.ArtifactStagingDirectory)/bot.zip

额外优化提示 #

• 如果你的Bot用TypeScript等需要编译的语言，要在依赖安装后加编译步骤（比如npm run build），然后打包编译后的产物目录（如dist），而非直接打包根目录。
• 也可以在Azure App Service配置里开启SCM_DO_BUILD_DURING_DEPLOYMENT=true，让Kudu部署时自动执行npm install，但这种方式会增加部署耗时，不如在Pipeline里提前安装依赖高效。

内容的提问来源于stack exchange，提问作者tonymontana