GCP Compute Engine的SetMetadata如何触发VM执行新增启动脚本

1. 插入启动脚本后立即触发执行的实现逻辑 #

GCP所有官方提供的Windows系统镜像，都预装了GCE Guest Agent（GCE客户代理），这个代理以Windows系统服务的形式在实例后台持续运行，会以秒级间隔轮询实例内部的元数据服务（固定内网地址169.254.169.254），检测元数据的变更。
当你调用SetMetadataAsync方法新增/修改windows-startup-script-ps1元数据键值后，Agent在下一次轮询时就会检测到该启动脚本的变更，只要脚本没有被标记为已执行过，就会立刻触发PowerShell进程执行脚本，无需重启实例。
你的场景下因为是实例刚创建完成就写入启动脚本，此时实例内部操作系统还在启动流程中，Guest Agent还没完成首次元数据拉取，写入的脚本会被Agent的首次拉取请求捕获，看起来就像是写入后立刻被执行。

2. 启动脚本对应的实例生命周期阶段 #

分两种运行场景对应不同阶段：

• 实例首次启动/重启场景：启动脚本会在实例硬件初始化完成、操作系统核心组件和系统服务全部加载完成、用户登录之前的阶段执行，优先级高于普通用户自启程序。默认配置下每次实例重启都会重新执行启动脚本。
• 实例正常运行中新增/修改启动脚本场景：脚本会在元数据变更被Guest Agent检测到之后立刻执行，不属于实例固有生命周期的固定阶段。

3. 新创建实例运行启动脚本的底层流程 #

底层执行链路如下：

• 基础设施层初始化：GCP完成计算资源分配、系统磁盘挂载、VPC网络配置、实例元数据服务初始化，实例上电启动。
• 操作系统启动：Windows系统完成核心驱动加载、内置系统服务启动，此时GCE Guest Agent作为自动启动的系统服务开始运行。
• 元数据拉取：Guest Agent向内部元数据服务发起请求，拉取实例的所有元数据配置，解析到windows-startup-script-ps1键的脚本内容。
• 脚本执行：Agent校验脚本格式后，以系统权限启动PowerShell进程执行脚本，执行日志默认写入C:\Program Files\Google\Compute Engine\logs\startup-script.log，方便排查问题。
• 结果回写：脚本执行完成后，Agent会记录执行状态，如有配置要求还会把执行结果回写到实例元数据中。

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