管理实例的补丁修订版本

本页面提供了有关如何管理 Cloud Data Fusion 实例的补丁修订版本的信息和准则。

如需详细了解补丁修订版本与其他升级有何不同，请参阅实例升级与补丁修订版本。

补丁修订版本包含对实例至关重要的安全更新和 bug 修复。补丁修订版本仅会在平台上应用修复，而不会更改流水线或插件。升级过程涉及实例和流水线停机时间。

如需详细了解如何对 Cloud Data Fusion 进行版本控制，请参阅 Cloud Data Fusion 中的版本控制和可用的补丁修订版本升级。

前期准备

  • 在升级到补丁修订版本之前，请查看版本说明，了解其包含的具体修复。请务必了解这些政策可能会对您的实例产生怎样的影响。
  • 准备环境：
    • 为补丁修订版本安排停机时间。
    • 建议：在升级之前，请停止所有正在运行的流水线并停用所有上游触发器，例如 Cloud Composer 触发器。升级开始后，所有正在运行的流水线都会停止。

实例升级与补丁修订版本

实例升级
这些版本包含平台的最新功能、功能增强和性能改进。实例升级与插件更改相关联，并且需要流水线升级。如需了解详情，请参阅版本升级：实例和流水线。
补丁修订版本
这些版本仅包含平台的关键安全性和 bug 修复，不会更改或更新流水线和插件功能。

升级到 Cloud Data Fusion 实例的补丁修订版本

如需升级到 Cloud Data Fusion 实例的补丁修订版本，请在 Google Cloud 控制台、Google Cloud CLI 或 REST API 中执行以下步骤。

控制台

  1. 在 Google Cloud 控制台中，转到 Cloud Data Fusion 页面。

  2. 点击实例，然后选中实例名称旁边的复选框。

    转到实例

  3. 点击升级。

  4. 选择最新的补丁修订版本，然后点击升级。

  5. 如需在 Cloud Data Fusion 网页界面中访问已升级的实例，请点击查看实例。

  6. 如需验证升级是否成功，请在 Google Cloud 控制台中重新加载实例详情页面。检查版本字段中是否有更新。

gcloud

  1. 如需更新到可用的补丁修订版本，请从本地终端 Cloud Shell 会话运行以下 gcloud CLI 命令：

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=AVAILABLE_PATCH_REVISION

    替换以下内容：

    • INSTANCE_ID：实例的名称。
    • PROJECT_ID：包含 Cloud Data Fusion 实例的项目的 ID。
    • LOCATION_NAME：实例的位置。
    • CURRENT_INSTANCE_VERSION：当前版本。

    • AVAILABLE_PATCH_REVISION：要升级到的补丁修订版本。

    • 可选：如果适用于您的实例，请添加 --enable_stackdriver_logging、--enable_stackdriver_monitoring 和 --labels 标志。

    • 可选：您可以将 CDAP 属性（例如 enable.unrecoverable.reset）作为 --options 进行传递。

    如需了解详情，请参阅 gcloud CLI 参考文档。

  2. 请按照以下步骤验证升级是否成功：

    1. 从本地终端 Cloud Shell 会话运行以下 gcloud CLI 命令，以获取实例详细信息：

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. 检查实例详情中的 PATCH_REVISION 字段是否已更新为指定版本。

REST API

如需对 Cloud Data Fusion 实例执行补丁修订，请调用其 patch() 方法。设置请求中的 patchRevision 可选字段。如果您未指定补丁修订版本，系统将使用最新的可用修订版本。

示例

以下示例展示了如何使用 REST API 将实例升级到补丁修订版本。

将实例升级到特定的补丁修订版本

调用 patch() 方法：

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

替换以下内容：

  • PROJECT_ID：包含 Cloud Data Fusion 实例的项目的 ID。
  • LOCATION_NAME：实例的位置。
  • INSTANCE_ID：实例的名称。

使用以下 JSON 请求正文：

{
  "version": VERSION_NUMBER,
  "patchRevision": PATCH_REVISION_NUMBER
}

替换以下内容：

  • VERSION_NUMBER：实例的版本，例如 6.7.3。
  • PATCH_REVISION_NUMBER：要升级到的补丁修订版本版本，例如 6.7.3.1。查看可用的补丁修订版本。

例如，如需将 6.7.3 版实例升级到 6.7.3.1 补丁修订版本，请使用以下 JSON 请求正文：

{
  "version": 6.7.3,
  "patchRevision": 6.7.3.1
}

将实例升级到默认补丁修订版本版本

调用 patch() 方法：

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

使用以下 JSON 请求正文：

{
  "version": VERSION_NUMBER
}

将 VERSION_NUMBER 替换为实例版本，例如 6.7.3：

{
  "version": 6.7.3
}

回滚补丁修订版本

如果您在整合补丁修订版本后遇到不可预见的问题，请按照以下步骤将补丁修订版本还原为较早的稳定状态。

gcloud

  1. 如需回滚到之前的补丁修订版本，请从本地终端 Cloud Shell 会话运行以下 gcloud CLI 命令：

    gcloud beta data-fusion instances update INSTANCE_ID \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  --version=CURRENT_INSTANCE_VERSION \
  --patch_revision=STABLE_PATCH_REVISION

    替换以下内容：

    • INSTANCE_ID：实例的名称。
    • PROJECT_ID：包含 Cloud Data Fusion 实例的项目的 ID。
    • LOCATION_NAME：实例的位置。
    • CURRENT_INSTANCE_VERSION：当前版本。

    • STABLE_PATCH_REVISION：要回滚到的补丁修订版本。

    • 可选：如果适用于您的实例，请添加 --enable_stackdriver_logging、--enable_stackdriver_monitoring 和 --labels 标志。

    • 可选：您可以将 CDAP 属性（例如 enable.unrecoverable.reset）作为 --options 进行传递。

    如需了解详情，请参阅 gcloud CLI 参考文档。

  2. 按照以下步骤验证回滚是否成功：

    1. 从本地终端 Cloud Shell 会话运行以下 gcloud CLI 命令，以获取实例详细信息：

      gcloud beta data-fusion instances describe \
  --project=PROJECT_ID \
  --location=LOCATION_NAME \
  INSTANCE_ID

    2. 检查实例详情中的 PATCH_REVISION 字段是否已还原为指定版本。

REST API

如需在 Cloud Data Fusion 实例中回滚补丁修订版本，请调用其 patch() 方法。将请求中的 patchRevision 字段设置为任何较早的稳定补丁修订版本。

示例

此示例展示了如何使用 REST API 将实例从 6.7.3.1 补丁修订版本回滚到 6.7.3 补丁修订版本。

调用 patch() 方法：

PATCH https://datafusion.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_NAME/instances/INSTANCE_ID

替换以下内容：

  • PROJECT_ID：包含 Cloud Data Fusion 实例的项目的 ID。
  • LOCATION_NAME：实例的位置。
  • INSTANCE_ID：实例的名称。

使用以下 JSON 请求正文：

{
  "version": VERSION_NUMBER,
  "patchRevision": STABLE_PATCH_REVISION
}

替换以下内容：

  • VERSION_NUMBER：实例的版本，例如 6.7.3。
  • STABLE_PATCH_REVISION：要回滚到的补丁修订版本。查看可用的补丁修订版本。

例如，如需将实例从 6.7.3.1 补丁修订版本回滚到 6.7.3 补丁修订版本，请使用以下 JSON 请求正文：

{
  "version": 6.7.3,
  "patchRevision": 6.7.3
}

后续步骤