Criar e gerenciar instâncias do Redis

Observação: se você está procurando a documentação do Memorystore para Redis Cluster, consulte Criar instâncias.

Esta página descreve como usar o console do Google Cloud e a Google Cloud CLI para criar e gerenciar instâncias do Memorystore para Redis.

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 Google Cloud.

   Memorystore para Redis

2. Clique em Criar instância.

   

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.
   • Selecione Versão 7.0 (recommended) do Redis.
   • Em Capacidade, insira um valor entre 1 e 300 GB.
   • Se quiser ativar o Redis AUTH, selecione Ativar AUTH.
   • Se você quiser ativar a criptografia em trânsito, selecione Ativar criptografia em trânsito.
   • 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.
     Observação: recomendamos que você siga esta etapa para que sua instância use o modo de 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.

Sinalizações opcionais

Versão do Redis

Importante: também é possível fazer upgrade de uma instância do Redis atual para uma versão mais recente do OSS 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_7_2
• redis_7_0 (padrão)
• redis_6_X
• redis_5_0
• redis_4_0
• redis_3_2

Exemplo:

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

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.

Para instruções sobre como usar a sinalização --reserved-ip-range para especificar um intervalo de endereços IP, consulte Como criar uma instância do Redis com um intervalo de endereços IP específico.

AUTH do Redis

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

--enable-auth

Criptografia em trânsito

Para ativar a criptografia em trânsito, use a seguinte sinalização:

--transit-encryption-mode=SERVER_AUTHENTICATION

Nível Standard

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 

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 da Google Cloud CLI.

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

Importante: é preciso estabelecer uma conexão de acesso a serviços privados na rede do projeto de host antes de criar uma instância do Redis com a sinalização --connect-mode=private-service-access listada abaixo. Caso contrário, a operação de criação falhará. Para mais detalhes, consulte Rede.

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 criar uma instância do Redis com um intervalo de endereços IP específico

Veja nas instruções a seguir como criar uma instância do Redis dentro de um intervalo de endereços IP de sua escolha.

Intervalos personalizados com peering direto

Se o projeto usa o modo de conexão DIRECT_PEERING, use o seguinte comando para designar um intervalo de endereços IP específico ao criar uma instância:

gcloud redis instances create INSTANCE_ID --region=REGION --size=SIZE --connect-mode=DIRECT_PEERING --network=VPC_NETWORK_NAME --reserved-ip-range=RESERVED_RANGE

Em que:

• VPC_NETWORK_NAME é o nome da rede usada para criar a instância.
• RESERVED_RANGE é o intervalo personalizado desejado. Por exemplo, 10.0.0.0/29. O tamanho mínimo do bloco necessário é /29 para instâncias sem réplicas de leitura e /28 para instâncias com réplicas de leitura. Não é possível usar essa flag para designar vários intervalos com esse modo de conexão.

Exemplo:

gcloud redis instances create myinstance --region=us-central1 --size=1 --connect-mode=DIRECT_PEERING --network=default --reserved-ip-range=10.0.0.0/24

Intervalos personalizados com acesso a serviços particulares

Se você tiver apenas um intervalo de endereços IP alocado para sua conexão de acesso a serviços particulares, esse intervalo será usado por padrão para a criação de instâncias do Memorystore.

Se você tiver vários intervalos de endereços alocados para acesso a serviços particulares, selecione qual deles usar com o seguinte comando gcloud:

gcloud redis instances create INSTANCE_ID --region=REGION --size=SIZE --connect-mode=PRIVATE_SERVICE_ACCESS --network=VPC_NETWORK_NAME --reserved-ip-range=RESERVED_RANGE_NAME

Em que:

• VPC_NETWORK_NAME é o nome da rede usada para criar a instância;
• RESERVED_RANGE_NAME é o nome dos intervalos de endereços IP alocados. É possível usar essa flag para especificar os nomes de várias alocações de intervalo com esse modo de conexão. Para isso, forneça os nomes separados por vírgulas.

Exemplo:

gcloud redis instances create myinstance --region=us-central1 --size=1 --connect-mode=PRIVATE_SERVICE_ACCESS --network=default --reserved-ip-range=my-reserved-range-1,my-reserved-range-2

Como criar uma instância do Redis com réplicas de leitura

Para instruções sobre como criar uma instância do Redis com réplicas de leitura, consulte Como criar uma instância do Redis com réplicas de leitura.

Como criar uma instância do Redis que usa chaves de criptografia gerenciadas pelo cliente

Para instruções sobre como criar uma instância do Redis que usa chaves de criptografia gerenciadas pelo cliente (CMEK), consulte Como criar uma instância do Memorystore para Redis que usa CMEK.

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

A seguir

• Saiba como se conectar a uma instância do Redis.
• Aprenda a monitorar instâncias do Redis.