Adicionando nós a um ElastiCache cluster

Adicionar nós a um cluster do Memcached aumenta o número de partições dele. Quando você altera o número de partições em um cluster, alguns dos principais espaços precisam ser remapeados para que sejam mapeados para o nó direito. Remapear espaços de chave aumenta temporariamente o número de falhas de cache no cluster. Para obter mais informações, consulte Configurando seu ElastiCache cliente para balanceamento de carga eficiente (Memcached).

Para reconfigurar o cluster do Valkey ou Redis OSS (modo cluster habilitado), consulte Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado)

Você pode usar o ElastiCache Management Console AWS CLI ou a ElastiCache API para adicionar nós ao seu cluster.

Se você quiser adicionar um nó a um cluster do Valkey ou Redis OSS (modo cluster desabilitado) de nó único (sem replicação habilitada), o processo será de duas etapas: primeiro adicione a replicação e, depois, adicione um nó de réplica.

Tópicos

Para adicionar replicação a um cluster do Valkey ou Redis OSS sem fragmentos
Para adicionar nós a um ElastiCache cluster (console)

O procedimento a seguir adiciona replicação a um Valkey ou Redis OSS de nó único que não possui replicação habilitada. Quando você adiciona replicação, o nó existente torna-se o nó primário no cluster habilitado para replicação. Depois que a replicação é adicionada, você pode adicionar até 5 nós de réplica ao cluster.

Para adicionar replicação a um cluster do Valkey ou Redis OSS sem fragmentos

Faça login no AWS Management Console e abra o ElastiCache console em https://console.aws.amazon.com/elasticache/.
No painel de navegação, escolha Clusters do Valkey ou Clusters do Redis OSS.

Uma lista de clusters que executam o mecanismo Valkey ou Redis OSS é exibida.
Escolha o nome de um cluster (não a caixa à esquerda do nome do cluster) ao qual você quer adicionar nós.

O seguinte é verdade para um cluster do Redis OSS que não possui replicação habilitada:
- Ele está executando o Redis OSS, e não o Clustered Redis OSS.
- Tem zero estilhaços.
  
  Se o cluster tiver estilhaços, a replicação já estará ativada e você poderá continuar em Para adicionar nós a um ElastiCache cluster (console).
Escolha Add replication.
Em Adicionar replicação, insira uma descrição para esse cluster habilitado para replicação.
Escolha Adicionar.

Assim que o status do cluster retornar available, você poderá continuar no próximo procedimento e adicionar réplicas ao cluster.

Para adicionar nós a um ElastiCache cluster (console)

O procedimento a seguir pode ser usado para adicionar nós a um cluster.

Faça login no AWS Management Console e abra o ElastiCache console em https://console.aws.amazon.com/elasticache/.
No painel de navegação, escolha o mecanismo em execução no cluster ao qual você deseja adicionar nós.

É exibida uma lista de clusters que executam o mecanismo escolhido.
Na lista de clusters, no cluster ao qual você deseja adicionar um nó, escolha seu nome.

Se o cluster for um cluster do Valkey ou Redis OSS (modo cluster habilitado), consulte Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado).

Se o cluster é um cluster do Valkey ou Redis OSS (modo cluster desabilitado) com zero fragmentos, primeiro conclua as etapas em Para adicionar replicação a um cluster do Valkey ou Redis OSS sem fragmentos.
Escolha Adicionar nó.
Preencha as informações solicitadas na caixa de diálogo Add Node (Adicionar nó).

Escolha o botão Apply Immediately - Yes (Aplicar imediatamente - sim) para aplicar essa alteração imediatamente ou escolha No (Não) para adicionar este nó durante a próxima janela de manutenção do cluster.

