同时部署到多个目标

使用 Cloud Deploy,您可以部署到配置为 代表多个目标,并且您的应用会在 并行执行。您在流水线中标识为阶段的目标称为多目标,多目标包含的目标称为子目标

您可以将并行部署与 Cloud Deploy 支持的任何目标类型搭配使用,包括 Google Kubernetes Engine、Cloud Run 和 GKE Enterprise。

为何要并行部署

例如,您可以使用并行部署来将应用部署到 多个生产目标。在这种情况下,您不需要将应用部署到 目标,因为没有进展(例如,从 dev 到 dev 从预演到生产)。

这种并行部署可以作为正常交付流水线的一部分 进度:
dev -> staging -> prod [prod1, prod2, prod3, prod4, ...]

用于并行部署的 Cloud Deploy 资源

并行部署使用以下 Cloud Deploy 专用资源:

  • 多目标

    多目标是指使用属性 multiTarget 配置的目标。 在目标配置 YAML 的顶层添加,而不是引用 运行时集群或服务,它会引用一个或多个其他目标,使用 multiTarget.targetIds

  • 子目标

    子目标是指多目标引用的任何目标 multiTarget.targetIds。子级还必须引用受支持的目标类型(Google Kubernetes Engine、GKE Enterprise 或 Cloud Run)。

  • 控制器发布

    控制器发布是指与多目标对应的发布。

    如需详细了解您可以使用控制器发布功能执行哪些操作以及不能执行哪些操作,请参阅限制

  • 子发布

    如需详细了解您可以使用子版本发布功能执行哪些操作以及不能执行哪些操作,请参阅限制

设置并行部署

设置并行部署包括定义一个多目标和 所需子目标的数量(不超过上限)。目标定义与所有目标相同,但以下几点除外:

  • 多目标包含 multiTarget 属性。
  • 子目标不包含 multiTarget 属性,但可以使用 multiTarget.targetIds 属性从多目标引用。
  • 您可以配置要送审的多目标,但不能配置子目标,因为子目标不能包含 requireApproval:true

多目标和子目标可以包含自定义执行环境配置。如果子目标未指定执行环境,则会继承多目标定义中定义的执行环境或默认执行环境。请参阅 执行环境和并行部署 了解详情。

配置多目标

多目标是指在投放过程中被视为一个阶段的单个目标 但指向一个或多个子目标。

多目标配置包含 multiTarget 属性。多目标不能具有 gkerunanthosCluster 属性。无论您要部署到哪个运行时,多目标的配置都是相同的。

在交付流水线 YAML 或单独的 YAML 文件中,创建基本目标定义,包括 multiTarget

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
 name: TARGET_NAME
description: TARGET_DESCRIPTION
multiTarget:
 targetIds: [ CHILD_TARGET1, CHILD_TARGET2, CHILD_TARGETn ]

在此 YAML 中...

  • TARGET_NAME 是此多目标的名称, 在交付流水线定义中使用, stages.targetId 属性。

  • CHILD_TARGET1, CHILD_TARGET2,...CHILD_TARGETn是 作为此多目标目标的部署目标的子级的名称。每个名称 添加到子目标定义中的 name 属性。

multiTarget.targetIds 属性的存在会使此目标成为多目标。

配置子目标

对于在您的 Google Ads 账号中识别为儿童的每个目标 多目标配置,请将另一个目标配置为子目标:

在您的交付流水线 YAML 中或单独的 YAML 文件中,创建基本目标定义:

GKE

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
 name: CHILD_TARGET1
description: TARGET_DESCRIPTION
gke:
 cluster: projects/PROJECT_ID/locations/REGION/clusters/CLUSTER_NAME

在此 YAML 中...

  • CHILD_TARGET1 是此子目标的名称。通过 名称对应于 multiTarget.targetIds 属性(位于多目标定义中)。

  • gke.cluster 属性的值是此目标引用的集群的资源名称,包括项目 ID、区域和集群名称。

此目标的配置与标准 GKE 目标相同。唯一能使该对象成为子目标的唯一因素是它被 multiTarget.targetIds 属性。

Cloud Run

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
 name: CHILD_TARGET1
