尋找並設定維護期間

為確保服務安全可靠、效能卓越，而且是最新版本，Memorystore for Valkey 會定期更新執行個體。這些更新稱為「維護」。

維護作業完全由服務管理，且設計上不會造成停機。不過，除了 Memorystore for Valkey 會對執行個體執行維護作業外，您也可以自訂維護時間表，配合應用程式需求並盡量減少中斷情形。如要自訂維護時間表，可以為執行個體設定維護期間。

本頁說明如何完成下列工作，自訂維護期間：

• 建立包含維護期間的執行個體
• 設定偏好的維護時間
• 開啟維護通知
• 查看排定的維護作業
• 重新安排維護時間
• 從執行個體移除維護政策

如要瞭解維護更新和維護期間的相關資訊，請參閱「維護簡介」。

建立具有維護期間的執行個體

您可以使用 gcloud CLI 建立具有維護期的 Memorystore for Valkey 執行個體。

重要事項： 請先完成「事前準備」和「設定網路」一節中的步驟，再按照本節的步驟操作。

gcloud

如要建立具有維護期間的執行個體，請使用 gcloud memorystore instances create 指令：

gcloud memorystore instances create INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--psc-auto-connections=network=projects/PROJECT_ID/global/networks/NETWORK_ID \
--shard-count=SHARD_COUNT \
--maintenance-policy-weekly-window=day=DAY,startTime=hours=HOUR

請將下列項目改為對應的值：

• INSTANCE_ID：您要建立的 Memorystore for Valkey 執行個體 ID。執行個體 ID 必須介於 1 至 63 個字元，且只能使用小寫英文字母、數字或連字號。但開頭必須是小寫英文字母，結尾則須為小寫英文字母或數字。

• PROJECT_ID：您要在當中建立執行個體的 Google Cloud 專案專案 ID 或編號。

• REGION_ID：您希望執行個體所在的區域。

  注意： 您只能在 Memorystore for Valkey 的支援區域中建立執行個體。

• NETWORK_ID：要用於建立執行個體的網路 ID。

• SHARD_COUNT：執行個體中的分片數量。分片數量會決定儲存執行個體資料的記憶體總容量。如要進一步瞭解執行個體規格，請參閱「執行個體和節點規格」。

• DAY：您希望進行維護作業的日期。可接受的值為
  MONDAY - SUNDAY。

• HOUR：維護時段開始時的時數 (以世界標準時間為準)。可接受的值為 0 - 23。

例如：

gcloud memorystore instances create my-instance \
--project=my-project \
--location=us-central1 \
--psc-auto-connections=network=projects/my-project/global/networks/default \
--shard-count=8 \
--maintenance-policy-weekly-window=day=MONDAY,startTime=hours=9

根據預設，建立含有維護期間的執行個體時，傳輸中加密會停用，授權網路則為 default。

設定偏好的維護期間

您可以使用 gcloud CLI，為 Memorystore for Valkey 執行個體設定維護期。

gcloud

如要為執行個體設定維護時段，請使用 gcloud memorystore instances update 指令：

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--maintenance-policy-weekly-window=day=DAY,startTime=hours=HOUR

請將下列項目改為對應的值：

• INSTANCE_ID：執行個體的 ID。
• PROJECT_ID：包含執行個體的 Google Cloud 專案 的專案 ID 或編號。
• REGION_ID：執行個體所在的區域。
• DAY：您希望進行維護作業的日期。可接受的值為
  MONDAY - SUNDAY。
• HOUR：維護時段開始時的時數 (以世界標準時間為準)。可接受的值為 0 - 23。

開啟維護通知

您可以使用 Google Cloud 控制台，為 Memorystore for Valkey 執行個體啟用維護通知。

注意： 即使開啟維護通知，您也必須為執行個體設定維護期間，才會收到通知。

1. 前往 Google Cloud 控制台的「Communication」(通訊) 頁面。

   通訊

2. 按一下「產品通知」。

3. 從選單中選取 Google Cloud 專案。

4. 在 Memorystore 的資料列中，將電子郵件按鈕切換為「開啟」。

維護通知電子郵件會使用這個主旨："Upcoming maintenance for your Cloud Memorystore instance [your-instance-name]"。如要讓特定電子郵件地址接收通知，必須分別啟用。

