Adição de nós a um 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 ter mais informações, consulte Configuração do seu cliente do ElastiCache para balanceamento de carga eficiente.

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

Usando o AWS Management Console

Tópicos

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

Para adicionar nós a um cluster (console)

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

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 o mecanismo em execução no cluster ao qual você deseja adicionar nós.

   É exibida uma lista de clusters que executam o mecanismo escolhido.

3. Na lista de clusters, no cluster ao qual você deseja adicionar um nó, escolha seu nome.

4. Escolha Adicionar nó.

5. Preencha as informações solicitadas na caixa de diálogo Add Node (Adicionar nó).

6. 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	Delete	Delete	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	Delete	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	Delete	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.

7. 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

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 ter mais informações, consulte Usar a AWS 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",
         
    }
}

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

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 (consulteUso da API do ElastiCache).

  • 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.