Configure uma instância

O Memorystore for Valkey suporta um subconjunto dos parâmetros de configuração do OSS Valkey que pode modificar para personalizar o comportamento da sua instância.

As alterações de configuração não requerem um reinício dos nós e são guardadas se um nó for reiniciado. Depois de criar uma instância, pode atualizar os parâmetros de configuração modificáveis.

Para mais informações sobre os parâmetros de configuração modificáveis, consulte o artigo Configurações de instâncias suportadas.

Antes de começar

Certifique-se de que instalou a versão mais recente da CLI Google Cloud executando gcloud components update.

Veja os parâmetros de configuração

Para ver os parâmetros de configuração através da CLI Google Cloud, execute o comando gcloud memorystore instances describe, substituindo variables por valores adequados.

Não pode ver os parâmetros de configuração quando executa o comando gcloud memorystore instances describe, a menos que altere um parâmetro de configuração do respetivo valor predefinido.

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

Exemplo:

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

Defina um parâmetro de configuração durante a criação da instância

Para definir um parâmetro de configuração ao criar uma instância, execute o comando gcloud memorystore instances create com a flag --engine-configs, substituindo variables pelos valores adequados.

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 \

Substitua o seguinte:

  • instance-id é o ID da instância do Memorystore for Valkey que está a criar.
  • region-id é a região onde quer colocar a instância.
  • project-id é o ID do seu projeto.

  • node-type é o tipo de nó escolhido. Os valores aceites são:

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

  • shard-count determina o número de fragmentos na sua instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados de instâncias. Se selecionar o modo Cluster Mode Disabled, só pode especificar um fragmento para a sua instância. Para mais informações, consulte o artigo Especificação de instâncias e nós.

  • mode determina se a instância está no modo de cluster ativado ou no modo de cluster desativado. Se este campo for omitido, a instância é predefinida como Modo de cluster ativado. Para mais informações, consulte o artigo Ative e desative o modo de cluster.

  • config-name é o parâmetro de configuração a modificar.

  • config-value é a definição escolhida correspondente ao parâmetro que está a configurar.

Por exemplo:

Exemplo de modo de cluster ativado

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

Exemplo de modo de cluster desativado

  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

Atualize um parâmetro de configuração

Para atualizar um parâmetro de configuração de uma instância existente, execute o comando gcloud memorystore instances update com a flag --update-engine-configs, substituindo variables pelos valores adequados.

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

Exemplo:

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

Reponha um parâmetro de configuração

Para repor um parâmetro de configuração para o respetivo valor predefinido, execute o comando gcloud memorystore instances update com a flag --remove-engine-configs, substituindo variables pelos valores adequados.

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

Exemplo:

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

Limpe os parâmetros de configuração

Para limpar todos os parâmetros de configuração para os respetivos valores predefinidos, execute o comando gcloud memorystore instances update com a flag --clear-engine-configs, substituindo variables por valores adequados.

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

Exemplo:

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