Promovendo uma réplica de leitura para primária, para grupos de replicação do Redis OSS (modo de cluster desativado)

As informações no tópico a seguir se aplicam somente aos grupos de replicação do Redis OSS (modo de cluster desativado).

Você pode promover uma réplica de leitura do Redis OSS (modo de cluster desativado) para primária usando a AWS Management Console, a ou a AWS CLI API. ElastiCache Você não pode promover uma réplica de leitura para primária enquanto o Multi-AZ com failover automático estiver ativado no grupo de replicação Redis OSS (modo de cluster desativado). Para promover uma réplica do Redis OSS (modo de cluster desativado) como primária 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 ter 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 Redis OSS 2.6.13 ou anterior.

Usando o AWS Management Console

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 AWS Management Console e abra o ElastiCache console em https://console.aws.amazon.com/elasticache/.

2. Se a réplica que você deseja promover for membro de um grupo de replicação do Redis OSS (modo de cluster desativado) em que o Multi-AZ esteja habilitado, modifique o grupo de replicação para desabilitar o Multi-AZ antes de continuar. Para ter mais informações, consulte Modificação de um grupo de replicação.

3. Escolha Redis OSS e, 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 ter mais informações, consulte Modificação de um grupo de replicação.

Usando o 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 AWS CLI comando a seguir modifica o grupo de replicaçãosample-repl-group, tornando a réplica de leitura my-replica-1 a principal 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 a modificação de um grupo de replicação, consulte a Referência da Linha modify-replication-group de ElastiCache Comando da Amazon.

Usando a ElastiCache API

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 ação de ElastiCache API a seguir modifica o grupo de replicaçãomyReplGroup, tornando a réplica de leitura myReplica-1 a principal 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 a modificação de um grupo de replicação, consulte ModifyReplicationGroup a Amazon ElastiCache API Reference.