Criar e gerenciar instâncias

Nesta página, descrevemos como criar e gerenciar instâncias do cluster do Memorystore para Redis.

Antes de começar

  1. 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
  2. Verifique se o faturamento foi ativado para o projeto. Saiba como verificar se o faturamento está ativado em um projeto.
  3. 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 gcloud 431.0.0 para acessar os comandos da CLI gcloud do cluster do Memorystore para Redis.

  4. Ativar a API do Memorystore para Redis
    Memorystore para Redis
  5. Ativar a API Compute Engine
    Compute Engine
  6. Ativar a API Resource Manager
    Resource Manager
  7. Ativar a API Network Connectivity
    API Network Connectivity
  8. 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

  1. Acesse a página Cluster do Memorystore para Redis no Console do Google Cloud.

    Cluster do Memorystore para Redis

  2. Clique em Criar cluster.

  3. 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.
    • 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).
  4. 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ção create falhará.

  • REPLICA_COUNT é o número desejado de réplicas de leitura (por fragmento). Os valores aceitos são 0, 1 e 2.

  • 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

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

  1. Para ver uma lista de instâncias, acesse a página Cluster do Memorystore para Redis no Console do Google Cloud.

    Cluster do Memorystore para Redis

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

  1. Acesse a página Cluster do Memorystore para Redis no Console do Google Cloud.

    Cluster do Memorystore para Redis

  2. 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

  1. Acesse a página Cluster do Memorystore para Redis no Console do Google Cloud.

    Cluster do Memorystore para Redis

  2. Clique no ID do cluster.

  3. Clique no botão Excluir.

  4. Insira o código do cluster.

  5. 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