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á. # Adicionar nós a um ElastiCache cluster Adicionar nós a um cluster Memcached aumenta o número de partições do seu cluster. 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)](BestPractices.LoadBalancing.md). Para reconfigurar o cluster do Valkey ou Redis OSS (modo cluster habilitado), consulte [Escalabilidade de clusters no Valkey ou Redis OSS (modo cluster habilitado)](scaling-redis-cluster-mode-enabled.md) Você pode usar o ElastiCache Management Console AWS CLI ou a ElastiCache API para adicionar nós ao seu cluster. ## Usando o ElastiCache Console de gerenciamento da AWS 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](#AddReplication.CON) + [Para adicionar nós a um ElastiCache cluster (console)](#AddNode.CON) 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** 1. Faça login no Console de gerenciamento da AWS e abra o ElastiCache console em [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/). 1. 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. 1. 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)](#AddNode.CON). 1. Escolha **Add replication**. 1. Em **Adicionar replicação**, insira uma descrição para esse cluster habilitado para replicação. 1. 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. 1. Faça login no Console de gerenciamento da AWS e abra o ElastiCache console em [ https://console.aws.amazon.com/elasticache/](https://console.aws.amazon.com/elasticache/). 1. 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. 1. 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)](scaling-redis-cluster-mode-enabled.md). 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](#AddReplication.CON). 1. Escolha **Adicionar nó**. 1. Preencha as informações solicitadas na caixa de diálogo **Add Node (Adicionar nó)**. 1. 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** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/AmazonElastiCache/latest/dg/Clusters.AddNode.html) 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. 1. 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. ## Usando o AWS CLI com ElastiCache 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 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](Clusters.DeleteNode.md#Clusters.DeleteNode.CLI). + `--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 [https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-cache-cluster.html). ## Usando o AWS CLI com ElastiCache 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 do Valkey ou Redis OSS disponível (AWS CLI)](Replication.CreatingReplGroup.ExistingCluster.md#Replication.CreatingReplGroup.ExistingCluster.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 [https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html](https://docs.aws.amazon.com/cli/latest/reference/elasticache/increase-replica-count.html). ## Usando a ElastiCache API 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](Replication.CreatingReplGroup.ExistingCluster.md#Replication.CreatingReplGroup.ExistingCluster.API). 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. + `Region`Especifica 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. **Example** ``` 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= &X-Amz-Signature= ``` Para obter mais informações, consulte o tópico ElastiCache da API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_IncreaseReplicaCount.html). ## Usando a ElastiCache API **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 (consulte[Usando a ElastiCache API com o Memcached](Clusters.DeleteNode.md#Clusters.DeleteNode.API)). + `ApplyImmediately` Especifica se você deve adicionar esses nós imediatamente ou na próxima janela de manutenção. + `Region`Especifica 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. **Example** ``` 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= &X-Amz-Signature= ``` Para obter mais informações, consulte o tópico ElastiCache da API [https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyCacheCluster.html).