指定維護期間

主控台

如要為現有環境定義或變更維護期間，請更新環境：

1. 前往 Google Cloud 控制台的「Environments」頁面。

   前往「環境」

2. 選取環境。

3. 前往「環境設定」分頁。

4. 按一下「維護時段」項目旁的「編輯」。

5. 在「維護期間」對話方塊中，勾選「自訂維護期間的時間」核取方塊。

6. 請設定開始時間、時區、天數和長度，讓指定時間表的總時間在 7 天的滾動視窗中至少為 12 小時。舉例來說，每週一、週三和週五的 4 小時時間長度就符合要求。

7. 按一下「儲存」，然後等待環境更新。

gcloud

更新環境時，下列引數會定義維護時段參數：

• --maintenance-window-start 會設定維護期間的開始時間。
• --maintenance-window-end 會設定維護期間的結束時間。
• --maintenance-window-recurrence 會設定維護期間週期。

gcloud composer environments update ENVIRONMENT_NAME \
    --location LOCATION \
    --maintenance-window-start 'DATETIME_START' \
    --maintenance-window-end 'DATETIME_END' \
    --maintenance-window-recurrence 'MAINTENANCE_RECURRENCE'

取代：

• 將 ENVIRONMENT_NAME 替換為環境的名稱。
• DATETIME_START 的開始日期和時間，以日期/時間輸入格式表示。系統只會使用當天指定的時間，而忽略指定的日期。
• DATETIME_END 結束日期和時間，格式為日期/時間輸入格式。系統只會使用當天指定的時間，而忽略指定的日期。指定的日期和時間必須晚於開始日期。

• MAINTENANCE_RECURRENCE 搭配維護期間重複的 RFC 5545 RRULE。Cloud Composer 支援兩種格式：

• FREQ=DAILY 格式指定每日週期。

• FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA 格式會指定在所選星期幾重複發生的事件。

以下範例指定星期三、星期六和星期日的 01:00 至 07:00 (世界標準時間) 之間的 6 小時維護期間。系統會忽略 2023 年 1 月 1 日的日期。

gcloud composer environments update example-environment \
  --location us-central1 \
  --maintenance-window-start '2023-01-01T01:00:00Z' \
  --maintenance-window-end '2023-01-01T07:00:00Z' \
  --maintenance-window-recurrence 'FREQ=WEEKLY;BYDAY=SU,WE,SA'

API

1. 建構 environments.patch API 要求。

2. 在這個要求中：

   1. 在 updateMask 參數中指定 config.maintenanceWindow 遮罩。

   2. 在要求主體中，指定維護期間的參數。

{
  "config": {
    "maintenanceWindow": {
      "startTime": "DATETIME_START",
      "endTime": "DATETIME_END",
      "recurrence": "MAINTENANCE_RECURRENCE"
    }
  }
}

取代：

• DATETIME_START 的開始日期和時間，以日期/時間輸入格式表示。只使用當天指定的時間，系統會忽略指定的日期。
• DATETIME_END 結束日期和時間，格式為日期/時間輸入格式。系統只會使用當天指定的時間，而忽略指定的日期。指定的日期和時間必須晚於開始日期。

• MAINTENANCE_RECURRENCE 搭配維護期間重複的 RFC 5545 RRULE。Cloud Composer 支援兩種格式：

  • FREQ=DAILY 格式指定每日週期。
  • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA 格式會指定在所選星期幾重複發生的事件。

以下範例指定星期三、星期六和星期日的 01:00 到 07:00 (世界標準時間) 之間的 6 小時維護期間。系統會忽略 2023 年 1 月 1 日的日期。

  // PATCH https://composer.googleapis.com/v1/projects/example-project/
  // locations/us-central1/environments/example-environment?updateMask=
  // config.maintenanceWindow

  {
    "config": {
      "maintenanceWindow": {
        "startTime": "2023-01-01T01:00:00Z",
        "endTime": "2023-01-01T07:00:00Z",
        "recurrence": "FREQ=WEEKLY;BYDAY=SU,WE,SA"
      }
    }
  }

Terraform

maintenance_window 區塊會指定環境的維護期間：

resource "google_composer_environment" "example" {
  provider = google-beta
  name = "ENVIRONMENT_NAME"
  region = "LOCATION"

  config {
    maintenance_window {
      start_time = "DATETIME_START"
      end_time = "DATETIME_END"
      recurrence = "MAINTENANCE_RECURRENCE"
    }
  }
}

取代：

• 將 ENVIRONMENT_NAME 替換為環境的名稱。
• LOCATION 改成環境所在的地區。
• DATETIME_START 的開始日期和時間，以日期/時間輸入格式表示。只使用當天指定的時間，系統會忽略指定的日期。
• DATETIME_END 結束日期和時間，格式為日期/時間輸入格式。系統只會使用當天指定的時間，而忽略指定的日期。指定的日期和時間必須晚於開始日期。

• MAINTENANCE_RECURRENCE 搭配維護期間重複的 RFC 5545 RRULE。Cloud Composer 支援兩種格式：

  • FREQ=DAILY 格式指定每日週期。
  • FREQ=WEEKLY;BYDAY=SU,MO,TU,WE,TH,FR,SA 格式會指定在所選星期幾重複發生的事件。

以下範例指定星期三、星期六和星期日的 01:00 至 07:00 (世界標準時間) 之間的 6 小時維護期間。系統會忽略 2023 年 1 月 1 日的日期。

resource "google_composer_environment" "example" {
  provider = google-beta
  name = "example-environment"
  region = "us-central1"

  config {
    maintenance_window {
      start_time = "2023-01-01T01:00:00Z"
      end_time = "2023-01-01T07:00:00Z"
      recurrence = "FREQ=WEEKLY;BYDAY=SU,WE,SA"
    }
  }
}