Memorystore for Valkey は、Valkey 構成パラメータのサブセットをサポートしており、これを変更することでインスタンスの動作をカスタマイズできます。
構成の変更でインスタンスを再起動する必要はなく、サービスが中断されることもありません。Memorystore for Valkey は変更をすぐに保存します。インスタンスが再起動すると、インスタンスは構成の変更を保持します。インスタンスの作成後、変更可能な構成パラメータを更新できます。詳細については、サポートされているインスタンス構成をご覧ください。
始める前に
Google Cloud CLI の最新バージョンがインストールされていることを確認します。既存のインストールを更新するには、gcloud components update コマンドを使用します。
構成パラメータを表示する
構成パラメータを表示するには、gcloud memorystore instances describe コマンドを使用します。
gcloud memorystore instances describe INSTANCE_ID --location=REGION_ID
次のように置き換えます。
- INSTANCE_ID: インスタンスの ID
- REGION_ID: インスタンスが配置されているリージョン
次に例を示します。
gcloud memorystore instances describe my-instance --location=us-central1
構成パラメータをデフォルト値から変更しない場合、パラメータは出力に表示されません。
インスタンスの作成時に構成パラメータを設定する
インスタンスの作成時に構成パラメータを設定するには、--engine-configs フラグを指定して
gcloud memorystore instances create コマンドを使用します。
gcloud memorystore instances create INSTANCE_ID \ --location=REGION_ID \ --project=PROJECT_ID \ --node-type=NODE_TYPE \ --mode=MODE \ --shard-count=SHARD_COUNT \ --engine-configs=CONFIG_NAME=CONFIG_VALUE
次のように置き換えます。
- INSTANCE_ID: 作成するインスタンスの ID。
- REGION_ID: インスタンスを配置するリージョン。
- PROJECT_ID: プロジェクト ID。
NODE_TYPE: インスタンスのノードタイプ。
MODE: クラスタモードが有効なインスタンスを作成するか、クラスタモードが無効なインスタンスを作成するか。このフィールドを省略すると、デフォルトで Memorystore for Valkey はクラスタモードが有効なインスタンスを作成します。詳細については、クラスタモードを有効または無効にするをご覧ください。
SHARD_COUNT: インスタンス内のシャード数。シャード数によって、インスタンス データを保存するための合計メモリ容量が決定されます。
選択したモードがクラスタモード無効の場合、インスタンスに指定できるシャードは 1 つだけです。詳細については、インスタンスとノードの仕様をご覧ください。
CONFIG_NAME: 設定する構成パラメータの名前。
CONFIG_VALUE: 設定するパラメータの値。
次に例を示します。
クラスタモードが有効な場合の例
gcloud memorystore instances create my-instance --location=us-east1 --project=my-project --node-type=highmem-medium --shard-count=3 --engine-configs=maxmemory-policy=allkeys-lru
クラスタモードが無効になっている例
gcloud memorystore instances create my-instance --location=us-east1 --project=my-project --node-type=highmem-medium --mode=cluster-disabled --shard-count=1 --engine-configs=maxmemory-policy=allkeys-lru
構成パラメータを更新する
既存のインスタンスの構成パラメータを更新するには、--update-engine-configs フラグを指定して
gcloud memorystore instances update コマンドを使用します。
gcloud memorystore instances update INSTANCE_ID \ --location=REGION_ID \ --project=PROJECT_ID \ --update-engine-configs=CONFIG_NAME=CONFIG_VALUE
次のように置き換えます。
- INSTANCE_ID: インスタンスの ID
- REGION_ID: インスタンスが配置されているリージョン
- PROJECT_ID: プロジェクト ID
- CONFIG_NAME: 更新する構成パラメータの名前
- CONFIG_VALUE: パラメータの新しい値
次に例を示します。
gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --update-engine-configs=maxmemory-policy=allkeys-lru
更新できる構成パラメータの詳細については、 変更可能な構成パラメータをご覧ください。
構成パラメータをリセットする
構成パラメータをデフォルト値にリセットするには、--remove-engine-configs フラグを指定して
gcloud memorystore instances update コマンドを使用します。
gcloud memorystore instances update INSTANCE_ID \ --location=REGION_ID \ --project=PROJECT_ID \ --remove-engine-configs=CONFIG_NAME
次のように置き換えます。
- INSTANCE_ID: インスタンスの ID
- REGION_ID: インスタンスが配置されているリージョン
- PROJECT_ID: プロジェクト ID
- CONFIG_NAME: デフォルト値にリセットする構成パラメータの名前
次に例を示します。
gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --remove-engine-configs=maxmemory-policy
すべての構成パラメータをリセットする
すべての構成パラメータをデフォルト値にリセットするには、--clear-engine-configs フラグを指定して
gcloud memorystore instances update コマンドを使用します。
gcloud memorystore instances update INSTANCE_ID \ --location=REGION_ID \ --project=PROJECT_ID \ --clear-engine-configs
次のように置き換えます。
- INSTANCE_ID: インスタンスの ID
- REGION_ID: インスタンスが配置されているリージョン
- PROJECT_ID: プロジェクト ID
次に例を示します。
gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --clear-engine-configs