Nesta página, descrevemos como criar e gerenciar instâncias do cluster do Memorystore para Redis.
Antes de começar
- No Console do Google Cloud, na página do seletor de projetos, selecione ou crie um projeto do Google Cloud.
Observação: se você não pretende manter os recursos criados usando este procedimento, crie um projeto em vez de selecionar um atual. Depois de concluir essas etapas, exclua o projeto, removendo todos os recursos associados a ele.
Acessar o seletor de projetos - Verifique se o faturamento foi ativado para o projeto. Saiba como verificar se o faturamento está ativado em um projeto.
Instale e inicialize a Google Cloud CLI.
Observação: se você instalou a CLI gcloud anteriormente, execute
gcloud components update
para verificar se você tem a versão mais recente. Você precisa pelo menos da versão da CLI gcloud431.0.0
para acessar os comandos da CLI gcloud do cluster do Memorystore para Redis.-
Ativar a API do Memorystore para Redis
Memorystore para Redis -
Ativar a API Compute Engine
Compute Engine -
Ativar a API Resource Manager
Resource Manager -
Ativar a API Network Connectivity
API Network Connectivity -
Ativar a API Service Consumer Management
API Service Consumer Management
Outros pré-requisitos
- O projeto que você está usando precisa estar na lista de permissões para acessar a visualização particular do cluster do Memorystore para Redis. Se você ainda não incluiu seu projeto na lista de permissões da equipe de engenharia do Memorystore, envie um e-mail para
memorystore-cluster-feedback@google.com
. - Para criar uma instância, é necessário ter a política de conexão de serviço correta. Para mais detalhes, consulte Rede.
- Você precisa ter um destes papéis do IAM no projeto do Google Cloud que está usando:
roles/redis.admin
(papel predefinido do IAM para Memorystore Admin)roles/owner
(papel básico de IAM de Proprietário)roles/editor
(papel básico de IAM de Editor)
Criar uma instância
Console
Acesse a página Cluster do Memorystore para Redis no Console do Google Cloud.
Clique em Criar cluster.
Na página Criar uma instância do cluster do Redis, selecione as configurações desejadas para a nova instância.
- Dê à instância um ID de cluster. O ID do cluster precisa conter apenas letras minúsculas, números e hifens. Ele também precisa começar com uma letra e ser exclusivo na região.
- Por exemplo,
my-instance-1
.
- Por exemplo,
- Escolha uma Região para sua instância.
- Em Tamanho do cluster, defina o número de fragmentos de 13 GB para o cluster. 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 do cluster e do fragmento.
- Se você não escolher réplicas de leitura, esse valor poderá variar de 3 a 250 fragmentos.
- Se você escolher uma réplica de leitura por nó, esse valor poderá variar de 3 a 125 fragmentos.
- Se você escolher duas réplicas de leitura por nó, esse valor poderá variar de 3 a 83 fragmentos.
- Se você quiser criar uma instância com réplicas de leitura, insira o número desejado de réplicas (por fragmento) em Réplicas de leitura. Os valores aceitáveis são 0 réplica de leitura, 1 réplica de leitura e 2 réplicas de leitura. O valor padrão é 1 réplica de leitura ao usar o console do Google Cloud.
- Em Configurar rede particular, selecione a rede desejada. Para mais detalhes sobre redes privadas no Cluster do Memorystore para Redis, consulte Rede.
- Se você quiser ativar a criptografia em trânsito, selecione Ativar Transport Layer Security (TLS).
- Dê à instância um ID de cluster. O ID do cluster precisa conter apenas letras minúsculas, números e hifens. Ele também precisa começar com uma letra e ser exclusivo na região.
Clique no botão Criar cluster.
gcloud
Para criar uma instância de cluster do Memorystore para Redis, execute o comando create
:
gcloud alpha redis clusters create INSTANCE_ID \ --region=REGION_ID \ --network=NETWORK \ --replica-count=REPLICA_COUNT \ --shard-count=SHARD_COUNT
Substitua:
INSTANCE_ID é o ID da instância do cluster do Memorystore para Redis que você está criando. O ID da instância precisa ter de 1 a 63 caracteres e usar apenas letras minúsculas, números ou hifens. Ele precisa começar com uma letra minúscula e terminar com uma letra minúscula ou um número.
REGION_ID é a região em que você quer colocar a instância.
NETWORK é a rede usada para criar a instância; Ele precisa usar o formato:
projects/NETWORK_PROJECT_ID/global/networks/NETWORK_ID
. O ID de rede usado aqui precisa corresponder ao usado pela política de conexão de serviço. Caso contrário, a operaçãocreate
falhará.REPLICA_COUNT é o número desejado de réplicas de leitura (por fragmento). Os valores aceitos são
0
,1
e2
.SHARD_COUNT determina o número de fragmentos de 13 GB 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 do cluster e do fragmento.
- A contagem de fragmentos pode variar de 3 a 250, dependendo de quantas réplicas de leitura você escolher:
- 0 réplica de leitura – a contagem máxima de fragmentos é 250
- 1 réplica de leitura – a contagem máxima de fragmentos é 125
- 2 réplicas de leitura – a contagem máxima de fragmentos é 83
- A contagem de fragmentos pode variar de 3 a 250, dependendo de quantas réplicas de leitura você escolher:
Exemplo:
gcloud alpha redis clusters create my-instance \ --region=us-central1 \ --network=projects/my-project-335118/global/networks/default \ --replica-count=2 \ --shard-count=8
Por padrão, a criptografia em trânsito está desativada e a rede autorizada é default
.
Listar instâncias
Console
Para ver uma lista de instâncias, acesse a página Cluster do Memorystore para Redis no Console do Google Cloud.
gcloud
Para ver as instâncias atuais do cluster do Memorystore para Redis, execute o comando list
:
gcloud alpha redis clusters list \ --region=REGION_ID \
Substitua:
- REGION_ID é a região em que a instância está localizada;
Exemplo:
gcloud alpha redis clusters list \ --region=us-central1 \
Exibir detalhes da instância
Console
Acesse a página Cluster do Memorystore para Redis no Console do Google Cloud.
Clique no ID do cluster.
gcloud
Para ver os detalhes de uma instância, execute o comando describe
:
gcloud alpha redis clusters describe INSTANCE_ID \ --region=REGION
Substitua:
- INSTANCE_ID é o ID da sua instância;
- REGION_ID é a região em que a instância está localizada; Exemplo:
gcloud alpha redis clusters describe my-instance \ --region=us-central1
Excluir um cluster
Console
Acesse a página Cluster do Memorystore para Redis no Console do Google Cloud.
Clique no ID do cluster.
Clique no botão Excluir.
Insira o código do cluster.
Clique no botão Excluir.
gcloud
gcloud alpha redis clusters delete CLUSTER_ID \ --region=REGION_ID
Exemplo:
gcloud alpha redis clusters delete my-cluster \ --region=us-central1