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 Google Cloud CLI 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 beta memorystore instances describe substituindo variables pelos valores apropriados.

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

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

Exemplo:

gcloud beta 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 beta memorystore instances create com a flag --engine-configs substituindo variables pelos valores apropriados.

gcloud beta memorystore instances create instance-id \
--location=region-id \
--project=project-id \
--node-type=node-type \
--shard-count=shard-count \
--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ós e configurações de instância, consulte Especificação de instâncias e nós.

  • 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. Para mais detalhes sobre a especificação da instância, consulte Especificação de instâncias e nós.

  • 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:

gcloud beta memorystore instances create foo --location=us-east1 --project=test-proj --node-type=highmem-medium --shard-count=3 --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 beta memorystore instances update com a flag --update-engine-configs substituindo variables pelos valores apropriados.

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

Exemplo:

gcloud beta 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 beta memorystore instances update com a flag --remove-engine-configs substituindo variables pelos valores apropriados.

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

Exemplo:

gcloud beta 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 beta memorystore instances update com a flag --clear-engine-configs substituindo variables pelos valores adequados.

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

Exemplo:

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