Como criar e gerenciar instâncias do Redis

Nesta página, descrevemos como usar o Console do Google Cloud e o SDK do Cloud para criar e gerenciar as instâncias do Memorystore para Redis.

Para conectar um cliente a uma instância do Memorystore para Redis, o cliente e a instância precisam estar localizados na mesma região.

Para ver uma lista das permissões necessárias para criar e gerenciar instâncias do Redis, consulte Controle de acesso e permissões.

Como criar uma instância do Redis em uma rede VPC

Para criar uma nova instância:

Console

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

    Memorystore para Redis

  2. Clique em Criar instância.

    IU do Memorystore

  3. Na página Criar uma instância do Redis, selecione as configurações pretendidas para a nova instância.

    • Dê um Código de instância à instância e, se quiser, um Nome de exibição. O Código da instância precisa usar 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 o nível Básico ou Padrão. Para mais informações sobre esses níveis, consulte Níveis dos recursos do Redis.
    • Escolha uma Região e uma Zona para a instância. Para acessar sua instância do Redis usando um recurso regional, como uma instância de VM do Compute Engine, verifique se ambos foram criados na mesma região.
    • Selecione Versão 5.0 (recommended) do Redis.
    • Em Capacidade, insira um valor entre 1 e 300 GB.
    • Se quiser ativar o Redis AUTH, selecione Ativar AUTH.
    • Em Rede autorizada, selecione a rede default ou uma das redes VPC disponíveis.
    • Opcional. Para configurar a conexão de acesso a serviços privados, clique no expansor Opções de rede avançadas.

      • Se você vir o painel de conexão de serviço particular necessário, use o painel para estabelecer uma conexão de acesso a serviços privados.
    • Para adicionar configurações do Redis, clique no botão Adicionar configuração, escolha uma configuração na lista suspensa Configuração e insira o valor pretendido. Para mais informações sobre as configurações disponíveis, consulte Como configurar instâncias do Redis.

  4. Clique no botão Criar.

gcloud

Digite o seguinte comando, substituindo VARIABLES pelos valores apropriados:

gcloud redis instances create INSTANCE_ID --size=SIZE --region=REGION_ID

Em que:

  • INSTANCE_ID é o ID atribuído à instância.
  • SIZE é o tamanho da instância, em gibibytes (GiB).
  • REGION_ID é o ID da região.

Exemplo:

gcloud redis instances create myinstance --size=5 --region=us-central1

Requisitos de criação de instâncias

Os códigos de instâncias precisam começar com uma letra minúscula e incluir apenas letras minúsculas, hifens e números, sem espaços.

Para acessar sua instância do Redis usando um recurso regional, como uma instância de VM do Compute Engine, verifique se ambos foram criados na mesma região.

Sinalizações opcionais

Versão do Redis

Para escolher uma das versões disponíveis do OSS Redis compatíveis com o Memorystore para Redis, use a sinalização --redis-version com um dos seguintes valores:

  • redis_5_0 (recomendado)
  • redis_4_0 (padrão)
  • redis_3_2

Exemplo:

gcloud redis instances create myinstance --size=5 --region=us-central1 \
    --zone=us-central1-a --redis-version=redis_5_0
Rede

É possível criar instâncias do Redis usando um dos dois modos de conexão: --connect-mode=private-service-access ou --connect-mode=direct-peering. Recomendamos que você use o modo de conexão private service access. Para mais detalhes, consulte Rede.

Se você optar por usar o modo de peering direto para criar sua instância, poderá escolher um intervalo de endereços IP personalizado usando o parâmetro opcional gcloud --reserved-ip-range. Veja um exemplo de um valor aceitável para esse parâmetro:

--reserved-ip-range=10.0.0.0/29

Esse parâmetro funciona apenas com o modo de conexão de peering direto. O intervalo precisa ser único e não se sobrepor aos intervalos atuais na rede. Se você deixar o parâmetro de intervalo reservado não especificado, o serviço escolherá automaticamente um intervalo disponível.

VISUALIZAÇÃOdo Redis AUTH

Para ativar o AUTH, use a seguinte sinalização:

--enable-auth

Lembre-se de usar o comando gcloud beta redis para acessar esse recurso Beta.

Nível padrão

Para criar uma instância de nível padrão, adicione --tier=STANDARD ao comando de criação. O comando a seguir cria uma instância de nível padrão:

gcloud redis instances create INSTANCE_ID --size=SIZE --zone=ZONE --alternative-zone=ALTERNATIVE_ZONE --tier=STANDARD 

Em que:

  • ZONE é o local onde o nó principal é provisionado;
  • ALTERNATIVE_ZONE é o local onde o nó da réplica é provisionado;

Por exemplo:

gcloud redis instances create myinstance --size=5 --region=us-central1 --tier=standard 

Para mais informações sobre como usar o gcloud com o Memorystore para Redis, consulte a página de referência do SDK do Cloud.

Agora sua instância foi criada.

Como criar uma instância do Redis em uma rede VPC compartilhada a partir de um projeto de serviço

Nesta seção, explicamos como criar uma instância do Redis em um projeto de serviço usando a rede VPC compartilhada do projeto host. Isso permite que você se conecte à sua instância do Redis a partir de recursos em diferentes projetos conectados à mesma rede VPC compartilhada. Para mais detalhes, consulte Visão geral da VPC compartilhada.

