配置实例

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

如果您未更改任何配置参数的默认值，则这些参数不会显示在输出中。

在创建实例时设置配置参数

如需在创建实例时设置配置参数，请使用
gcloud memorystore instances create 命令，并添加 --engine-configs 标志。

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：实例中的分片数。分片数决定了用于存储实例数据的总内存容量。

    如果您选择的模式为“已停用集群模式”，则只能为实例指定一个分片。如需了解详情，请参阅 实例和节点规范。

  • 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

更新配置参数

如需更新现有实例的配置参数，请使用
gcloud memorystore instances update 命令，并添加 --update-engine-configs 标志。

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

如需详细了解您可以更新哪些配置参数，请参阅 可修改的配置参数。

重置配置参数

如需将配置参数重置为其默认值，请使用
gcloud memorystore instances update 命令，并添加 --remove-engine-configs 标志。

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

重置所有配置参数

如需将所有配置参数重置为其默认值，请使用
gcloud memorystore instances update 命令，并添加 --clear-engine-configs 标志。

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