Configurar um cluster

O Memorystore for Redis Cluster é compatível com um subconjunto dos parâmetros de configuração do Redis que podem ser modificados para personalizar o comportamento do cluster.

As alterações de configuração não exigem que você reinicie o cluster e não interrompem o serviço. O Memorystore for Redis Cluster salva as mudanças imediatamente. Se o cluster for reiniciado, ele vai manter as mudanças de configuração. Depois de criar um cluster, é possível atualizar os parâmetros de configuração modificáveis. Para mais informações, consulte Configurações de cluster compatíveis.

Antes de começar

Verifique se você instalou a versão mais recente da Google Cloud CLI. Para atualizar uma instalação, use o comando gcloud components update.

Ver parâmetros de configuração

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

gcloud redis clusters describe CLUSTER_ID --region=REGION_ID

Faça as seguintes substituições:

  • CLUSTER_ID: o ID do cluster
  • REGION_ID: a região em que o cluster está localizado.

Exemplo:

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

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

Definir um parâmetro de configuração ao criar um cluster

Para definir um parâmetro de configuração ao criar um cluster, use o comando
gcloud redis clusters create com a flag --redis-config.

gcloud redis clusters create CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--network=NETWORK \
--node-type=NODE_TYPE \
--shard-count=SHARD_COUNT \
--redis-config=CONFIG_NAME=CONFIG_VALUE

Faça as seguintes substituições:

  • CLUSTER_ID: o ID do cluster que você está criando.
  • REGION_ID: a região em que você quer que o cluster esteja localizado.
  • PROJECT_ID: o ID do projeto.
  • NETWORK: o nome ou o caminho totalmente qualificado da rede de nuvem privada virtual (VPC) à qual o cluster se conecta.

  • NODE_TYPE: o tipo de nó do cluster.

  • SHARD_COUNT: o número de fragmentos no cluster. A contagem de fragmentos determina a capacidade total de memória para armazenar dados do cluster.

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

gcloud redis clusters create my-cluster --region=us-east1 --project=my-project --network=projects/my-project/global/networks/default --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 um cluster, use o comando
gcloud redis clusters update com a flag --update-redis-config.

gcloud redis clusters update CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--update-redis-config=CONFIG_NAME=CONFIG_VALUE

Faça as seguintes substituições:

  • CLUSTER_ID: o ID do cluster
  • REGION_ID: a região em que o cluster está localizado.
  • PROJECT_ID: 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 redis clusters update my-cluster --region=us-east1 --project=my-project --update-redis-config=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 comando
gcloud redis clusters update com a flag --remove-redis-config.

gcloud redis clusters update CLUSTER_ID \
--region=REGION_ID \
--project=PROJECT_ID \
--remove-redis-config=CONFIG_NAME

Faça as seguintes substituições:

  • CLUSTER_ID: o ID do cluster
  • REGION_ID: a região em que o cluster está localizado.
  • PROJECT_ID: ID do projeto;
  • CONFIG_NAME: o nome do parâmetro de configuração que você quer redefinir para o valor padrão.

Exemplo:

gcloud redis clusters update my-cluster --region=us-east1 --project=my-project --remove-redis-config=maxmemory-policy