description: TARGET_DESCRIPTION
run:
 location: projects/PROJECT_ID/locations/REGION

在此 YAML 中...

  • CHILD_TARGET1 是此子目标的名称。通过 名称对应于 multiTarget.targetIds 属性(位于多目标定义中)。

  • run.location 属性的值就是 此目标所指的 Cloud Run 服务,包括 项目 ID 和区域

此目标的配置与标准 Cloud Run 目标相同。唯一使其成为子目标的因素是,它会被多目标中的 multiTarget.targetIds 属性引用。

GKE Enterprise

apiVersion: deploy.cloud.google.com/v1
kind: Target
metadata:
 name: CHILD_TARGET1
description: TARGET_DESCRIPTION
anthosCluster:
 membership: projects/PROJECT_ID/locations/global/memberships/MEMBERSHIP_NAME

在此 YAML 中...

此目标的配置与标准 GKE Enterprise 相同 目标。唯一使其成为子目标的因素是,它会被多目标中的 multiTarget.targetIds 属性引用。

将部署参数传递给目标

您可以通过在 清单和值。这些值可以是 单独应用于 单独的清单。

例如,您可能希望为每个子目标设置不同的副本数量。为此,您需要在提交内容中添加相应参数和值 流水线的进度,以及 每个“参数-值”对都要匹配。

详细了解部署参数

创建版本

配置多目标和子目标后,创建交付流水线和目标资源,然后照常创建版本。

交付流水线的生命周期与 Cloud Deploy 流水线和目标 Cloud Deploy 会创建一个控制器 多目标发布,以及用于部署应用的子发布 每个子定位条件。

响应 Cloud Deploy 操作的 Pub/Sub 消息 可以区分控制器发布和子发布

限制

  • 一个多目标最多只能有 100 个子目标。

  • 单个多目标的所有子目标必须具有相同的目标运行时 (例如,所有 GKE 或所有 GKE Enterprise)。

  • 在交付流水线中,一个子目标只能有一个父级多目标。

  • 多目标不能没有子目标,也不能将自身或其他多目标作为子目标进行引用。

  • 您无法在单个交付流水线中多次使用子目标,但可以在其他流水线中重复使用它们。

  • 默认池有并发数限制,但专用池没有。

    当您部署到多目标时,所有子版本发布都会同时部署,但不超过 Cloud Build 并发限制。如果您的子目标数量超出此限制,则在其他目标完成之前,系统不会运行某些目标的部署作业,这意味着在这种情况下,Cloud Deploy 不会同时部署到所有子目标。

    此外,如果目标包含验证作业, 在验证作业的完成之前, 应用已部署到所有子目标。

    如果您需要同时部署到的目标数量超出 Cloud Build 文档中指定的限制,则有以下两种方法可供选择:

执行环境和并行部署

每个目标都可以配置为使用非默认执行环境。

  • 如果多目标采用非默认执行环境,则所有子目标 则从 多目标

  • 如果多目标使用默认执行环境,则任何子目标 使用非默认执行环境的 非默认属性。

这些规则可让您更轻松地将执行环境传播到子目标 因此您不必定义或更改执行 同时仍允许您自定义 执行环境。

请参阅使用 Google Cloud Deploy 执行环境 详细了解 Cloud Deploy 中的执行环境。

回滚并行部署

如果您需要从多个并行目标回滚部署, 回滚多目标,如 回滚目标

并行部署的审批

与任何其他目标一样,您可以将并行部署配置为需要批准。但是,使用并行部署时,您只能在 多目标。批准或拒绝会同时影响所有子目标。

在 Google Cloud 控制台中查看并行部署

您可以在 Google Cloud 控制台中查看多目标、子目标、控制器发布和子发布的详细信息。

在查看给定交付流水线的目标列表时,交付流水线详情中会列出多目标,但不会列出子目标。不过,在查看版本详情时,您可以看到控制器发布和子发布。您还可以在 “交付流水线”详情页面上的发布标签页。

版本检查器中,您可以查看和比较子版本发布的呈现的清单。

将并行部署与部署策略搭配使用

使用 Google Cloud Armor Canary 部署策略。如需了解详情,请参阅将并行部署与 Canary 部署策略搭配使用

后续步骤