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

本頁提供相關資訊和指南，說明如何管理 Cloud Data Fusion 執行個體的修補程式版本。

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

修補程式修訂版本包含執行個體的重大安全性更新和錯誤修正。修補程式修訂版本只會套用平台修正，不會變更管道或外掛程式。升級程序會導致執行個體和管道停機。

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

事前準備

  • 升級至修補程式修訂版本前，請先查看版本資訊，瞭解該版本包含的特定修正內容。請務必瞭解這些變更對執行個體的影響。
  • 準備環境：
    • 排定修補程式修訂版本的停機時間。
    • 建議：升級前，請停止所有正在執行的管道，並停用所有上游觸發程序，例如 Managed Service for Apache Airflow 觸發程序。升級開始後，所有正在執行的管道都會停止。

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

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

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

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

控制台

  1. 前往 Google Cloud 控制台的 Cloud Data Fusion 頁面。

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

    前往「Instances」(執行個體)

  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
}

更改下列內容：

舉例來說，如要將執行個體從 6.7.3.1 修補程式修訂版本復原至 6.7.3 修補程式修訂版本，請使用下列 JSON 要求主體：

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

後續步驟