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 reinicialização da instância e são salvas se a instância for reiniciada. É possível atualizar os parâmetros de configuração modificáveis depois de criar uma instância.

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

Antes de começar

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

Conferir parâmetros de configuração

Para conferir os parâmetros de configuração usando a Google Cloud CLI, execute o comando gcloud memorystore instances describe, substituindo variables pelos 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

    Para mais detalhes sobre tipos de nó e configurações de instância, consulte Especificação de instância e de nó.

  • 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ância. Se o modo selecionado for "Modo de cluster desativado", você só poderá especificar um fragmento para a instância. Para mais informações, consulte Especificação de instância e de 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 ter como padrão o modo cluster ativado. 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, 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 para 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