Configurar uma instância

O Memorystore para Valkey oferece suporte a um subconjunto dos parâmetros de configuração do Valkey que podem ser modificados para personalizar o comportamento da instância.

As mudanças de configuração não exigem a reinicialização da instância e não interrompem o serviço. O Memorystore para Valkey salva as mudanças imediatamente. Se a instância for reiniciada, ela vai manter as mudanças de configuração. Depois de criar uma instância, é possível atualizar os parâmetros de configuração modificáveis. Para mais informações, consulte Configurações de instância com suporte.

Antes de começar

Instale a versão mais recente da Google Cloud CLI. Para atualizar uma instalação atual, use o gcloud components update comando.

Conferir parâmetros de configuração

Para conferir os parâmetros de configuração, use o gcloud memorystore instances describe comando.

gcloud memorystore instances describe INSTANCE_ID --location=REGION_ID

Faça as seguintes substituições:

  • INSTANCE_ID: o ID da instância
  • REGION_ID: a região em que a instância está localizada

Exemplo:

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

Se você não mudar nenhum parâmetro de configuração dos valores padrão, eles não vão aparecer na saída.

Definir um parâmetro de configuração ao criar uma instância

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

gcloud memorystore instances create INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--node-type=NODE_TYPE \
--mode=MODE \
--shard-count=SHARD_COUNT \
--engine-configs=CONFIG_NAME=CONFIG_VALUE

Faça as seguintes substituições:

  • INSTANCE_ID: o ID da instância que você está criando.
  • REGION_ID: a região em que você quer que a instância esteja localizada.
  • PROJECT_ID: o ID do projeto.

  • NODE_TYPE: o tipo de nó da instância.

  • MODE: se você está criando uma instância com o modo de cluster ativado ou desativado. Se você omitir esse campo, o Memorystore for Valkey vai criar uma instância com o modo de cluster ativado por padrão. Para mais informações, consulte Ativar e desativar o modo de cluster.

  • SHARD_COUNT: o número de fragmentos na instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados da instância.

    Se o modo selecionado for o modo de cluster desativado, você poderá especificar apenas um fragmento para a instância. Para mais informações, consulte Especificação de instância e nó.

  • CONFIG_NAME: o nome do parâmetro de configuração que você quer definir.

  • CONFIG_VALUE: o valor do parâmetro que você está definindo.

Exemplo:

Exemplo de modo de cluster ativado

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

Exemplo de modo de cluster desativado

  gcloud memorystore instances create my-instance --location=us-east1 --project=my-project --node-type=highmem-medium --mode=cluster-disabled --shard-count=1 --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, use o
gcloud memorystore instances update comando com a --update-engine-configs flag.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--update-engine-configs=CONFIG_NAME=CONFIG_VALUE

Faça as seguintes substituições:

  • INSTANCE_ID: o ID da instância
  • REGION_ID: a região em que a instância está localizada
  • PROJECT_ID: o ID do projeto
  • CONFIG_NAME: o nome do parâmetro de configuração que você quer atualizar
  • CONFIG_VALUE: o novo valor do parâmetro

Exemplo:

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --update-engine-configs=maxmemory-policy=allkeys-lru

Para mais informações sobre quais parâmetros de configuração podem ser atualizados, consulte Parâmetros de configuração modificáveis.

Redefinir um parâmetro de configuração

Para redefinir um parâmetro de configuração para o valor padrão, use o
gcloud memorystore instances update comando com a --remove-engine-configs flag.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--remove-engine-configs=CONFIG_NAME

Faça as seguintes substituições:

  • INSTANCE_ID: o ID da instância
  • REGION_ID: a região em que a instância está localizada
  • PROJECT_ID: o ID do projeto
  • CONFIG_NAME: o nome do parâmetro de configuração que você quer redefinir para o valor padrão

Exemplo:

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --remove-engine-configs=maxmemory-policy

Redefinir todos os parâmetros de configuração

Para redefinir todos os parâmetros de configuração para os valores padrão, use o
gcloud memorystore instances update comando com a --clear-engine-configs flag.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--clear-engine-configs

Faça as seguintes substituições:

  • INSTANCE_ID: o ID da instância
  • REGION_ID: a região em que a instância está localizada
  • PROJECT_ID: o ID do projeto

Exemplo:

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --clear-engine-configs