メンテナンスの時間枠を検索、設定する

Memorystore for Valkey はインスタンスを定期的に更新し、サービスの信頼性、パフォーマンス、セキュリティ、最新性を確保します。こうした更新はメンテナンスと呼ばれます。

メンテナンスはサービスによって完全に管理され、ダウンタイムの影響がゼロになるように設計されています。ただし、Memorystore for Valkey がインスタンスのメンテナンスを実行するだけでなく、アプリケーションのニーズに合わせてメンテナンス スケジュールをカスタマイズし、中断を最小限に抑えることもできます。メンテナンス スケジュールをカスタマイズするには、インスタンスのメンテナンスの時間枠を構成します。

このページでは、メンテナンスの時間枠をカスタマイズするために次のタスクを行う方法について説明します。

• メンテナンスの時間枠を設定したインスタンスを作成する
• メンテナンスの優先時間枠を設定する
• メンテナンス通知をオンにする
• 定期メンテナンスを確認する
• メンテナンスのスケジュールを変更する
• インスタンスからメンテナンス ポリシーを削除する

メンテナンスの更新とメンテナンスの時間枠の概要については、メンテナンスについてをご覧ください。

メンテナンスの時間枠を設定したインスタンスを作成する

メンテナンスの時間枠を設定した Memorystore for Valkey インスタンスを作成するには、gcloud CLI を使用します。

重要: このセクションの手順を行う前に、始める前にとネットワークを設定するセクションの手順を完了してください。

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: メンテナンスの時間枠が始まる時刻（UTC 時間）。有効な値は 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 になります。

メンテナンスのための優先時間枠を設定する

Memorystore for Valkey インスタンスのメンテナンスの時間枠は、gcloud CLI を使用して設定できます。

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: メンテナンスの時間枠が始まる時刻（UTC 時間）。有効な値は 0～23 です。

メンテナンス通知をオンにする

Memorystore for Valkey インスタンスのメンテナンス通知は、 Google Cloud コンソールを使用して有効にできます。

注: メンテナンス通知をオンにしても、インスタンスのメンテナンスの時間枠を設定しない限り、通知は届きません。

1. Google Cloud コンソールで、[通信] ページに移動します。

   通信

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 は、メンテナンスが開始する時間（UTC 時間）です。
• maintenanceSchedule には、インスタンスの定期メンテナンスに関する情報が表示されます。
  • END_DATE_AND_TIME_STAMP は、インスタンスの定期メンテナンス更新が終了する時刻を示します。
  • SCHEDULED_DATE_AND_TIME_STAMP は、インスタンスのメンテナンス更新が完了する予定の時刻を示します。
  • START_DATE_AND_TIME_STAMP は、インスタンスでスケジュールされているメンテナンス更新の開始時刻を示します。

メンテナンス スケジュールの再設定

gcloud CLI を使用して、Memorystore for Valkey インスタンスのメンテナンスのスケジュールを変更できます。そのため、メンテナンス更新は、インスタンスに最初にスケジュールされた更新から最大 2 週間延期できます。

注意: 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: インスタンスが含まれている Google Cloud プロジェクトのプロジェクト ID または番号。
• 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 など）を使用します。時刻は UTC 時間で設定されます。

インスタンスからメンテナンス ポリシーを削除する

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 インスタンスのメンテナンス時間枠の管理に必要な権限を表示する。