View a markdown version of this page

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
Usar o Console de gerenciamento da AWSUsar o AWS CLIUsando a ElastiCache API

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

  1. Modifique o grupo de replicação para desativá-lo Multi-AZ (isso não exige que todos os seus 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 Multi-AZ reativá-lo.

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

Usar o 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 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 Valkey ou Redis OSS (modo de cluster desativado) onde Multi-AZ está habilitado, modifique o grupo de replicação para desativá-lo antes de continuar. Multi-AZ 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. Se o cluster foi Multi-AZ ativado antes de você iniciar o processo de promoção, aguarde até que o status do grupo de replicação esteja disponível e modifique o cluster para Multi-AZ reativá-lo. Para obter mais informações, consulte Modificação de um grupo de replicação.

Usar o AWS CLI

Você não pode promover uma réplica de leitura para primária se o grupo de replicação estiver Multi-AZ ativado. Em alguns casos, a réplica que você deseja promover pode ser membro de um grupo de replicação onde Multi-AZ está habilitada. Nesses casos, você deve modificar o grupo de replicação a ser desativado 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 se o grupo de replicação estiver Multi-AZ ativado. Em alguns casos, a réplica que você deseja promover pode ser membro de um grupo de replicação onde Multi-AZ está habilitada. Nesses casos, você deve modificar o grupo de replicação a ser desativado 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.