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 elementos parâmetros de configuração após a criação de 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 CLI do Google Cloud, 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ância e de nó.

  • 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 para uma instância existente, execute o comando gcloud beta memorystore instances update com a sinalização --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 sinalização --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 sinalização --clear-engine-configs substituindo variables pelos valores apropriados.

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