Console

  1. Verifique ou estabeleça uma conexão de acesso a serviços privados para a rede no projeto host que você usa para criar a instância do Redis.

  2. Verifique se a API Service Networking está ativada no projeto host e no serviço de serviço.

  3. Siga as etapas de Como criar uma instância do Redis em uma rede VPC, mas faça as seguintes modificações:

    1. Conclua a etapa opcional para configurar uma conexão de acesso a serviços privados.

    2. Use o menu suspenso Rede VPC autorizada para selecionar a rede VPC compartilhada do projeto host. Ela está listada em Redes VPC compartilhadas.

gcloud

  1. Verifique se a API Service Networking está ativada no projeto host e no serviço de serviço.

  2. Crie uma instância do Redis em um projeto de serviço usando a VPC compartilhada do projeto host:

    gcloud redis instances create INSTANCE_ID --size=SIZE --region=REGION_ID --project=SERVICE_PROJECT_ID \
      --network=projects/HOST_PROJECT_ID/global/networks/HOST_NETWORK_NAME \
      --connect-mode=private-service-access
    

    Em que:

    • INSTANCE_ID é o ID atribuído à instância.
    • SIZE é o tamanho da instância, em gibibytes (GiB).
    • REGION_ID é o ID da região.
    • SERVICE_PROJECT_ID é o ID do projeto de serviço.
    • HOST_PROJECT_ID é o ID do projeto host.
    • HOST_NETWORK_NAME é o nome da rede do projeto host.

    Exemplo:

    gcloud redis instances create myinstance --size=5 --region=us-central1 --project=my-service-project \
      --network=projects/my-host-project/global/networks/my-host-shared-vpc \
      --connect-mode=private-service-access
    

Como criar uma instância do Redis que usa um intervalo de endereços IP centralizado

O gerenciamento centralizado de intervalos de endereços IP é fornecido por meio do acesso a serviços privados. O acesso a serviços privados designa um intervalo de endereços IP usado por vários serviços do Google Cloud. O uso de acesso a serviços privados elimina a necessidade de gerenciar um intervalo de endereços IP diferente para cada serviço.

Console

  1. Verifique ou estabeleça uma conexão de acesso a serviços privados para a rede que você usa para criar a instância do Redis.

  2. Siga as etapas de Como criar uma instância do Redis em uma rede VPC, mas preencha a seção opcional sobre como estabelecer uma conexão de acesso a serviços privados.

gcloud

  1. Verifique ou estabeleça uma conexão de acesso a serviços privados para a rede que você usa para criar a instância do Redis.

  2. Crie uma instância do Redis usando a rede em que você estabeleceu uma conexão de acesso a serviços privados:

    gcloud redis instances create INSTANCE_ID --size=SIZE --region=REGION_ID --project=PROJECT_ID \
      --network=projects/PROJECT_ID/global/networks/NETWORK_NAME \
      --connect-mode=private-service-access
    

    Em que:

    • INSTANCE_ID é o ID atribuído à instância.
    • SIZE é o tamanho da instância, em gibibytes (GiB).
    • REGION_ID é o ID da região.
    • PROJECT_ID é o ID do projeto;
    • NETWORK_NAME é o nome da rede para criar a instância do Redis.

    Exemplo:

    gcloud redis instances create myinstance --size=5 --region=us-central1 --project=my-project \
      --network=projects/my-project/global/networks/my-network \
      --connect-mode=private-service-access
    

Como visualizar informações da instância

Para visualizar as informações de uma instância:

Console

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

    Memorystore para Redis

  2. Clique no código da instância para visualizar as informações. sobre a instância.

Gcloud

Para visualizar a lista de todas as instâncias em uma região, digite o seguinte comando, substituindo VARIABLES pelos valores apropriados:

gcloud redis instances list --region=REGION_ID

Para visualizar os detalhes de uma instância, insira o seguinte comando:

gcloud redis instances describe INSTANCE_ID --region=REGION_ID

Como editar instâncias

Para editar uma instância:

Console

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

    Memorystore para Redis

  2. Clique no Código da instância que você quer editar.

  3. Clique no botão Editar

    1. Na página Editar instância do Redis, você pode alterar o seguinte:
      • Nome de exibição
      • Capacidade
      • Configurações
  4. Clique no botão Save.

Enquanto as atualizações estão sendo feitas, um círculo que gira aparece ao lado da sua instância na página inicial do Memorystore para Redis. Quando as atualizações terminam, o círculo se torna uma marca de seleção verde.

Gcloud

Depois de criar uma instância, é possível atualizar as seguintes propriedades:

  • Nome de exibição
  • Configuração do Redis
  • Rótulos
  • Tamanho (para mais informações sobre dimensionamento, consulte Como dimensionar instâncias)

Por exemplo, digite o seguinte comando para atualizar o nome de exibição de uma instância, substituindo VARIABLES pelos valores apropriados:

gcloud redis instances update INSTANCE_ID --region=REGION_ID --display-name=NEW_DISPLAY_NAME

Para mais detalhes sobre como definir parâmetros de configuração, consulte Como configurar instâncias do Redis.

Excluir instâncias

Para excluir uma instância:

Console

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

    Memorystore para Redis

  2. Para excluir uma instância, clique no Código da instância.

  3. Clique no botão Excluir.

  4. Para confirmar a exclusão, insira o código da instância.

  5. Clique novamente em Excluir.

Gcloud

Para excluir uma instância, digite o seguinte comando, substituindo VARIABLES pelos valores apropriados:

gcloud redis instances delete INSTANCE_ID --region=REGION_ID

Depois que a instância é excluída, ela é removida da lista de instâncias na página inicial do Memorystore.