Configurar uma instância

O Memorystore para Redis Cluster é compatível com um subconjunto dos parâmetros de configuração nativos do Redis 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 o serviço não é interrompido. Se você reiniciar a instância, o cluster do Memorystore para Redis vai salvar as mudanças. Depois de criar a instância, é possível atualizar qualquer parâmetro de configuração modificável.

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 redis clusters describe substituindo variables por valores apropriados.

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

gcloud redis clusters describe instance-id --region=region-id

Exemplo:

gcloud redis clusters describe my-instance --region=us-central1

Definir um parâmetro de configuração durante a criação do cluster

Para definir um parâmetro de configuração ao criar um cluster, execute o comando gcloud redis clusters create com a flag --redis-config, substituindo variables pelos valores apropriados.

gcloud redis clusters create instance-id \
--region=region-id \
--project=project-id \
--node-type=node-type \
--shard-count=shard-count \
--redis-config=config-name=config-value \

Substitua:

  • instance-id é o ID da instância do cluster do Memorystore para Redis 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:

    • redis-shared-core-nano
    • redis-standard-small
    • redis-highmem-medium
    • redis-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 do cluster. Para mais detalhes sobre a especificação do cluster, consulte Especificação de cluster e 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 redis clusters create foo --region=us-east1 --project=test-proj --node-type=redis-highmem-medium --shard-count=3 --redis-config=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 redis clusters update com a flag --update-redis-config substituindo variables pelos valores apropriados.

gcloud redis clusters update instance-id \
--region=region-id \
--project=project-id \
--update-redis-config=config-name=config-value

Exemplo:

gcloud redis clusters update foo --region=us-east1 --project=test-proj --update-redis-config=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 redis clusters update com a flag --remove-redis-config substituindo variables pelos valores apropriados.

gcloud redis clusters update instance-id \
--region=region-id \
--project=project-id \
--remove-redis-config=config-name

Exemplo:

gcloud redis clusters update foo --region=us-east1 --project=test-proj --remove-redis-config=maxmemory-policy