管理实例的补丁修订版

本页面提供了有关管理 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
}

后续步骤