維護通知是在專案層級設定，而非在執行個體上設定。 Memorystore for Valkey 會將通知傳送至與您 Google 帳戶相關聯的電子郵件地址。您無法設定自訂電子郵件別名 (例如團隊電子郵件別名)。

查看排定的維護作業

如果 Memorystore for Valkey 執行個體已排定維護作業，您可以使用 gcloud CLI 查看排定的維護作業。

gcloud

如要找出執行個體排定的維護作業，請使用 gcloud memorystore instances describe 指令。

gcloud memorystore instances describe INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID

請將下列項目改為對應的值：

• INSTANCE_ID：執行個體 ID
• PROJECT_ID： Google Cloud 執行個體所在專案的專案 ID 或編號
• REGION_ID：執行個體所在的區域

預定維護作業的輸出內容如下：

maintenancePolicy:
  weeklyMaintenanceWindow:
  - day: DAY
      duration: 3600 seconds
  - startTime
       hour: HOUR
maintenanceSchedule:
  endTime: 'END_DATE_AND_TIME_STAMP'
  scheduleDeadlineTime: 'SCHEDULED_DATE_AND_TIME_STAMP'
  startTime: 'START_DATE_AND_TIME_STAMP'

其中：

• maintenancePolicy 會顯示偏好維護政策的建立時間。
  • DAY 是指維護作業執行的星期幾。
  • HOUR 是維護作業開始的時間 (世界標準時間)。
• maintenanceSchedule 顯示執行個體已排定的維護作業相關資訊。
  • END_DATE_AND_TIME_STAMP 表示執行個體排定的維護更新作業結束時間。
  • SCHEDULED_DATE_AND_TIME_STAMP 會指出執行個體預計完成維護更新的時間。
  • START_DATE_AND_TIME_STAMP 表示執行個體排定的維護更新開始時間。

重新排定維護時間

您可以使用 gcloud CLI 重新安排 Memorystore for Valkey 執行個體的維護時間。因此，您可以將執行個體的維護更新延後最多兩週。

注意： 雖然 Memorystore for Valkey 不提供一次為多個執行個體重新排定維護時間的選項，但您可以透過程式輔助方式大量重新排定維護時間。如果大量重新安排時間，請將作業分批處理，並將要求大小調整為適當大小。建議您將批次大小限制為 100 個執行個體，並在要求之間等待充足的時間。否則，您可能無法重新安排活動。詳情請參閱「定期維護」。

gcloud

如要重新安排執行個體的維護時間，請使用 gcloud memorystore instances reschedule-maintenance 指令。

gcloud memorystore instances reschedule-maintenance INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--reschedule-type=RESCHEDULE_TYPE [--schedule-time=RESCHEDULE_TIME]

請將下列項目改為對應的值：

• INSTANCE_ID：執行個體的 ID。
• PROJECT_ID：包含執行個體的專案 ID 或編號。 Google Cloud
• REGION_ID：執行個體所在的區域。

• RESCHEDULE_TYPE：重新安排的更新類型。可用的值如下：

  • IMMEDIATE：立即開始維護更新。
  • SPECIFIC_TIME：指定更新時間。這個時間不得超過原始維護時間的 14 天。

• RESCHEDULE_TIME：Memorystore for Valkey 重新安排維護更新作業的日期和時間。

  注意： 如要為 RESCHEDULE_TIME 參數指定值，請務必將 RESCHEDULE_TYPE 參數設為 SPECIFIC_TIME。這個值採用 ISO 8601 標準 (例如 2025-02-16T16:56:00.000Z)。時間以世界標準時間設定。

從執行個體移除維護政策

如果不再需要 Memorystore for Valkey 執行個體的維護政策，且想改用服務的預設維護設定，可以使用 gcloud CLI 從執行個體移除政策。

gcloud

如要從執行個體移除維護政策，請使用 gcloud memorystore instances update 指令。

gcloud memorystore instances update INSTANCE_ID \
--project=PROJECT_ID \
--location=REGION_ID \
--clear-maintenance-policy-weekly-window

請將下列項目改為對應的值：

• INSTANCE_ID：要移除維護政策的執行個體 ID
• PROJECT_ID：包含執行個體的 Google Cloud 專案的專案 ID 或編號
• REGION_ID：執行個體所在的區域

後續步驟

• 查看管理 Memorystore for Valkey 執行個體維護期間的權限。