Configurar uma instância

O Memorystore para Valkey é compatível com um subconjunto dos parâmetros de configuração do OSS Valkey que podem ser modificados para personalizar o comportamento da instância.

As mudanças de configuração não exigem uma reinicialização dos nós e são salvas se um nó for reiniciado. Depois de criar uma instância, é possível atualizar os parâmetros de configuração modificáveis.

Para mais informações sobre os parâmetros de configuração modificáveis, consulte Configurações de instância compatíveis.

Antes de começar

Verifique se você instalou a versão mais recente da Google Cloud CLI executando gcloud components update.

Ver parâmetros de configuração

Para visualizar os parâmetros de configuração usando a Google Cloud CLI, execute o comando gcloud memorystore instances describe, substituindo variables por valores apropriados.

Não é possível ver os parâmetros de configuração ao executar o comando gcloud memorystore instances describe, a menos que você mude um parâmetro de configuração do valor padrão.

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

Exemplo:

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

Definir 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 apropriados.

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:

  • instance-id é o ID da instância do Memorystore para Valkey que você está criando.
  • region-id é a região em que você quer colocar a instância.
  • project-id é o ID do projeto;

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

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

  • shard-count determina o número de fragmentos na instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados de instâncias. Se o modo selecionado for "Modo de cluster desativado", você poderá especificar apenas um fragmento para sua instância. Para mais informações, consulte Especificação da instância e do nó.

  • mode determina se a instância está com o modo de cluster ativado ou desativado. Se esse campo for omitido, a instância vai usar o modo de cluster ativado por padrão. Para mais informações, consulte Ativar e desativar o modo de cluster.

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

  • config-value é a configuração escolhida correspondente ao parâmetro que você está configurando.

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

Atualizar um parâmetro de configuração

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

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

Redefinir um parâmetro de configuração

Para redefinir um parâmetro de configuração para o valor padrão, 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

Limpar parâmetros de configuração

Para limpar todos os parâmetros de configuração e redefinir os valores padrão, execute o comando gcloud memorystore instances update com a flag --clear-engine-configs, substituindo variables pelos 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