全局虚拟机扩展程序政策

本文档简要介绍了虚拟机扩展程序管理器中的全局虚拟机扩展程序政策。借助全球扩展程序政策,您可以在项目、文件夹或组织内的所有可用区和区域中部署和管理扩展程序,从而保持一致的舰队配置,而无需管理每个可用区的政策。

如需详细了解扩展程序政策的层次结构级别,请参阅资源层次结构范围。

下图展示了全局扩展程序政策如何在组织、文件夹和项目级层将扩展程序应用于跨可用区和区域的虚拟机:

组织、文件夹和项目级层的全局扩展程序政策,用于将扩展程序应用于跨可用区的虚拟机。

如上图所示,您可以在组织、文件夹或项目级层定义全局扩展程序政策。虚拟机扩展程序管理器会将每项政策应用于该层次结构范围内所有可用区中的匹配虚拟机。

全球政策的发布计划

全球性政策使用发布计划跨可用区和区域部署扩展程序。通过发布计划,您可以定义更新的顺序和时间,以确保逐步、受控地发布,并最大限度地降低出现大范围问题的风险。

创建或更新全局政策时,您可以指定以下发布计划之一:

  • 慢速发布。在默认的 5 天内,逐步在各个可用区中部署扩展程序。使用此发布计划,在早期部署阶段发现并解决问题,避免问题影响整个机群。
  • 快速发布。立即将扩展程序部署到所有可用区和区域中的所有目标虚拟机。当您需要在非生产环境中快速部署扩展程序或补丁时,请使用此发布方案。

您还可以定义自定义发布计划,以按可用区或区域指定部署批次以及各批次之间的等待时间。如需了解详情,请参阅 rolloutPlans.insert 方法。

发布冲突行为

创建或更新全球扩展政策时,在以下情况下可能会与现有可用区级政策发生冲突:

  • 创建全局政策时。如果某个可用区中已存在同名的可用区级政策,则会发生名称冲突。
  • 更新全局政策时。如果您单独修改现有可用区级政策(例如,通过使用可用区级 API 调用),并且后续全球政策发布尝试更新该可用区级政策,则会发生内容冲突。

如需解决发布冲突,您可以为发布指定冲突行为。此设置决定了在发布期间,全局政策是否会覆盖冲突的可用区级政策。您可以指定以下行为之一:

  • 不覆盖(默认)。如果您未指定冲突行为,则全局政策发布不会覆盖冲突的可用区级政策。可用区级政策的配置在该可用区中优先。
  • 覆盖。如果您将冲突行为设置为 overwrite,则全局政策会覆盖冲突的可用区级政策,并且虚拟机扩展程序管理器会在该可用区中应用全局政策的配置。

发布冲突和政策优先级是两个不同的功能,它们独立运行。如需详细了解政策优先级,请参阅政策优先级和冲突解决。

如需详细了解发布冲突设置,请参阅 globalVmExtensionPolicies.insert 方法中的 conflictBehavior 参数。

重试发布

当您更新或删除全局扩展程序政策时,虚拟机扩展程序管理器会启动新的发布,以根据发布计划应用更改。如果发布失败或有新可用区可用,您可以通过为同一政策启动新发布来重试该操作。

重试更新或删除发布时,您必须提供 32 个字符的十六进制格式的通用唯一标识符 (UUID)(例如 a1a2a3a4-b1b2-c1c2-d1d2-d3d4d5d6d7d8)来标识重试请求。您可以使用任何标准 UUID 生成器来创建此值。

重试更新政策发布

以下列表介绍了您可能需要重试更新政策发布的情况:

  • 添加了新区域。如果您在发布全局政策后有新的 Google Cloud 可用区可用,虚拟机扩展程序管理器不会自动将现有政策应用于新可用区中的虚拟机。您可以重试更新发布,以将扩展程序政策应用于这些可用区中的虚拟机。
  • 还原可用区级政策更改。如果您单独修改可用区级政策(例如,通过使用可用区级 API 调用),则可以重试更新发布,并将 conflictBehavior 设置为 overwrite。此设置会重新应用全局政策的配置,并覆盖可用区级政策更改。
  • 发布中断。如果之前的发布在完成之前失败,您可以开始新的发布以重试更新。
  • 加速发布。如果正在进行的发布进度太慢,您可以使用 FAST_ROLLOUT 方案或自定义发布方案启动新的发布,以加快更新过程。

如需了解详情,请参阅 globalVmExtensionPolicies.update 方法中的 retryUuid 参数。

重试删除政策发布

以下列表介绍了您可能需要重试删除政策发布的情况:

  • 发布中断。如果之前的删除发布在完成之前失败,您可以启动新的发布来重试删除。
  • 加速发布。如果正在进行的删除发布进度太慢,您可以使用 FAST_ROLLOUT 方案或自定义发布方案启动新的发布,以加快删除过程。

如需了解详情,请参阅 globalVmExtensionPolicies.delete 方法中的 retryUuid 参数。

后续步骤