管理執行個體的修補程式修訂版本

本頁面提供 Cloud Data Fusion 執行個體的修補程式修訂版本管理資訊和指南。

如要進一步瞭解修補程式修訂版本與其他升級的差異，請參閱執行個體升級與修補程式修訂版本。

修補程式修訂版本包含執行個體的重大安全性更新和錯誤修正內容。修補程式修訂版只會在平台上套用修正項目，不會變更管道或外掛程式。升級程序會導致執行個體和管線的服務中斷。

如要進一步瞭解 Cloud Data Fusion 的版本管理，請參閱「Cloud Data Fusion 中的版本管理」和「可用的修補程式修訂版本升級」。

事前準備

  • 升級至修補程式修訂版本前，請先查看版本資訊，瞭解其中包含的特定修正項目。因此，請務必瞭解這些因素可能對執行個體造成的影響。
  • 準備環境：
    • 排定修補程式修訂版本的停機時間。
    • 建議：在升級前，請停止所有執行中的管道，並停用所有上游觸發事件，例如 Cloud Composer 觸發事件。升級開始後，所有執行中的管道都會停止。

執行個體升級與修補程式修訂版本

執行個體升級
這些版本包含最新功能、功能強化功能，以及平台效能改善項目。執行個體升級與外掛程式變更相關，且需要升級管道。詳情請參閱「版本升級：執行個體和管道」。
修補程式修訂版本
這些版本僅包含平台的重大安全性和錯誤修正，不會變更或更新管道和外掛程式功能。

升級至 Cloud Data Fusion 執行個體的修補程式版本

如要將 Cloud Data Fusion 執行個體升級至修補程式修訂版本，請在 Google Cloud 控制台、Google Cloud CLI 或 REST API 中，按照下列步驟操作。

控制台

  1. 在 Google Cloud 控制台中，前往 Cloud Data Fusion 頁面。

  2. 按一下「Instances」，然後選取執行個體名稱旁的核取方塊。

    前往「Instances」(執行個體)

  3. 按一下「升級」。

  4. 選取最新的修補程式修訂版本，然後按一下「升級」。

  5. 如要在 Cloud Data Fusion 網頁介面中存取已升級的執行個體，請按一下「View instance」(查看執行個體)。

  6. 如要確認升級是否成功，請在 Google Cloud 主控台中重新載入「Instance details」頁面。請查看「版本」欄位，確認是否有更新。

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
}

後續步驟