Aumento do número de réplicas em um fragmento - Amazon ElastiCache
Usando o AWS Management ConsoleUsando 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á.

Aumento do número de réplicas em um fragmento

Você pode aumentar o número de réplicas em um fragmento do Valkey ou Redis OSS (modo cluster habilitado) ou grupo de replicação do Valkey ou Redis OSS (modo cluster desabilitado) até um máximo de cinco. Você pode fazer isso usando a AWS Management Console AWS CLI, a ou a ElastiCache API.

Usando o AWS Management Console

O procedimento a seguir usa o console para aumentar o número de réplicas em um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado).

Para aumentar o número de réplicas em fragmentos

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

  2. No painel de navegação, escolha Valkey ou Redis OSS e o nome do grupo de replicação ao qual você deseja adicionar réplicas.

  3. Escolha a caixa de cada estilhaço a que você deseja adicionar réplicas.

  4. Escolha Add replicas (Adicionar réplicas).

  5. Conclua a página Add Replicas to Shards (Adicionar réplicas a estilhaços):

    • Em New number of replicas/shard (Novo número de réplicas/estilhaço), informe o número de réplicas que todos os estilhaços selecionados devem ter. Esse valor deve ser maior que ou igual a Current Number of Replicas per shard (Número atual de réplicas por estilhaço) e menor que ou igual a cinco. Recomendamos pelo menos duas réplicas para trabalho mínimo.

    • Para Zonas de disponibilidade, escolha Sem preferência para ElastiCache escolher uma zona de disponibilidade para cada nova réplica ou Especificar zonas de disponibilidade para escolher uma zona de disponibilidade para cada nova réplica.

      Caso você escolha Specify Availability Zones (Especificar zonas de disponibilidade), para cada nova réplica, especifique uma zona de disponibilidade usando a lista.

  6. Escolha Add (Adicionar) a fim de adicionar as réplicas ou Cancel (Cancelar) a fim de cancelar a operação.

Usando o AWS CLI

Para aumentar o número de réplicas em um fragmento do Valkey ou Redis OSS, use o comando increase-replica-count com os seguintes parâmetros:

  • --replication-group-id: obrigatório. Identifica em qual grupo de replicação você deseja aumentar o número de réplicas.

  • --apply-immediately ou --no-apply-immediately: obrigatório. Especifica se é necessário aumentar a contagem de réplicas imediatamente (--apply-immediately) ou na próxima janela de manutenção (--no-apply-immediately). Atualmente, --no-apply-immediately não é suportado.

  • --new-replica-count: optional. Especifica o número de nós de réplica que você deseja concluir, até um máximo de cinco. Use este parâmetro em grupos de replicação do Valkey ou do Redis OSS (modo cluster desabilitado) nos quais haja apenas um grupo de nós ou o grupo do Valkey ou do Redis OSS (modo cluster habilitado), ou onde você deseja que todos os grupos de nós tenham o mesmo número de réplicas. Caso esse valor não seja maior que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.

  • --replica-configuration: optional. Permite definir o número de réplicas e as zonas de disponibilidade de cada grupo de nós independentemente. Use este parâmetro em grupos do Valkey ou Redis OSS (modo cluster habilitado) onde você deseja configurar cada grupo de nós independentemente.

    --replica-configuration tem três membros opcionais:

    • NodeGroupId: o ID de quatro dígitos do grupo de nós que você está configurando. Para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado), o ID de fragmento é sempre 0001. Para encontrar o ID de um grupo de nós (fragmento) do Valkey ou Redis OSS (modo cluster habilitado), consulte Localização de um ID de fragmento.

    • NewReplicaCount: o número de réplicas que você deseja nesse grupo de nós ao final desta operação. O valor deve ser maior que o número atual de réplicas, até um máximo de cinco. Caso esse valor não seja maior que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.

    • PreferredAvailabilityZones: uma lista de strings de PreferredAvailabilityZone que especificam em quais zonas de disponibilidade os nós do grupo de replicação devem estar. O número de valores PreferredAvailabilityZone deve ser igual ao valor de NewReplicaCount mais 1 para contabilizar o nó primário. Se esse membro do --replica-configuration for omitido, ElastiCache para Redis, o OSS escolhe a Zona de Disponibilidade para cada uma das novas réplicas.

Importante

Você deve incluir o parâmetro --new-replica-count ou --replica-configuration, mas não ambos, na chamada.

O exemplo a seguir aumenta o número de réplicas no grupo de replicação sample-repl-group para três. Quando o exemplo é concluído, existem três réplicas em cada grupo de nós. Esse número se aplica caso este seja um grupo do Valkey ou Redis OSS (modo cluster desabilitado) com um grupo de nós único ou um grupo do Valkey ou Redis OSS (modo cluster habilitado) com vários grupos de nós.

Para Linux, macOS ou Unix:

aws elasticache increase-replica-count \
    --replication-group-id sample-repl-group \
    --new-replica-count 3 \
    --apply-immediately

Para Windows:

aws elasticache increase-replica-count ^
    --replication-group-id sample-repl-group ^
    --new-replica-count 3 ^
    --apply-immediately

O exemplo a seguir aumenta o número de réplicas no grupo de replicação sample-repl-group para o valor especificado para os dois grupos de nós especificados. Como há vários grupos de nós, este é um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Durante a especificação do PreferredAvailabilityZones opcional, o número de zonas de disponibilidade listadas deve ser igual ao valor de NewReplicaCount mais 1. Essa abordagem contabiliza o nó primário do grupo identificado por NodeGroupId.

