Azure ARM模板部署Linux VM遇VMExtensionProvisioningError超时问题求助

遇到这种扩展部署超时的问题，通常和依赖配置、网络访问、脚本执行时长或者权限设置有关，我整理了几个常见的排查方向和解决方法，你可以逐一尝试：

1. 确认扩展间的依赖关系配置是否正确 #

你提到第二个脚本需要依赖MicrosoftScriptExtension的安装完成，所以必须在ARM模板里给第二个CustomScriptForLinux扩展正确设置dependsOn属性，确保它只在第一个扩展部署完成后才开始执行。

很多人容易犯的错误是只把依赖指向VM本身，而不是第一个扩展的资源ID。正确的配置应该是：

"dependsOn": [
  "[resourceId('Microsoft.Compute/virtualMachines/extensions', variables('vmName'), 'MicrosoftScriptExtension')]"
]

这样Azure会严格按照顺序执行两个扩展，避免因第一个扩展未完成就启动第二个导致的异常。

2. 调整扩展的执行超时时间 #

默认的扩展执行超时可能不足以支撑你的脚本运行时长（比如脚本需要下载大文件、安装复杂软件）。你可以在扩展的settings里添加executionTimeout参数，设置更长的超时时间，格式为ISO 8601时长格式，比如PT30M表示30分钟：

"settings": {
  "fileUris": ["[variables('yourScriptUrl')]"],
  "commandToExecute": "[variables('yourCommand')]",
  "executionTimeout": "PT30M"
}

3. 检查存储Blob的访问权限 #

如果你的自定义脚本或扩展安装包存放在Azure存储Blob中，要确保VM能够正常访问这个Blob：

• 如果是私有存储账户，必须使用有效的SAS令牌（确保令牌未过期，且拥有读取权限），并在模板里使用带SAS的Blob URL；
• 如果存储账户配置了防火墙或虚拟网络限制，要确保VM所在的VNet被添加到存储账户的允许列表中，或者开启存储账户的服务端点。

4. 验证VM的网络出站连接 #

Azure VM扩展需要通过HTTPS连接到Azure的扩展服务才能下载脚本、上报状态，如果VM的网络环境（比如NSG、防火墙）阻止了出站流量，就会导致超时：

• 检查NSG的出站规则，确保允许HTTPS（443端口）访问AzureCloud服务标签（或者特定的扩展服务域名*.azure-extensions.net）；
• 如果VM使用了代理，要确保扩展配置里正确设置了代理参数，让扩展能通过代理访问外部资源。

5. 查看VM上的扩展日志定位具体问题 #

如果以上步骤都没解决问题，可以登录VM查看扩展的日志文件，Linux系统下扩展日志通常位于/var/log/azure/目录下：

• MicrosoftScriptExtension的日志在/var/log/azure/Microsoft.OSTCExtensions.CustomScriptForLinux/（根据扩展类型可能略有不同）；
• 第二个CustomScriptForLinux的日志在对应的子目录中。
  日志里会详细记录扩展的下载、执行过程，比如是否脚本下载失败、命令执行报错等，这些信息能帮你快速定位根本原因。

这里给你一个修正后的模板片段参考，包含了正确的依赖配置和超时设置：

{
  "apiVersion": "2016-04-30-preview",
  "type": "Microsoft.Compute/virtualMachines",
  "name": "[variables('vmName')]",
  "location": "[resourceGroup().location]",
  // 省略VM的其他配置（存储、网络等）
  "resources": [
    {
      "type": "extensions",
      "name": "MicrosoftScriptExtension",
      "apiVersion": "2021-11-01",
      "location": "[resourceGroup().location]",
      "dependsOn": ["[resourceId('Microsoft.Compute/virtualMachines', variables('vmName'))]"],
      "properties": {
        "publisher": "Microsoft.OSTCExtensions",
        "type": "CustomScriptForLinux",
        "typeHandlerVersion": "1.5",
        "settings": {
          "fileUris": ["[variables('firstScriptBlobUrl')]"],
          "commandToExecute": "[variables('firstExecutionCommand')]",
          "executionTimeout": "PT20M"
        }
      }
    },
    {
      "type": "extensions",
      "name": "PostSetupCustomScript",
      "apiVersion": "2021-11-01",
      "location": "[resourceGroup().location]",
      "dependsOn": [
        "[resourceId('Microsoft.Compute/virtualMachines/extensions', variables('vmName'), 'MicrosoftScriptExtension')]"
      ],
      "properties": {
        "publisher": "Microsoft.OSTCExtensions",
        "type": "CustomScriptForLinux",
        "typeHandlerVersion": "1.5",
        "settings": {
          "fileUris": ["[variables('secondScriptBlobUrl')]"],
          "commandToExecute": "[variables('secondExecutionCommand')]",
          "executionTimeout": "PT30M"
        }
      }
    }
  ]
}

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