Criação de um cluster do Valkey ou Redis OSS

Os exemplos a seguir mostram como criar um cluster do Valkey ou Redis OSS usando o Console de gerenciamento da AWS, a AWS CLI e a API do ElastiCache.

Criação de um cluster do Valkey ou Redis OSS (modo cluster desabilitado) (console)

O ElastiCache oferece suporte para replicação quando você usa o mecanismo Valkey ou Redis OSS. Para monitorar a latência entre quando os dados são gravados em um cluster primário de leitura/gravação do Valkey ou Redis OSS e quando ele é propagado para um cluster secundário somente leitura, o ElastiCache adiciona ao cluster uma chave especial, ElastiCacheMasterReplicationTimestamp. Essa chave é a hora em Tempo Universal Coordenado (UTC) atual. Como um cluster do Valkey ou Redis OSS pode ser adicionado a um grupo de replicação mais tarde, essa chave está incluída em todos os clusters do Valkey ou Redis OSS, mesmo que inicialmente eles não sejam membros de um grupo de replicação. Para obter mais informações sobre grupos de replicação, consulte Alta disponibilidade com o uso de grupos de replicação.

Para criar um cluster do Valkey ou Redis OSS (modo de cluster desabilitado), siga as etapas em Criação de um cluster do Valkey (modo cluster desabilitado) (console).

Assim que o status do seu cluster for available (disponível), você poderá conceder acesso ao Amazon EC2 a ele, conectar-se a ele e começar a usá-lo. Para obter mais informações, consulte Etapa 3. Autorizar o acesso ao cluster e Etapa 4: Conectar-se ao nó de um cluster.

Importante

Assim que seu cluster se tornar disponível, você será cobrado por cada hora ou hora parcial em que ele estiver ativo, mesmo que você não o esteja usando ativamente. Para interromper as cobranças aplicáveis para esse cluster, você deve excluí-lo. Consulte Exclusão de um cluster no ElastiCache.

Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)

Se você estiver executando o Redis OSS 3.2.4 ou posterior, será possível criar um cluster do Valkey ou Redis OSS (modo cluster habilitado). Clusters do Valkey ou Redis OSS (modo cluster habilitado) oferecem suporte para o particionamento dos seus dados entre 1 e 500 fragmentos (API/CLI: grupos de nós), mas com algumas limitações. Para obter uma comparação entre o Valkey ou Redis OSS (modo cluster desabilitado) e o Valkey ou Redis OSS (modo cluster habilitado), consulte Mecanismos e versões compatíveis.

Para criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) usando o console do ElastiCache

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon ElastiCache em https://console.aws.amazon.com/elasticache/.

2. Na lista localizada no canto superior direito, escolha a região da AWS na qual você deseja executar esse cluster.

3. No painel de navegação, escolha Get started (Conceitos básicos).

4. Escolha Create VPC (Criar VPC) e siga as etapas em Creating a Virtual Private Cloud (VPC) (Criação de uma nuvem privada virtual (VPC)).

5. Na página do painel do ElastiCache, escolha Criar cluster e, depois, escolha Criar um cluster do Valkey ou Criar um cluster do Redis OSS.

6. Em Cluster settings (Configurações do cluster), faça o seguinte:

   1. Selecione Configure and create a new cluster (Configurar e criar um novo cluster).

   2. Para o Cluster mode Modo cluster, escolhaEnabled (Habilitado).

   3. Para o Cluster info (Informações sobre o cluster), insira um valor para Name (Nome).

   4. (Opcional) Insira um valor para Description (Descrição).

