設定執行個體

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 是您選擇的節點類型。可接受的值如下：

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

    如要進一步瞭解節點類型和執行個體設定，請參閱「執行個體和節點規格」。

  • shard-count 決定執行個體中的 shard 數量。資料分割數量會決定儲存執行個體資料的記憶體總容量。如果選取的模式為「已停用叢集模式」，則執行個體只能指定一個 shard。詳情請參閱「執行個體和節點規格」。

  • 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