Promoção de uma réplica de leitura a primário, para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado) - Amazon ElastiCache
Utilização do Console de gerenciamento da AWSUsar a AWS CLIUso da API do ElastiCache

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Promoção de uma réplica de leitura a primário, para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado)

As informações no tópico a seguir só se aplicam a grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado).

Você pode promover uma réplica de leitura de um cluster do Valkey ou Redis OSS (modo cluster desabilitado) a primário usando o Console de gerenciamento da AWS, a AWS CLI ou a API do ElastiCache. Você não pode promover uma réplica de leitura para primária enquanto Multi-AZ com failover automático estiver habilitado no grupo de replicação . Para promover uma réplica do Valkey ou Redis OSS (modo cluster desabilitado) para primário em um grupo de replicação habilitado para multi-AZ, faça o seguinte:

  1. Modifique o grupo de replicação para desabilitar Multi-AZ (isso não requer que todos os clusters estejam na mesma zona de disponibilidade). Para obter mais informações, consulte Modificação de um grupo de replicação.

  2. Promova a réplica de leitura para primário.

  3. Modifique o grupo de replicação para reabilitar o Multi-AZ.

O Multi-AZ não está disponível em grupos de replicação que executam o Valkey ou Redis OSS 2.6.13 ou anterior.

Utilização do Console de gerenciamento da AWS

O procedimento a seguir usa o console para promover um nó de réplica para primária.

Para promover uma réplica de leitura para primário (console)

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

  2. Se a réplica que você quiser promover for membro de um grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) em que o multi-AZ estiver habilitado, modifique o grupo de replicação para desabilitar o multi-AZ para continuar. Para obter mais informações, consulte Modificação de um grupo de replicação.

  3. Escolha Valkey ou Redis OSS, na lista de clusters, escolha o grupo de replicação que você deseja modificar. Esse grupo de replicação deve estar executando o mecanismo "Redis", e não o mecanismo "Clustered Redis", e deve ter dois ou mais nós.

  4. Na lista de nós, escolha o nó de réplica que você deseja promover para primária, em Actions (Ações), escolha Promote (Promover).

  5. Na caixa de diálogo Promote Read Replica (Promover réplica de leitura), faça o seguinte:

    1. Em Apply Immediately (Aplicar imediatamente), escolha Yes (Sim) para promover a réplica de leitura imediatamente, ou No (Não) para promovê-la na próxima janela de manutenção do cluster.

    2. Escolha Promote para promover a réplica de leitura ou Cancel para cancelar a operação.

  6. Caso o cluster tenha Multi-AZ habilitado antes de você começar o processo de promoção, aguarde o status do grupo de replicação estar available (disponível), modifique o cluster para reabilitar Multi-AZ. Para obter mais informações, consulte Modificação de um grupo de replicação.

Usar a AWS CLI

Você não pode promover uma réplica de leitura para primária caso o grupo de replicação esteja habilitado para Multi-AZ. Em alguns casos, a réplica que você deseja promover pode ser um membro de um grupo de replicação onde o recurso do Multi-AZ está habilitado. Nesses casos, você deve modificar o grupo de replicação para desabilitar o recurso do Multi-AZ antes de continuar. Isso não requer que todos os clusters estejam na mesma zona de disponibilidade. Para obter mais informações sobre como modificar um grupo de replicação, consulte Modificação de um grupo de replicação.

O seguinte comando AWS CLI modifica o grupo de replicação sample-repl-group, tornando a réplica de leitura my-replica-1 o primário no grupo de replicação.

Para Linux, macOS ou Unix:

aws elasticache modify-replication-group \
   --replication-group-id sample-repl-group \
   --primary-cluster-id my-replica-1

Para Windows:

aws elasticache modify-replication-group ^
   --replication-group-id sample-repl-group ^
   --primary-cluster-id my-replica-1

Para obter mais informações sobre como modificar um grupo de replicação, consulte modify-replication-group na Referência da linha de comando do Amazon ElastiCache.

Uso da API do ElastiCache

Você não pode promover uma réplica de leitura para primária caso o grupo de replicação esteja habilitado para Multi-AZ. Em alguns casos, a réplica que você deseja promover pode ser um membro de um grupo de replicação onde o recurso do Multi-AZ está habilitado. Nesses casos, você deve modificar o grupo de replicação para desabilitar o recurso do Multi-AZ antes de continuar. Isso não requer que todos os clusters estejam na mesma zona de disponibilidade. Para obter mais informações sobre como modificar um grupo de replicação, consulte Modificação de um grupo de replicação.

A seguinte ação da API do ElastiCache modifica o grupo de replicação myReplGroup, tornando a réplica de leitura myReplica-1 o primário no grupo de replicação.

https://elasticache.us-west-2.amazonaws.com/
   ?Action=ModifyReplicationGroup
   &ReplicationGroupId=myReplGroup
   &PrimaryClusterId=myReplica-1  
   &Version=2014-12-01
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20141201T220302Z
   &X-Amz-Algorithm=&AWS;4-HMAC-SHA256
   &X-Amz-Date=20141201T220302Z
   &X-Amz-SignedHeaders=Host
   &X-Amz-Expires=20141201T220302Z
   &X-Amz-Credential=<credential>
   &X-Amz-Signature=<signature>

Para obter mais informações sobre como modificar um grupo de replicação, consulte ModifyReplicationGroup na Referência da API do Amazon ElastiCache.