配置实例

Memorystore for Valkey 支持一部分 OSS Valkey 配置 参数,您可以修改这些参数来自定义实例的 行为。

配置更改无需重启节点,如果节点重启,则会保存这些更改。创建实例后,您可以更新可修改的配置参数。

如需详细了解可修改的配置参数,请参阅 受支持的实例配置

准备工作

运行 gcloud components update,确保您已安装最新版本的 Google Cloud CLI。

查看配置参数

如需使用 Google Cloud CLI 查看配置参数,请运行 gcloud memorystore instances describe 命令,并将 variables 替换为 适当的值。

除非您将配置参数更改为非默认值,否则在运行 gcloud memorystore instances describe 命令时,您将无法看到配置参数。

gcloud memorystore instances describe instance-id --location=region-id

示例:

gcloud memorystore instances describe my-instance --location=us-central1

在创建实例期间设置配置参数

如需在创建实例时设置配置参数,请运行 gcloud memorystore instances create 命令,并使用 --engine-configs 标志将 variables 替换为适当的值。

gcloud memorystore instances create instance-id \
--location=region-id \
--project=project-id \
--node-type=node-type \
--shard-count=shard-count \
--mode=MODE
--engine-configs=config-name=config-value \

替换以下内容:

  • instance-id 是您要创建的 Memorystore for Valkey 实例的 ID。
  • region-id 是您希望实例所在的区域。
  • project-id 是项目 ID。
  • node-type节点类型 的 实例。

  • shard-count 决定了实例中的分片数量。分片数量决定了用于存储实例数据的总内存容量。如果您选择的模式为“已停用集群模式”,则只能为实例指定一个分片。如需了解详情,请参阅实例和节点规范

  • mode 决定了实例是“已启用集群模式”还是“已停用集群模式”。如果省略此字段,则实例默认处于“已启用集群模式”。如需了解详情,请参阅启用和停用集群模式

  • config-name 是要修改的配置参数。

  • config-value 是您选择的设置,对应于您要配置的参数。

例如:

“已启用集群模式”示例

  gcloud memorystore instances create foo --location=us-east1 --project=test-proj --node-type=highmem-medium --shard-count=3 --engine-configs=maxmemory-policy=allkeys-lru
  

“已停用集群模式”示例

  gcloud memorystore instances create foo --location=us-east1 --project=test-proj --node-type=highmem-medium --shard-count=1 --mode=cluster-disabled --engine-configs=maxmemory-policy=allkeys-lru
  

更新配置参数

如需更新现有实例的配置参数,请运行 gcloud memorystore instances update命令,并使用 --update-engine-configs 标志, 将 variables 替换为适当的值。

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--update-engine-configs=config-name=config-value

示例:

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --update-engine-configs=maxmemory-policy=allkeys-lru

重置配置参数

如需将配置参数重置为默认值,请运行 gcloud memorystore instances update命令,并使用 --remove-engine-configs 标志, 将 variables 替换为适当的值。

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--remove-engine-configs=config-name

示例:

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --remove-engine-configs=maxmemory-policy

清除配置参数

如需将所有配置参数清除为默认值,请运行 gcloud memorystore instances update命令,并使用 --clear-engine-configs 标志, 将 variables 替换为适当的值。

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--clear-engine-configs

示例:

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --clear-engine-configs