Para Linux, macOS ou Unix:

aws elasticache increase-replica-count \
    --replication-group-id sample-repl-group \
    --replica-configuration \
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c,us-east-1b \
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c,us-east-1c \
    --apply-immediately

Para Windows:

aws elasticache increase-replica-count ^
    --replication-group-id sample-repl-group ^
    --replica-configuration ^
        NodeGroupId=0001,NewReplicaCount=2,PreferredAvailabilityZones=us-east-1a,us-east-1c,us-east-1b ^
        NodeGroupId=0003,NewReplicaCount=3,PreferredAvailabilityZones=us-east-1a,us-east-1b,us-east-1c,us-east-1c \
    --apply-immediately

Para obter mais informações sobre como aumentar o número de réplicas usando a CLI, increase-replica-countconsulte a Referência da Linha de Comando da ElastiCache Amazon.

Usando a ElastiCache API

Para aumentar o número de réplicas em um fragmento do Valkey ou Redis OSS, use a ação IncreaseReplicaCount com os seguintes parâmetros:

  • ReplicationGroupId: obrigatório. Identifica em qual grupo de replicação você deseja aumentar o número de réplicas.

  • ApplyImmediately: obrigatório. Especifica se é necessário aumentar a contagem de réplicas imediatamente (ApplyImmediately=True) ou na próxima janela de manutenção (ApplyImmediately=False). Atualmente, ApplyImmediately=False não é suportado.

  • NewReplicaCount: optional. Especifica o número de nós de réplica que você deseja concluir, até um máximo de cinco. Use este parâmetro em grupos de replicação do Valkey ou do Redis OSS (modo cluster desabilitado) nos quais haja apenas um grupo de nós, ou grupos do Valkey ou do Redis OSS (modo cluster habilitado) onde você deseja que todos os grupos de nós tenham o mesmo número de réplicas. Caso esse valor não seja maior que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.

  • ReplicaConfiguration: optional. Permite definir o número de réplicas e as zonas de disponibilidade de cada grupo de nós independentemente. Use este parâmetro em grupos do Valkey ou Redis OSS (modo cluster habilitado) onde você deseja configurar cada grupo de nós independentemente.

    ReplicaConfiguraion tem três membros opcionais:

    • NodeGroupId: o ID de quatro dígitos do grupo de nós que você está configurando. Para grupos de replicação do Valkey ou Redis OSS (modo cluster desabilitado), o ID do grupo de nós (fragmento) é sempre 0001. Para encontrar o ID de um grupo de nós (fragmento) do Valkey ou Redis OSS (modo cluster habilitado), consulte Localização de um ID de fragmento.

    • NewReplicaCount: o número de réplicas que você deseja nesse grupo de nós ao final desta operação. O valor deve ser maior que o número atual de réplicas e um máximo de cinco. Caso esse valor não seja maior que o número atual de réplicas no grupo de nós, a chamada falha com uma exceção.

    • PreferredAvailabilityZones: uma lista de strings de PreferredAvailabilityZone que especificam em quais zonas de disponibilidade os nós do grupo de replicação devem estar. O número de valores PreferredAvailabilityZone deve ser igual ao valor de NewReplicaCount mais 1 para contabilizar o nó primário. Se esse membro do ReplicaConfiguration for omitido, ElastiCache para Redis, o OSS escolhe a Zona de Disponibilidade para cada uma das novas réplicas.

Importante

Você deve incluir o parâmetro NewReplicaCount ou ReplicaConfiguration, mas não ambos, na chamada.

O exemplo a seguir aumenta o número de réplicas no grupo de replicação sample-repl-group para três. Quando o exemplo é concluído, existem três réplicas em cada grupo de nós. Esse número se aplica caso este seja um grupo do Valkey ou Redis OSS (modo cluster desabilitado) com um grupo de nós único, ou um grupo do Valkey ou Redis OSS (modo cluster habilitado) com vários grupos de nós.

https://elasticache.us-west-2.amazonaws.com/
      ?Action=IncreaseReplicaCount
      &ApplyImmediately=True
      &NewReplicaCount=3
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

O exemplo a seguir aumenta o número de réplicas no grupo de replicação sample-repl-group para o valor especificado para os dois grupos de nós especificados. Como há vários grupos de nós, este é um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Durante a especificação do PreferredAvailabilityZones opcional, o número de zonas de disponibilidade listadas deve ser igual ao valor de NewReplicaCount mais 1. Essa abordagem contabiliza o nó primário do grupo identificado por NodeGroupId.

https://elasticache.us-west-2.amazonaws.com/
      ?Action=IncreaseReplicaCount
      &ApplyImmediately=True
      &ReplicaConfiguration.ConfigureShard.1.NodeGroupId=0001
      &ReplicaConfiguration.ConfigureShard.1.NewReplicaCount=2
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1c
      &ReplicaConfiguration.ConfigureShard.1.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.NodeGroupId=0003
      &ReplicaConfiguration.ConfigureShard.2.NewReplicaCount=3
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.1=us-east-1a
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.2=us-east-1b
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.3=us-east-1c
      &ReplicaConfiguration.ConfigureShard.2.PreferredAvailabilityZones.PreferredAvailabilityZone.4=us-east-1c
      &ReplicationGroupId=sample-repl-group
      &Version=2015-02-02
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20150202T192317Z
      &X-Amz-Credential=<credential>

Para obter mais informações sobre como aumentar o número de réplicas usando a API, consulte IncreaseReplicaCounta Amazon ElastiCache API Reference.