Impacto de novas solicitações de adição e remoção em solicitações pendentes
Cenários	Operação pendente	Nova solicitação	Resultados
Cenário 1	Excluir	Excluir	A nova solicitação de exclusão, pendente ou imediata, substitui a solicitação de exclusão pendente. Por exemplo, se os nós 0001, 0003 e 0007 estiverem pendentes de exclusão e uma nova solicitação para excluir os nós 0002 e 0004 for emitida, somente os nós 0002 e 0004 serão excluídos. Os nós 0001, 0003 e 0007 não serão excluídos.
Cenário 2	Excluir	Criar	A nova solicitação de criação, pendente ou imediata, substitui a solicitação de exclusão pendente. Por exemplo, se os nós 0001, 0003 e 0007 estiverem pendentes de exclusão e uma nova solicitação para criar um nó for emitida, um novo nó será criado e os nós 0001, 0003 e 0007 não serão excluídos.
Cenário 3	Criar	Excluir	A nova solicitação de exclusão, pendente ou imediata, substitui a solicitação de criação pendente. Por exemplo, se houver uma solicitação pendente para criar dois nós e uma nova solicitação for emitida para excluir o nó 0003, nenhum novo nó será criado e o nó 0003 será excluído.
Cenário 4	Criar	Criar	A nova solicitação de criação é adicionada à solicitação de criação pendente. Por exemplo, se houver uma solicitação pendente para criar dois nós e uma nova solicitação for emitida para criar três nós, as novas solicitações serão adicionadas à solicitação pendente e cinco nós serão criados. Importante Se a nova solicitação de criação estiver definida como Apply immediately - Yes (Aplicar imediatamente - Sim), todas as solicitações de criação são executadas imediatamente. Se a nova solicitação de criação estiver definida como Apply immediately - No (Aplicar imediatamente - No), todas as solicitações de criação ficam pendentes.

Para determinar quais operações estão pendentes, escolha a opção Description (Descrição) e verifique para ver quantas criações ou exclusões pendentes são mostradas. Você não pode ter criações pendentes e exclusões pendentes.

Escolha o botão Add.

Depois de alguns momentos, os novos nós deverão aparecer na lista de nós com um status de creating. Se não aparecem, atualize a página do navegador. Quando o status mudar para available do nó do novo nó pode ser usado.

Para adicionar nós a um cluster usando o AWS CLI, use a AWS CLI operação modify-cache-cluster com os seguintes parâmetros:

--cache-cluster-id: o ID do cluster de cache ao qual você deseja adicionar os nós.
--num-cache-nodes: o parâmetro --num-cache-nodes especifica o número de nós que você deseja neste cluster após a modificação ser aplicada. Para adicionar nós a esse cluster, --num-cache-nodes deve ser maior que o número atual de nós neste cluster. Se esse valor for menor que o número atual de nós, ElastiCache espera que o parâmetro cache-node-ids-to-remove e uma lista de nós sejam removidos do cluster. Para obter mais informações, consulte Usando o AWS CLI com ElastiCache.
--apply-immediately ou --no-apply-immediately, que especifica se você deve adicionar esses nós imediatamente ou na próxima janela de manutenção.

Para Linux, macOS ou Unix:


aws elasticache modify-cache-cluster \
    --cache-cluster-id my-cluster \
    --num-cache-nodes 5 \
    --apply-immediately

Para Windows:


aws elasticache modify-cache-cluster ^
    --cache-cluster-id my-cluster ^
    --num-cache-nodes 5 ^
    --apply-immediately

Esta operação produz uma saída semelhante à seguinte (formato JSON):