7. Em Location (Local):

   AWS Cloud

   1. Para AWS Cloud (Nuvem), recomendamos que você aceite as configurações padrão de Multi-AZ e Failover automático. Para obter mais informações, consulte Minimização do tempo de inatividade no ElastiCache para Redis OSS com o multi-AZ.

   2. Em Cluster settings (Configurações do cluster)

      1. Em Engine version (Versão do mecanismo), escolha a versão do mecanismo.

      2. Em Port (Porta), use a porta padrão, 6379. Se você tiver um motivo para usar uma porta diferente, insira o número da porta.

      3. Em Grupo de parâmetro (Parameter group), escolha um grupo de parâmetro ou crie um novo. Os grupo de parâmetros controlam os parâmetros de tempo de execução do seu cluster. Para obter mais informações sobre grupo de parâmetros, consulte Parâmetros do Valkey e do Redis OSS e Criação de um grupo de parâmetros do ElastiCache.

         nota

         Quando você seleciona um grupo de parâmetros para definir os valores de configuração do mecanismo, esse grupo de parâmetros é aplicado a todos os clusters no datastore global. Na página Parameter Groups (Grupos de parâmetros), o atributo Global indica se um grupo de parâmetros faz parte de um datastore global.

      4. Para Node type (Tipo de nó), escolha a seta para baixo ( ). Na caixa de diálogo Change node type (Alterar tipo de nó), escolha um valor para a Instance family (Família de instâncias) para o tipo de nó desejado. Depois disso, escolha o tipo de nó que deseja usar para este cluster e escolha Save (Salvar).

         Para obter mais informações, consulte Escolha do tamanho do nó.

         Se você escolher um tipo de nó r6gd, a classificação de dados em níveis será ativada automaticamente. Para obter mais informações, consulte Classificação de dados em níveis no ElastiCache.

      5. Em Número de fragmentos, escolha o número de fragmentos (partições/grupos de nós) desejado para este cluster do Valkey ou Redis OSS (modo cluster habilitado).

         Para algumas versões do Valkey ou Redis OSS (modo cluster habilitado), é possível alterar dinamicamente o número de fragmentos no cluster:

         • Redis OSS 3.2.10 e posteriores: se o cluster estiver executando o Redis OSS 3.2.10 ou versões posteriores, será possível alterar dinamicamente o número de fragmentos no cluster. Para obter mais informações, consulte Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado).

         • Outras versões do Redis OSS: se o cluster estiver executando uma versão do Redis OSS anterior à versão 3.2.10, há outra abordagem. Para alterar o número de fragmentos no cluster nesse caso, crie um novo cluster com o novo número de fragmentos. Para obter mais informações, consulte Restauração de um backup para um novo cache.

      6. Em Réplicas por fragmento, escolha o número de nós de réplica de leitura desejados em cada fragmento.

         As restrições a seguir existem para o Valkey ou Redis OSS (modo cluster habilitado).

         • Se você tiver o Multi-AZ habilitado, verifique se tem pelo menos uma réplica por fragmento.

         • O número de réplicas é o mesmo para cada fragmento ao criar o cluster usando o console.

         • O número de réplicas de leitura por fragmento é fixo e não pode ser alterado. Se você achar que precisa de mais ou menos réplicas por fragmento (API/CLI: grupo de nós), deverá criar um novo cluster com o novo número de réplicas. Para obter mais informações, consulte Tutorial: propagação de um novo cluster baseado em nós com um backup criado externamente.

   3. Em Connectivity (Conectividade)

      1. Em Network type (Tipo de rede), escolha as versões de IP compatíveis com esse cluster.

      2. Em Subnet groups (Grupo de sub-redes), escolha a sub-rede que você deseja aplicar a esse cluster. O ElastiCache usa esse grupo de sub-redes para escolher uma sub-rede e endereços IP dentro dessa sub-rede para associar aos seus nós. Os clusters do ElastiCache exigem uma sub-rede de pilha dupla com endereços IPv4 e IPv6 atribuídos a eles para operar no modo de pilha dupla e uma sub-rede somente IPv6 para operar somente como IPv6.

         Ao criar um novo grupo de sub-rede, insira o VPC ID (ID da VPC) ao qual ele pertence.

         Selecione um Discovery IP type (Tipo de IP de descoberta). Somente os endereços IP do protocolo escolhido são retornados.

         Para obter mais informações, consulte:

         • Escolha de um tipo de rede no ElastiCache.

         • Criar uma sub-rede na VPC.

         Se você for Uso de zonas locais com o ElastiCache, deverá criar ou escolher uma sub-rede que esteja na região local.

         Para obter mais informações, consulte Sub-redes e grupos de sub-redes.

   4. Em Availability zone placements (Posicionamentos de zona de disponibilidade), você tem duas opções:

      • No preference (Sem preferência): o ElastiCache escolhe a zona de disponibilidade.

      • Specify availability zones (Especificar zonas de disponibilidade): você especifica a zona de disponibilidade para cada cluster.

        Se optar por especificar as zonas de disponibilidade, para cada cluster em cada fragmento, escolha a zona de disponibilidade na lista.

      Para obter mais informações, consulte Seleção de regiões e zonas de disponibilidade para o ElastiCache.

   5. Escolha Next (Próximo)

   6. Em Configurações avançadas do Valkey ou Configurações avançadas do Redis OSS ou

      1. Para Security (Segurança):

         1. Para criptografar seus dados, você tem as seguintes opções:

            • Criptografia em repouso: permite a criptografia de dados armazenados em disco. Para obter mais informações, consulte Criptografia em repouso.

              nota

              Você tem a opção de fornecer uma chave de criptografia diferente, escolhendo Customer Managed KMS key (Chave do AWS KMS gerenciada pelo cliente) e escolhendo a chave. Para obter mais informações, consulte Usar chaves gerenciadas pelo cliente do AWS KMS.

            • Encryption in-transit (Criptografia em trânsito): permite a criptografia de dados na conexão. Para obter mais informações, consulte criptografia em trânsito. Para o Valkey 7.2 e posteriores ou Redis OSS 6.0 e posteriores, se você habilitar a Criptografia em trânsito, você será solicitado a especificar uma das seguintes opções de Controle de acesso:

              • No Access Control (Sem controle de acesso): essa é a configuração padrão. Isso indica que não há restrições no acesso do usuário ao cluster.

              • User Group Access Control List (Lista de controle de acesso de grupo de usuários): selecione um grupo de usuários com um conjunto definido de usuários que possam acessar o cluster. Para obter mais informações, consulte Gerenciamento de grupos de usuários com o console e a CLI.

              • Usuário padrão AUTH: um mecanismo de autenticação para um servidor Valkey ou Redis OSS. Para obter mais informações, consulte AUTH.

            • AUTH: um mecanismo de autenticação para servidores Valkey ou Redis OSS. Para obter mais informações, consulte AUTH.

            nota

            Para versões do Redis OSS 3.2.6 e posteriores, excluindo a versão 3.2.10, o AUTH é a única opção.

         2. Em Grupos de segurança, escolha os grupos de segurança desejados para esse cluster. Um grupo de segurança atua como um firewall para controlar o acesso à rede ao cluster. É possível usar o grupo de segurança padrão para sua VPC ou criar um novo.

            Para obter mais informações sobre grupos de segurança, consulte Grupos de segurança para sua VPC no Guia do usuário da Amazon VPC.

   7. Para backups automáticos agendados regularmente, selecione Enable automatic backups (Habilitar backups automáticos) e insira o número de dias que deseja que cada backup automático seja mantido antes de ser excluído automaticamente. Se não quiser backups automáticos agendados regularmente, desmarque a caixa de seleção Enable automatic backups (Habilitar backups automáticos). Em ambos os casos, você sempre tem a opção de criar backups manuais.

      Para obter mais informações sobre backup e restauração, consulte Snapshots e restauração.

   8. (Opcional) Especifique uma janela de manutenção. A maintenance window (janela de manutanção) é o tempo, geralmente uma hora de duração, a cada semana quando o ElastiCache programa a manutenção do sistema para seu cluster. É possível permitir que o ElastiCache escolha o dia e a hora da sua janela de manutenção (No preference (Sem preferência)) ou é possível escolher o dia, a hora e a duração por conta própria (Specify maintenance window (Especificar janela de manutenção)). Se você escolher Especificar janela de manutenção, nas listas, escolha Dia de início, Hora de início e Duração (em horas) para sua janela de manutenção. Todos os horários são em UCT.

      Para obter mais informações, consulte Gerenciamento de manutenção de cluster do ElastiCache.

   9. (Opcional) Para Logs:

      • Em Log format (Formato do log), escolha Text (Texto) ou JSON.

      • Em Destination Type (Tipo de destino), escolha CloudWatch Logs (Logs do CloudWatch) ou Kinesis Firehose.

      • Em Destino do log, escolha Criar novo e insira o nome do grupo de logs do CloudWatch Logs ou o nome do stream do Firehose, ou escolha Selecionar existente e escolha o nome do grupo de logs do CloudWatch Logs ou o nome do stream do Firehose,

   10. Em tags, para ajudar você a gerenciar seus clusters e outros recursos do ElastiCache, é possível atribuir seus próprios metadados a cada recurso na forma de tags. Para obter mais informações, consulte Marcação de recursos do ElastiCache.

   11. Escolha Next (Próximo).

   12. Revise todas as suas entradas e opções e faça as correções necessárias. Quando estiver pronto, escolha Create (Criar).

   On premises

   1. Para On-premises, recomendamos que você deixe Auto-failover (Failover automático) habilitado. Para obter mais informações, consulte Minimização do tempo de inatividade no ElastiCache para Redis OSS com o multi-AZ

   2. Siga as etapas em Uso do Outposts.

