管理实例的补丁修订版

本页面提供了以下方面的信息和指南： Cloud Data Fusion 实例。

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

补丁修订版本包括您的 实例。补丁修订版本只会应用平台上的修复，而不更改 流水线或插件升级过程涉及实例和流水线 停机时间。

如需详细了解如何对 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 Web 中访问升级后的实例 点击查看实例。

  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：需要配置的项目的 ID 包含 Cloud Data Fusion 实例。
    • LOCATION_NAME：实例的位置。
    • CURRENT_INSTANCE_VERSION：当前版本。

    • AVAILABLE_PATCH_REVISION：补丁程序修订版本 要升级到的目标版本。

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

    • 可选：您可以传递 CDAP 属性，例如 enable.unrecoverable.reset，以 --options。

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

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

    1. 通过运行以下命令获取实例详情 从本地终端运行 gcloud CLI 命令 Cloud Shell 会话：

      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：包含以下内容的项目的 ID Cloud Data Fusion 实例。
  • 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：需要配置的项目的 ID 包含 Cloud Data Fusion 实例。
    • LOCATION_NAME：实例的位置。
    • CURRENT_INSTANCE_VERSION：当前版本。

    • STABLE_PATCH_REVISION： 回滚到。

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

    • 可选：您可以传递 CDAP 属性，例如 enable.unrecoverable.reset，以 --options。

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

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

    1. 通过运行以下命令获取实例详情 从本地终端运行 gcloud CLI 命令 Cloud Shell 会话：

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

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

REST API

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

示例

此示例展示了如何通过 6.7.3.1 补丁回滚实例 修订版本 6.7.3 补丁修订版本（使用 REST API）。

调用 patch() 方法：

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

替换以下内容：

  • PROJECT_ID：包含以下内容的项目的 ID Cloud Data Fusion 实例。
  • 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
}

后续步骤