{
    "CacheCluster": {
        "Engine": "memcached", 
        "CacheParameterGroup": {
            "CacheNodeIdsToReboot": [], 
            "CacheParameterGroupName": "default.memcached1.4", 
            "ParameterApplyStatus": "in-sync"
        }, 
        "CacheClusterId": "my-cluster", 
        "PreferredAvailabilityZone": "us-west-2b", 
        "ConfigurationEndpoint": {
            "Port": 11211, 
            "Address": "rlh-mem000.7alc7bf-example.cfg.usw2.cache.amazonaws.com"
        }, 
        "CacheSecurityGroups": [], 
        "CacheClusterCreateTime": "2016-09-21T16:28:28.973Z", 
        "AutoMinorVersionUpgrade": true, 
        "CacheClusterStatus": "modifying", 
        "NumCacheNodes": 2, 
        "ClientDownloadLandingPage": "https://console.aws.amazon.com/elasticache/home#client-download:", 
        "SecurityGroups": [
            {
                "Status": "active", 
                "SecurityGroupId": "sg-dbe93fa2"
            }
        ], 
        "CacheSubnetGroupName": "default", 
        "EngineVersion": "1.4.24", 
        "PendingModifiedValues": {
            "NumCacheNodes": 5
        }, 
        "PreferredMaintenanceWindow": "sat:09:00-sat:10:00", 
        "CacheNodeType": "cache.m3.medium",
         "DataTiering": "disabled",
    }
}

Para obter mais informações, consulte o AWS CLI tópico modify-cache-cluster.

Se quiser adicionar nós a um cluster existente do Valkey ou Redis OSS (modo cluster desabilitado) que não tenha a replicação habilitada, você deverá primeiro criar o grupo de replicação especificando o cluster existente como primário. Para obter mais informações, consulte Criação de um grupo de replicação usando um cluster de cache do Valkey ou Redis OSS disponível (AWS CLI). Depois que o grupo de replicação estiver disponível, você poderá continuar com o processo a seguir.

Para adicionar nós a um cluster usando o AWS CLI, use a AWS CLI operação increase-replica-count com os seguintes parâmetros:

--replication-group-id: o ID do grupo de replicação ao qual você deseja adicionar nós.
--new-replica-count: especifica o número de nós que você deseja neste grupo de replicação após a modificação ser aplicada. Para adicionar nós a esse cluster, --new-replica-count deve ser maior que o número atual de nós neste cluster.
--apply-immediately ou --no-apply-immediately, que especifica se você deve adicionar esses nós imediatamente ou na próxima janela de manutenção.

Para Linux, macOS ou Unix:


aws elasticache increase-replica-count \
    --replication-group-id my-replication-group \
    --new-replica-count 4 \
    --apply-immediately

Para Windows:


aws elasticache increase-replica-count ^
    --replication-group-id my-replication-group ^
    --new-replica-count 4 ^
    --apply-immediately

Esta operação produz uma saída semelhante à seguinte (formato JSON):


{
    "ReplicationGroup": {
        "ReplicationGroupId": "node-test",
        "Description": "node-test",       
        "Status": "modifying",
        "PendingModifiedValues": {},
        "MemberClusters": [
            "node-test-001",
            "node-test-002",
            "node-test-003",
            "node-test-004",
            "node-test-005"
        ],
        "NodeGroups": [
            {
                "NodeGroupId": "0001",
                "Status": "modifying",
                "PrimaryEndpoint": {
                    "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                    "Port": 6379
                },
                "ReaderEndpoint": {
                    "Address": "node-test.zzzzzz.ng.0001.usw2.cache.amazonaws.com",
                    "Port": 6379
                },
                "NodeGroupMembers": [
                    {
                        "CacheClusterId": "node-test-001",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "node-test-001.zzzzzz.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2a",
                        "CurrentRole": "primary"
                    },
                    {
                        "CacheClusterId": "node-test-002",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "node-test-002.zzzzzz.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2c",
                        "CurrentRole": "replica"
                    },
                    {
                        "CacheClusterId": "node-test-003",
                        "CacheNodeId": "0001",
                        "ReadEndpoint": {
                            "Address": "node-test-003.zzzzzz.0001.usw2.cache.amazonaws.com",
                            "Port": 6379
                        },
                        "PreferredAvailabilityZone": "us-west-2b",
                        "CurrentRole": "replica"
                    }
                ]
            }
        ],
        "SnapshottingClusterId": "node-test-002",
        "AutomaticFailover": "enabled",
        "MultiAZ": "enabled",
        "SnapshotRetentionLimit": 1,
        "SnapshotWindow": "07:30-08:30",
        "ClusterEnabled": false,
        "CacheNodeType": "cache.r5.large",
         "DataTiering": "disabled",
        "TransitEncryptionEnabled": false,
        "AtRestEncryptionEnabled": false,
        "ARN": "arn:aws:elasticache:us-west-2:123456789012:replicationgroup:node-test"
    }
}

