Nesta página, mostramos como criar instâncias do Memorystore for Redis Cluster.
Antes de começar
Siga as instruções da seção "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 neste procedimento, crie um projeto novo em vez de selecionar um que já existe. Depois de concluir essas etapas, é possível excluir o projeto. Para fazer isso, basta remover 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ê já instalou a CLI gcloud anteriormente, execute
gcloud components updatepara verificar se você tem a versão mais recente. É necessário ter pelo menos a versão440.0.0da CLI gcloud para acessar os comandos da CLI gcloud do Memorystore for Redis Cluster.-
Ative a API Memorystore for Redis
Memorystore for Redis -
Ative a API Network Connectivity
API Network Connectivity -
Ative a API Service Consumer Management
API Service Consumer Management
Outros pré-requisitos
- Você precisa ter um destes papéis do IAM no projeto do Google Cloud que está sendo usado:
roles/redis.admin(o papel predefinido do IAM de administrador do Memorystore)roles/owner(o papel básico do IAM de Proprietário)roles/editor(o papel básico do IAM de Editor)
Configurar redes
Leia a página Rede para determinar se você precisa configurar uma política de conexão de serviço.
Se uma política de conexão de serviço não tiver sido criada para a rede com que você vai criar o cluster do Redis, siga as orientações de Rede para criá-la.
Criar uma instância
Console
No console do Google Cloud , acesse a página Memorystore para Redis Cluster.
Clique em Criar cluster.
Na seção Nomear a instância do cluster, insira um ID para o cluster. O ID do cluster 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.
No menu Região, selecione uma região para o cluster.
Na seção Disponibilidade por zona, selecione a opção Multizona porque você quer criar um cluster multizona.
Na seção Tipo de nó, selecione um tipo de nó.
Na seção Tamanho do cluster, insira o número de fragmentos do cluster. A contagem de fragmentos determina a capacidade total de memória para armazenar dados do cluster. Para mais informações sobre as especificações do cluster, consulte Especificação de cluster e nó.
Se você quiser criar um cluster com réplicas, na seção Réplicas, selecione o número de réplicas (por fragmento). É possível selecionar de 0 a 5 réplicas. O valor padrão é 1 réplica.
Na seção Configurar conexão, selecione a rede que os aplicativos podem usar para se conectar a esse cluster. Para mais informações sobre rede privada do Memorystore for Redis Cluster, consulte Visão geral da rede.
Se você quiser aumentar a segurança do cluster, na seção Segurança, faça o seguinte:
Se você quiser ativar a autenticação do IAM, selecione a opção Autenticação do IAM. O Memorystore for Redis Cluster usa a autenticação do IAM para restringir o acesso ao cluster.
Se você quiser ativar a autenticação básica baseada em token, selecione a opção Autenticação de token. O Memorystore para Redis Cluster restringe o acesso ao cluster fazendo com que os clientes usem os tokens de autenticação para verificar as identidades nos aplicativos.
Se você não quiser ativar a autenticação do IAM ou a autenticação básica baseada em token, selecione a opção Desativado.
Se você selecionar as opções Autenticação do IAM ou Autenticação de token, o Memorystore for Redis Cluster vai marcar automaticamente a caixa de seleção Ativar criptografia em trânsito (TLS), e a seção Gerenciamento de autoridade certificadora será exibida. O Memorystore for Redis Cluster criptografa suas credenciais para que elas sejam confidenciais quando transmitidas do cluster para o aplicativo.
Na seção Gerenciamento de autoridade certificadora, selecione a opção CA por instância, CA gerenciada pelo cliente ou CA compartilhada. Essas opções representam os modos de autoridade certificadora (CA) do cluster. O modo de CA determina qual hierarquia de CA é usada para emitir os certificados digitais para o cluster.
Se você selecionar a opção CA gerenciada pelo cliente, será necessário adicionar um pool de CAs. Um pool de CAs é uma coleção de várias CAs com uma política de emissão de certificados e uma política do Identity and Access Management (IAM) comuns. Um pool de CAs facilita o gerenciamento de rotação de CAs e permite que você alcance um total maior de consultas por segundo (QPS) efetivas.
Para adicionar um pool de CAs, siga um destes procedimentos:
Para adicionar um pool de CAs de outro projeto do Google Cloud , marque a caixa de seleção Adicionar CA de outro projeto e insira o ID do recurso do pool no campo de texto.
Para adicionar um pool de CAs localizado no mesmo projeto do Google Cloud que você está usando para criar o cluster, selecione o pool no menu Pool de CAs.
Na seção Criptografia, selecione uma das seguintes opções:
- Chave de criptografia gerenciada pelo Google: você quer que o Google use uma chave para criptografar os dados no cluster. Essa é a criptografia padrão do Google.
Chave do Cloud KMS: você quer gerenciar a criptografia dos seus dados usando chaves de criptografia gerenciadas pelo cliente (CMEKs) no Cloud Key Management Service (Cloud KMS) com serviços integrados a CMEKs, como o Memorystore for Redis Cluster.
Se você selecionar essa opção, faça o seguinte:
- No menu Tipo de gerenciamento de chaves, selecione Cloud KMS.
- No menu Selecionar uma chave do Cloud KMS, escolha uma CMEK.
Para atribuir uma política de ACL ao cluster, selecione uma política no menu Política na seção Política de ACL.
Na seção Estratégia de persistência de dados, especifique como você quer que o Memorystore for Redis Cluster mantenha os dados no cluster. Os valores aceitáveis são Sem persistência, persistência de arquivo somente de anexação (AOF) e persistência de banco de dados do Redis (RDB).
Se você quiser ativar os backups automatizados para o cluster, faça o seguinte:
- Marque a caixa de seleção Backups diários automatizados.
- No campo Dias para reter backups, insira o número de dias
que você quer que o Memorystore for Redis Cluster mantenha os backups antes que eles sejam
excluídos automaticamente. É possível especificar de
1a365dias. O valor padrão é35dias. - No menu Janela de tempo, selecione um horário para o backup diário.
Na seção Manutenção, selecione uma das seguintes opções:
- Padrão: o Memorystore for Redis Cluster atualiza o cluster rotineiramente para garantir que o serviço seja confiável, eficiente, seguro e atualizado.
- Personalizado: você quer personalizar a programação de manutenção do cluster para se alinhar às necessidades do aplicativo e minimizar interrupções. Se você selecionar essa opção, especifique o dia em que quer que a manutenção ocorra e o horário em que quer que a janela de manutenção comece.
Clique em Criar cluster.
gcloud
Para criar uma instância do Memorystore for Redis Cluster, execute o comando create:
gcloud redis clusters create INSTANCE_ID \ --region=REGION_ID \ --network=NETWORK \ --replica-count=REPLICA_COUNT \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT \ --acl-policy=ACL_POLICY_NAME
Substitua:
INSTANCE_ID é o ID da instância do Memorystore for Redis Cluster 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 ID de rede usado pela política de conexão de serviço. Caso contrário, a operaçãocreatefalhará.REPLICA_COUNT é o número de réplicas (por fragmento). Os valores aceitos são
0-5.NODE_TYPE é o tipo de nó que você quer usar para o cluster.
SHARD_COUNT determina o número de fragmentos 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 de cluster e nó.
ACL_POLICY_NAME é o nome da política de lista de controle de acesso (ACL) que você está atribuindo ao cluster que está criando. Ao usar políticas de ACL, é possível proteger o acesso ao cluster. É possível ativar a segurança refinada restringindo o acesso de usuários e serviços a chaves, comandos e canais do Pub/Sub específicos. Para mais informações, consulte Proteger o acesso aos clusters usando políticas de ACL.
Exemplo:
gcloud alpha redis clusters create my-instance \ --region=us-central1 \ --network=projects/my-project-335118/global/networks/default \ --replica-count=2 \ --node-type=redis-highmem-medium \ --shard-count=8 \ --acl-policy=my-acl-policy
Por padrão, a criptografia em trânsito
está desativada, e a rede autorizada é default.
Desativar a implantação em duas zonas
Se uma zona tiver restrições de recursos quando você criar um cluster multizona, o Memorystore for Redis Cluster vai implantar automaticamente o cluster em duas zonas. Essa implantação garante que o cluster seja provisionado corretamente. Para mais informações sobre esse tipo de implantação, consulte Implantações em duas zonas para alta disponibilidade e resiliência.
Se você quiser exigir explicitamente três zonas e recusar essa implantação de duas zonas, especifique essas zonas ao criar o cluster.
É possível desativar a implantação em duas zonas usando a CLI gcloud ou a API REST.
gcloud
Para desativar a implantação em duas zonas, inclua as flags
--zone-distribution-config-mode e --zone-distribution-config-zones
ao executar o comando gcloud redis clusters create:
gcloud redis clusters create CLUSTER_ID \ --project=PROJECT_ID \ --region=REGION_ID \ --network=projects/PROJECT_ID/global/networks/NETWORK_ID \ --replica-count=REPLICA_COUNT \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT \ --zone-distribution-mode=multi-zone \ --zones=ZONE_1,ZONE_2,ZONE_3
Faça as seguintes substituições:
- CLUSTER_ID: o ID do cluster
- PROJECT_ID: o ID do projeto em que você quer criar o cluster.
- REGION_ID: a região em que você quer criar o cluster.
- NETWORK_ID: o ID da rede que você quer usar para criar o cluster.
- REPLICA_COUNT: o número de réplicas (por fragmento) no cluster
- NODE_TYPE: o tipo de nó que você quer usar no cluster.
- SHARD_COUNT: o número de fragmentos no cluster
- ZONE_1, ZONE_2 e ZONE_3: as zonas em que você quer criar o cluster.
REST
Para desativar a implantação em duas zonas ao criar um cluster multizonal, use o seguinte comando da API REST.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- PROJECT_ID: o ID do projeto em que você quer criar o cluster.
- REGION_ID: a região em que você quer que o cluster esteja localizado.
- CLUSTER_ID: o ID do cluster
- SHARD_COUNT: o número de fragmentos no cluster
- REPLICA_COUNT: o número de réplicas (por fragmento) no cluster
- NODE_TYPE: o tipo de nó que você quer usar no cluster.
- NETWORK_ID: o ID da rede do cluster
- ZONE_1, ZONE_2 e ZONE_3: as zonas em que você quer criar o cluster.
Método HTTP e URL:
POST https://redis.googleapis.com/v1/projects/PROJECT_ID/locations/REGION_ID/clusters?clusterId=CLUSTER_ID
Corpo JSON da solicitação:
{
"shardCount": SHARD_COUNT,
"replicaCount": REPLICA_COUNT,
"nodeType": "NODE_TYPE",
"pscConfigs": [
{
"network": "projects/PROJECT_ID/global/networks/NETWORK_ID"
}
],
"zoneDistributionConfig": {
"mode": "MULTI_ZONE",
"zones": [
"ZONE_1",
"ZONE_2",
"ZONE_3"
]
}
}
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
{
"name": "projects/PROJECT_ID/locations/REGION_ID/operations/OPERATION_ID",
"metadata": {
"@type": "type.googleapis.com/google.cloud.redis.cluster.v1.OperationMetadata",
"createTime": "2026-11-04T20:00:00Z",
"target": "projects/PROJECT_ID/locations/REGION_ID/clusters/CLUSTER_ID",
"verb": "create",
"requestedCancellation": false,
"apiVersion": "v1"
},
"done": false
}
Criar uma instância de zona única
Nesta seção, mostramos como criar uma instância de zona única.
Console
No console do Google Cloud , acesse a página Memorystore para Redis Cluster.
Clique em Criar cluster.
Na seção Nomear a instância do cluster, insira um ID para o cluster. O ID do cluster 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.
No menu Região, selecione uma região para o cluster.
Na seção Disponibilidade por zona, faça o seguinte:
Selecione a opção Zona única.
No menu Zona, selecione a zona em que você quer que o Memorystore for Redis Cluster crie o cluster.
Na seção Tipo de nó, selecione um tipo de nó.
Na seção Tamanho do cluster, insira o número de fragmentos do cluster. A contagem de fragmentos determina a capacidade total de memória para armazenar dados do cluster. Para mais informações sobre as especificações do cluster, consulte Especificação de cluster e nó.
Se você quiser criar um cluster com réplicas, na seção Réplicas, selecione o número de réplicas (por fragmento). É possível selecionar de 0 a 5 réplicas. O valor padrão é 1 réplica.
Na seção Configurar conexão, selecione a rede que os aplicativos podem usar para se conectar a esse cluster. Para mais informações sobre rede privada do Memorystore for Redis Cluster, consulte Visão geral da rede.
Se você quiser aumentar a segurança do cluster, na seção Segurança, faça o seguinte:
Se você quiser ativar a autenticação do IAM, selecione a opção Autenticação do IAM. O Memorystore for Redis Cluster usa a autenticação do IAM para restringir o acesso ao cluster.
Se você quiser ativar a autenticação básica baseada em token, selecione a opção Autenticação de token. O Memorystore para Redis Cluster restringe o acesso ao cluster fazendo com que os clientes usem os tokens de autenticação para verificar as identidades nos aplicativos.
Se você não quiser ativar a autenticação do IAM ou a autenticação básica baseada em token, selecione a opção Desativado.
Se você selecionar as opções Autenticação do IAM ou Autenticação de token, o Memorystore for Redis Cluster vai marcar automaticamente a caixa de seleção Ativar criptografia em trânsito (TLS), e a seção Gerenciamento de autoridade certificadora será exibida. O Memorystore for Redis Cluster criptografa suas credenciais para que elas sejam confidenciais quando transmitidas do cluster para o aplicativo.
Na seção Gerenciamento de autoridade certificadora, selecione a opção CA por instância, CA gerenciada pelo cliente ou CA compartilhada. Essas opções representam os modos de autoridade certificadora (CA) do cluster. O modo de CA determina qual hierarquia de CA é usada para emitir os certificados digitais para o cluster.
Se você selecionar a opção CA gerenciada pelo cliente, será necessário adicionar um pool de CAs. Um pool de CAs é uma coleção de várias CAs com uma política de emissão de certificados e uma política do Identity and Access Management (IAM) comuns. Um pool de CAs facilita o gerenciamento de rotação de CAs e permite que você alcance um total maior de consultas por segundo (QPS) efetivas.
Para adicionar um pool de CAs, siga um destes procedimentos:
Para adicionar um pool de CAs de outro projeto do Google Cloud , marque a caixa de seleção Adicionar CA de outro projeto e insira o ID do recurso do pool no campo de texto.
Para adicionar um pool de CAs localizado no mesmo projeto do Google Cloud que você está usando para criar o cluster, selecione o pool no menu Pool de CAs.
Na seção Criptografia, selecione uma das seguintes opções:
- Chave de criptografia gerenciada pelo Google: você quer que o Google use uma chave para criptografar os dados no cluster. Essa é a criptografia padrão do Google.
Chave do Cloud KMS: você quer gerenciar a criptografia dos seus dados usando chaves de criptografia gerenciadas pelo cliente (CMEKs) no Cloud Key Management Service (Cloud KMS) com serviços integrados a CMEKs, como o Memorystore for Redis Cluster.
Se você selecionar essa opção, faça o seguinte:
- No menu Tipo de gerenciamento de chaves, selecione Cloud KMS.
- No menu Selecionar uma chave do Cloud KMS, escolha uma CMEK.
Para atribuir uma política de ACL ao cluster, selecione uma política no menu Política na seção Política de ACL.
Na seção Estratégia de persistência de dados, especifique como você quer que o Memorystore for Redis Cluster mantenha os dados no cluster. Os valores aceitáveis são Sem persistência, persistência de arquivo somente de anexação (AOF) e persistência de banco de dados do Redis (RDB).
Se você quiser ativar os backups automatizados para o cluster, faça o seguinte:
- Marque a caixa de seleção Backups diários automatizados.
- No campo Dias para reter backups, insira o número de dias
que você quer que o Memorystore for Redis Cluster mantenha os backups antes que eles sejam
excluídos automaticamente. É possível especificar de
1a365dias. O valor padrão é35dias. - No menu Janela de tempo, selecione um horário para o backup diário.
Na seção Manutenção, selecione uma das seguintes opções:
- Padrão: o Memorystore for Redis Cluster atualiza o cluster rotineiramente para garantir que o serviço seja confiável, eficiente, seguro e atualizado.
- Personalizado: você quer personalizar a programação de manutenção do cluster para se alinhar às necessidades do aplicativo e minimizar interrupções. Se você selecionar essa opção, especifique o dia em que quer que a manutenção ocorra e o horário em que quer que a janela de manutenção comece.
Clique em Criar cluster.
gcloud
Para criar uma instância de zona única, execute o comando create:
gcloud redis clusters create INSTANCE_ID \ --region=REGION_ID \ --network=NETWORK \ --replica-count=REPLICA_COUNT \ --node-type=NODE_TYPE \ --shard-count=SHARD_COUNT \ --zone-distribution-mode=ZONE_DISTRIBUTION_MODE \ --zone=ZONE \ --acl-policy=ACL_POLICY_NAME
Substitua:
INSTANCE_ID é o ID da instância do Memorystore for Redis Cluster 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 ID de rede usado pela política de conexão de serviço. Caso contrário, a operaçãocreatefalhará.REPLICA_COUNT é o número de réplicas (por fragmento). Os valores aceitos são
0-5.NODE_TYPE é o tipo de nó que você quer usar para o cluster.
SHARD_COUNT determina o número de fragmentos na instância. A contagem de fragmentos determina a capacidade total de memória para armazenar dados do cluster. Para mais informações sobre a especificação do cluster, consulte Especificação do cluster e do nó.
ZONE_DISTRIBUTION_MODE é o modo que permite escolher entre provisionar uma instância de zona única ou de várias zonas. O padrão é multizona. Os valores aceitos são
single-zoneemulti-zone.ZONE é a zona em que você quer provisionar os nós. Essa flag só será aplicável se você definir
--zone-distribution-modecomosingle-zone.ACL_POLICY_NAME é o nome da política de lista de controle de acesso (ACL) que você está atribuindo ao cluster que está criando. Ao usar políticas de ACL, é possível proteger o acesso ao cluster. É possível ativar a segurança refinada restringindo o acesso de usuários e serviços a chaves, comandos e canais do Pub/Sub específicos. Para mais informações, consulte Proteger o acesso aos clusters usando políticas de ACL.