如何通过Bicep稳定安装Azure现有Web应用的扩展？

扩展安装偶尔超时失败，通常和实例资源不足、扩展包下载耗时过长或部署超时设置不够有关。以下是几个能提升安装成功率的方法：

1. 自定义资源部署超时时间 #

默认的资源部署超时可能不足以应对大体积扩展包的下载和安装过程，直接给扩展资源设置更长的超时时间：

param appName string

resource webApp 'Microsoft.Web/sites@2023-12-01' existing = {
  name: appName
}

resource siteExtension 'Microsoft.Web/sites/siteextensions@2023-12-01' = {
  parent: webApp
  name: 'NewRelic.Azure.WebSites.Extension'
  options: {
    timeout: 'PT30M' // 设置为30分钟，可根据实际情况调整
  }
}

2. 指定扩展的稳定版本 #

使用最新版本的扩展可能因包体积大、下载慢导致超时。指定一个已知稳定的版本号，减少下载耗时和兼容性风险：

param appName string

resource webApp 'Microsoft.Web/sites@2023-12-01' existing = {
  name: appName
}

resource siteExtension 'Microsoft.Web/sites/siteextensions@2023-12-01' = {
  parent: webApp
  name: 'NewRelic.Azure.WebSites.Extension'
  properties: {
    version: '9.17.0' // 替换为你验证过的稳定版本
  }
}

3. 确保App Service实例活跃 #

如果你的App Service使用免费/共享层，实例可能休眠导致安装中断。先启用Always On保持实例活跃，再安装扩展：

param appName string

resource webApp 'Microsoft.Web/sites@2023-12-01' existing = {
  name: appName
}

// 启用Always On
resource webAppConfig 'Microsoft.Web/sites/config@2023-12-01' = {
  parent: webApp
  name: 'web'
  properties: {
    alwaysOn: true
  }
}

// 等待配置更新完成后再安装扩展
resource siteExtension 'Microsoft.Web/sites/siteextensions@2023-12-01' = {
  parent: webApp
  name: 'NewRelic.Azure.WebSites.Extension'
  dependsOn: [
    webAppConfig
  ]
}

4. 避免在实例不稳定时部署 #

如果App Service正处于重启、缩放或维护状态，安装扩展容易失败。部署前确保实例处于Running状态，也可以在CI/CD流程中添加检查步骤，确认实例健康后再执行扩展安装。

5. 批量部署时分批处理 #

如果要给多个App Service安装扩展，不要一次性全部部署，分批次执行可以避免触发Azure服务的限流机制，降低超时概率。

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