借助 App Lifecycle Manager,您可以创建具有修改后蓝图的新发布版本,并通过发布功能进行部署,从而在预配单元中更新 SaaS 产品。发布会按 UnitKind 定位单元,您可以使用 CEL (unit_filter) 过滤目标子集。您还可以通过将单元更新到之前的版本来执行回滚,或从单元详情页面更新单个单元。
准备工作
在更新 SaaS 产品之前,您应执行以下操作:
- 确保您已启用 App Lifecycle Manager。
- 确保您拥有创建 SaaS 产品所需的 IAM 权限。
- 创建 SaaS 产品。
- 创建 UnitKind。
- 创建和预配单元。
- 准备新的或修改后的 Terraform 蓝图。
创建版本
您必须先创建版本,然后才能更新 SaaS 产品。发布版本表示 SaaS 应用的特定版本,由蓝图软件包及其关联的配置定义。从本质上讲,发布版本包含对单元的更新。
控制台
前往 App Lifecycle Manager。
点击版本。
在版本页面上,点击创建。
在创建发布版本页面上:
点击创建。
您已创建版本。您可以在版本详情页面上查看版本详情。您可以在创建发布时引用此版本。
gcloud
如需使用 Google Cloud 控制台创建版本,请执行以下操作:
gcloud app-lifecycle-manager releases create RELEASE_NAME --blueprint-package=BLUEPRINT_PACKAGE_URI --unit-kind=UNIT_KIND [--location=LOCATION] [--labels=[KEY=VALUE,...]] [--upgradeable-from-releases=[RELEASE_NAME,...]] [--input-variable-defaults=[variable=VARIABLE,value=VALUE,type=TYPE,...]]
将
RELEASE_NAME:您要创建的版本 ID。这将成为发布版本的完整资源名称的一部分。BLUEPRINT_PACKAGE_URI:要用于此版本的蓝图软件包的 URI。蓝图是托管在 Artifact Registry 或其他 OCI 注册表中的 OCI 映像。- 蓝图软件包包含预配单元所需的工件,并包含所用引擎 (Terraform) 的元数据以及版本。
- 如果您在 URI 中省略主机名,则默认为区域级 Artifact Registry 路径(例如
us-east1-docker.pkg.dev)。 - 如需详细了解如何创建蓝图,请参阅蓝图文档。
UNIT_KIND:此版本对应的单元种类的 ID 或完全限定标识符。UNIT_KIND 在您创建版本后不可变。LOCATION:要在其中创建版本的地点。如果未提供完整的 URI 路径,此标志会为发布位置提供后备值。默认为 Google Cloud CLI 环境中配置的位置。LABELS:(可选)要应用于版本以进行分类的标签。标签是键值对。- 键必须以小写字符开头,并且只能包含连字符、下划线、小写字符和数字。
- 值只能包含连字符、下划线、小写字符和数字。
- 例如:
--labels=environment=staging,team=app-lifecycle-manager
UPGRADEABLE_FROM_RELEASES:(可选)以英文逗号分隔的版本名称列表,用于指定哪些现有版本可以使用您创建的新版本进行更新。- 如果您将此标志留空,则可以更新到此版本的版本不受任何限制。
- 如果提供,对此发布版本的单元更新请求将强制执行此限制。
INPUT_VARIABLE_DEFAULTS:(可选)蓝图所需的输入变量的默认值。- 您可以以内嵌方式或通过引用 YAML 或 JSON 文件来指定变量默认值。
- 此处定义的变量可在创建发布时被覆盖。
如需详细了解如何设置变量,请参阅变量文档。
如需详细了解版本,请参阅 Release Google Cloud CLI 参考文档。
创建发布种类
在创建发布之前,您需要创建一个发布种类,作为将版本部署到单元的模板。
控制台
前往 App Lifecycle Manager。
点击发布类型。
在发布类型页面上,点击创建。
在创建发布种类页面上:
- 在发布种类名称框中,输入发布种类的名称。
- 在单元种类框中,选择单元种类,详细说明要使用发布版本更新的单元类型。
在发布策略下拉列表中,选择要用于将版本部署到单元的策略:
- 一次一个位置(简单):一次更新一个位置(不设置过渡时间)。同时更新最多 5% 的单元。
- 一次全部(简单):所有位置同时开始更新(非常适合开发环境和紧急情况)。
- 渐进式(逐步):在多个位置(具有过渡时间)以指数级百分比批次逐步部署更新。
- 渐进式(单个位置):按百分比分批更新单元,并延长过渡时间,以便在单个位置内检测问题。
如需详细了解发布策略,请参阅发布策略。
点击创建。
您已创建发布种类。在发布种类详情页面上,您可以查看和修改发布种类的参数。
gcloud
如需使用 Google Cloud 控制台创建发布种类,请执行以下操作:
gcloud app-lifecycle-manager rollout-kinds create ROLLOUT_KIND_NAME --unit-kind=UNIT_KIND --location=LOCATION --rollout-orchestration-strategy=ROLLOUT_ORCHESTRATION_STRATEGY --error-budget-allowed-count=ERROR_BUDGET_ALLOWED_COUNT --error-budget-allowed-percentage=ERROR_BUDGET_ALLOWED_PERCENTAGE --unit-filter=UNIT_FILTER --update-unit-kind-strategy=UPDATE_UNIT_KIND_STRATEGY
将
ROLLOUT_KIND_NAME:发布种类的名称。UNIT_KIND:定义要将版本应用于哪些单元。版本会应用于所选单元类型的所有单元。LOCATION:要在其中创建发布种类的位置。ROLLOUT_ORCHESTRATION_STRATEGY:定义发布种类的发布策略。可能的值包括:Google.Cloud.Simple.OneLocationAtATime:一次更新一个位置(没有过渡时间)。同时更新最多 5% 的单元。Google.Cloud.Simple.AllAtOnce:所有位置同时开始更新(非常适合开发环境和紧急情况)。Google.Cloud.Progressive.Gradual.v1:在多个位置(具有过渡时间)以指数方式按百分比批次逐步部署更新。Google.Cloud.Progressive.SingleLocation.v1:按百分比分批更新单元,并延长过渡时间,以便在单个位置内检测问题。
如需详细了解发布策略,请参阅发布策略。
ERROR_BUDGET_ALLOWED_COUNT:在不暂停发布的情况下,一个位置中允许的失败单元数上限。ERROR_BUDGET_ALLOWED_PERCENTAGE:在不暂停发布的情况下,一个位置中允许失败的单元数百分比上限。必须大于 0 且不超过 100。如果某个位置的失败单元数超过
--error-budget-allowed-count和--error-budget-allowed-percentage% 单元数中的较大者,发布作业将暂停。如果未设置错误预算,App Lifecycle Manager 将尝试更新所有单元,无论遇到多少次失败。UNIT_FILTER:针对单元使用的 CEL 格式过滤条件字符串。系统会应用该过滤条件来确定符合条件的单元数量。此过滤条件只能缩小发布范围。它无法扩大发布范围。UPDATE_UNIT_KIND_STRATEGY:更新单位种类的策略。默认情况下,单元种类将在发布开始时更新。可能的值包括:on-start:在发布开始时更新单元种类。never:一律不更新单元种类。
如需了解详情,请参阅 RolloutKind Google Cloud CLI 参考文档。
错误预算功能
App Lifecycle Manager 包含错误预算功能(RolloutKind 中的 ErrorBudget),作为一种保障措施。如果单元更新失败次数或百分比(例如,在基础架构应用期间)超过配置的阈值,则可以自动暂停发布,从而有助于限制更新期间潜在问题的影响。
创建发布
创建发布种类后,您可以创建一个发布,指定要用于更新单元的版本。
创建发布后,App Lifecycle Manager 会根据单元类型中定义的策略更新单元。
控制台
前往 App Lifecycle Manager。
点击发布。
在发布列表页面上,点击创建。
在创建发布页面上:
- 在发布作业种类框中,选择发布作业种类,其中详细说明了如何将发布版本部署到指定单元。
- 在发布版本框中,指定要用于更新单元的发布版本。
- 在发布名称框中,输入发布名称。
点击创建。
您的发布已创建。
在全球发布详情页面上,您可以监控发布详情,包括发布状态、发布进度(按单元数)和发布失败。
gcloud
如需使用 Google Cloud 控制台创建发布,请执行以下操作:
gcloud app-lifecycle-manager rollouts create ROLLOUT_NAME --rollout-kind=ROLLOUT_KIND_NAME --release=RELEASE_NAME --location=LOCATION
将
ROLLOUT_NAME:发布名称。ROLLOUT_KIND_NAME:定义要使用哪种发布类型将版本应用于单元。发布版本会应用于发布种类中定义的单元种类的所有单元。RELEASE_NAME:定义要部署到单元的发布二进制文件。LOCATION:要在其中创建发布的位置。
如需了解详情,请参阅 Rollout Google Cloud CLI 参考文档。
后续步骤
- 如需详细了解 App Lifecycle Manager,请参阅 App Lifecycle Manager 概览。
- 如需试用教程,请参阅使用 App Lifecycle Manager 部署 MySQL 实例。
- 如需了解如何使用服务账号以及如何为这些账号授予精细权限,请参阅 App Lifecycle Manager 服务账号。