Para obter mais informações, consulte o AWS CLI tópico increase-replica-count.

Se quiser adicionar nós a um cluster existente do Valkey ou Redis OSS (modo cluster desabilitado) que não tenha a replicação habilitada, você deverá primeiro criar o grupo de replicação especificando o cluster existente como primário. Para obter mais informações, consulte Adicionar réplicas a um cluster (API) autônomo Valkey ou Redis OSS (modo de cluster desativado) ElastiCache . Depois que o grupo de replicação estiver disponível, você poderá continuar com o processo a seguir.

Para adicionar nós a um cluster (ElastiCache API)

Chame a operação de API IncreaseReplicaCount com os seguintes parâmetros:
- ReplicationGroupId: o ID do cluster ao qual você deseja adicionar os nós.
- NewReplicaCount: o parâmetro NewReplicaCount especifica o número de nós que você deseja neste cluster após a modificação ser aplicada. Para adicionar nós a esse cluster, NewReplicaCount deve ser maior que o número atual de nós neste cluster. Se esse valor for inferior ao número atual de nós, use a API DecreaseReplicaCount com o número de nós a serem removidos do cluster.
- ApplyImmediately Especifica se você deve adicionar esses nós imediatamente ou na próxima janela de manutenção.
- RegionEspecifica a AWS região do cluster à qual você deseja adicionar nós.
O exemplo a seguir mostra uma chamada para adicionar nós a um cluster.
```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=IncreaseReplicaCount
    &ApplyImmediately=true
    &NumCacheNodes=4
    &ReplicationGroupId=my-replication-group
    &Region=us-east-2
    &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, consulte o tópico ElastiCache da API IncreaseReplicaCount.

Para adicionar nós a um cluster (ElastiCache API)

Chame a operação de API ModifyCacheCluster com os seguintes parâmetros:
- CacheClusterId: o ID do cluster ao qual você deseja adicionar os nós.
- NumCacheNodes: o parâmetro NumCachNodes especifica o número de nós que você deseja neste cluster após a modificação ser aplicada. Para adicionar nós a esse cluster, NumCacheNodes deve ser maior que o número atual de nós neste cluster. Se esse valor for menor que o número atual de nós, ElastiCache espera que o parâmetro CacheNodeIdsToRemove com uma lista de nós seja removido do cluster (consulteUsando a ElastiCache API com o Memcached).
- ApplyImmediately Especifica se você deve adicionar esses nós imediatamente ou na próxima janela de manutenção.
- RegionEspecifica a AWS região do cluster à qual você deseja adicionar nós.
O exemplo a seguir mostra uma chamada para adicionar nós a um cluster.
```
https://elasticache.us-west-2.amazonaws.com/
    ?Action=ModifyCacheCluster
    &ApplyImmediately=true
    &NumCacheNodes=5
	&CacheClusterId=my-cluster
	&Region=us-east-2
    &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, consulte o tópico ElastiCache da API ModifyCacheCluster.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Modificando um cluster ElastiCache

Removendo nós de um ElastiCache cluster

Adicionando nós a um ElastiCache cluster

Tópicos

Para adicionar replicação a um cluster do Valkey ou Redis OSS sem fragmentos

Para adicionar nós a um ElastiCache cluster (console)

Importante

Para adicionar nós a um cluster (ElastiCache API)

Para adicionar nós a um cluster (ElastiCache API)