Para criar o equivalente usando a API do ElastiCache ou a AWS CLI em vez do console do ElastiCache, consulte:

• API: CreateReplicationGroup

• CLI: create-replication-group

Assim que o status do seu cluster for available, você poderá conceder acesso ao EC2 a ele, conectar-se a ele e começar a usá-lo. Para obter mais informações, consulte Etapa 3. Autorizar o acesso ao cluster e Etapa 4: Conectar-se ao nó de um cluster.

Importante

Assim que seu cluster se tornar disponível, você será cobrado por cada hora ou hora parcial em que ele estiver ativo, mesmo que você não o esteja usando ativamente. Para interromper as cobranças aplicáveis para esse cluster, você deve excluí-lo. Consulte Exclusão de um cluster no ElastiCache.

Criar um cluster (AWS CLI)

Para criar um cluster usando a AWS CLI, use o comando create-cache-cluster.

Importante

Assim que seu cluster se tornar disponível, você será cobrado por cada hora ou hora parcial em que ele estiver ativo, mesmo que você não o esteja usando ativamente. Para interromper as cobranças aplicáveis para esse cluster, você deve excluí-lo. Consulte Exclusão de um cluster no ElastiCache.

Criação de um cluster do Valkey ou Redis OSS (modo cluster desabilitado) (CLI)

exemplo – Um cluster do Valkey ou Redis OSS (modo cluster desabilitado) sem réplicas de leitura

O código da CLI a seguir cria um cluster do Valkey ou Redis OSS (modo cluster desabilitado) sem réplicas.

nota

Ao criar cluster usando um tipo de nó da família r6gd, é necessário repassar o parâmetro data-tiering-enabled.

Para Linux, macOS ou Unix:

aws elasticache create-cache-cluster \
--cache-cluster-id my-cluster \
--cache-node-type cache.r4.large \
--engine redis \
--num-cache-nodes 1 \
--cache-parameter-group default.redis6.x \
--snapshot-arns arn:aws:s3:::amzn-s3-demo-bucket/snapshot.rdb

Para Windows:

aws elasticache create-cache-cluster ^
--cache-cluster-id my-cluster ^
--cache-node-type cache.r4.large ^
--engine redis ^
--num-cache-nodes 1 ^
--cache-parameter-group default.redis6.x ^
--snapshot-arns arn:aws:s3:::amzn-s3-demo-bucket/snapshot.rdb

Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (AWS CLI)

Clusters do Valkey ou Redis OSS (modo cluster habilitado) (API/CLI: grupos de replicação) não podem ser criados usando a operação create-cache-cluster. Para criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) (API/CLI: grupo de replicação), consulte Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início (AWS CLI).

Para obter mais informações, consulte a AWS CLI para o tópico de referência do ElastiCache create-replication-group.

Criação de um cluster do Valkey ou Redis OSS (API do ElastiCache)

Para criar um cluster usando a API do ElastiCache, use a ação CreateCacheCluster.

Importante

Assim que seu cluster se tornar disponível, você será cobrado por cada hora ou hora parcial em que ele estiver, mesmo que você não o esteja usando. Para interromper as cobranças aplicáveis para esse cluster, você deve excluí-lo. Consulte Exclusão de um cluster no ElastiCache.

Criação de um cluster do Valkey ou Redis OSS (modo cluster desabilitado) (API do ElastiCache)

O código a seguir cria um cluster do Valkey ou Redis OSS (modo cluster desabilitado) (API do ElastiCache).

As quebras de linha foram adicionadas para legibilidade.

https://elasticache.us-west-2.amazonaws.com/
    ?Action=CreateCacheCluster
    &CacheClusterId=my-cluster
    &CacheNodeType=cache.r4.large
    &CacheParameterGroup=default.redis3.2
    &Engine=redis
    &EngineVersion=3.2.4
    &NumCacheNodes=1
    &SignatureVersion=4       
    &SignatureMethod=HmacSHA256
    &SnapshotArns.member.1=arn%3Aaws%3As3%3A%3A%3AmyS3Bucket%2Fdump.rdb
    &Timestamp=20150508T220302Z
    &Version=2015-02-02
    &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
    &X-Amz-Credential=<credential>
    &X-Amz-Date=20150508T220302Z
    &X-Amz-Expires=20150508T220302Z
    &X-Amz-SignedHeaders=Host
    &X-Amz-Signature=<signature>

Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (API do ElastiCache)

Clusters do Valkey ou Redis OSS (modo cluster habilitado) (API/CLI: grupos de replicação) não podem ser criados usando a operação CreateCacheCluster. Para criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) (API/CLI: grupo de replicação), consulte Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início (API do ElastiCache).

Para obter mais informações, consulte o tópico de referência da API do ElastiCache CreateReplicationGroup.