Alteração do número de réplicas - Amazon MemoryDB
Aumentar o número de réplicasDiminuir o número de réplicas

Alteração do número de réplicas

Você pode aumentar ou diminuir dinamicamente o número de réplicas de leitura no cluster do MemoryDB usando o AWS Management Console, a AWS CLI ou a API do MemoryDB. Todos os fragmentos devem ter o mesmo número de réplicas.

Aumentar o número de réplicas em um cluster

Você pode aumentar o número de réplicas em um cluster do MemoryDB até um máximo de cinco fragmentos. Você pode fazer isso usando o AWS Management Console, a AWS CLI ou a API do MemoryDB.

Uso do AWS Management Console

Para aumentar o número de réplicas em um cluster do MemoryDB (console), consulte Adição e Remoção de nós de um cluster.

Uso do AWS CLI

Para aumentar o número de réplicas em um cluster do MemoryDB, use o comando update-cluster com os seguintes parâmetros:

  • --cluster-name – obrigatório. Identifica em qual cluster você deseja aumentar o número de réplicas.

  • --replica-configuration – obrigatório. Permite que você defina o número de réplicas. Para aumentar a contagem de réplicas, defina a propriedade ReplicaCount para o número de réplicas que você deseja nesse fragmento ao final desta operação.

O exemplo a seguir aumenta o número de réplicas no cluster my-cluster para dois.

Para Linux, macOS ou Unix:

aws memorydb update-cluster \
    --cluster-name my-cluster \
    --replica-configuration \
        ReplicaCount=2

Para Windows:

aws memorydb update-cluster ^
    --cluster-name my-cluster ^
    --replica-configuration ^
        ReplicaCount=2

Retorna a seguinte resposta em JSON:

{
    "Cluster": {
        "Name": "my-cluster",
        "Status": "updating",
        "NumberOfShards": 1,
        "ClusterEndpoint": {
            "Address": "clustercfg.my-cluster.xxxxx.memorydb.us-east-1.amazonaws.com",
            "Port": 6379
        },
        "NodeType": "db.r6g.large",
        "EngineVersion": "6.2",
        "EnginePatchVersion": "6.2.6",
        "ParameterGroupName": "default.memorydb-redis6",
        "ParameterGroupStatus": "in-sync",
        "SubnetGroupName": "my-sg",
        "TLSEnabled": true,
        "ARN": "arn:aws:memorydb:us-east-1:xxxxxxexamplearn:cluster/my-cluster",
        "SnapshotRetentionLimit": 0,
        "MaintenanceWindow": "wed:03:00-wed:04:00",
        "SnapshotWindow": "04:30-05:30",
        "DataTiering": "false",
        "AutoMinorVersionUpgrade": true
    }
}

Para visualizar os detalhes do cluster atualizado quando seu status mudar de Atualizado para Disponível, use o seguinte comando:

Para Linux, macOS ou Unix:

aws memorydb describe-clusters \
    --cluster-name my-cluster
    --show-shard-details

Para Windows:

aws memorydb describe-clusters ^
    --cluster-name my-cluster
    --show-shard-details

Retorna a seguinte resposta em JSON:

{
    "Clusters": [
        {
            "Name": "my-cluster",
            "Status": "available",
            "NumberOfShards": 1,
            "Shards": [
                {
                    "Name": "0001",
                    "Status": "available",
                    "Slots": "0-16383",
                    "Nodes": [
                        {
                            "Name": "my-cluster-0001-001",
                            "Status": "available",
                            "AvailabilityZone": "us-east-1a",
                            "CreateTime": "2021-08-21T20:22:12.405000-07:00",
                            "Endpoint": {
                                "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
                                "Port": 6379
                            }
                        },
                        {
                            "Name": "my-cluster-0001-002",
                            "Status": "available",
                            "AvailabilityZone": "us-east-1b",
                            "CreateTime": "2021-08-21T20:22:12.405000-07:00",
                            "Endpoint": {
                                "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
                                "Port": 6379
                            }
                        },
                        {
                            "Name": "my-cluster-0001-003",
                            "Status": "available",
                            "AvailabilityZone": "us-east-1a",
                            "CreateTime": "2021-08-22T12:59:31.844000-07:00",
                            "Endpoint": {
                                "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
                                "Port": 6379
                            }
                        }
                    ],
                    "NumberOfNodes": 3
                }
            ],
            "ClusterEndpoint": {
                "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
                "Port": 6379
            },
            "NodeType": "db.r6g.large",
            "EngineVersion": "6.2",
            "EnginePatchVersion": "6.2.6",
            "ParameterGroupName": "default.memorydb-redis6",
            "ParameterGroupStatus": "in-sync",
            "SubnetGroupName": "my-sg",
            "TLSEnabled": true,
            "ARN": "arn:aws:memorydb:us-east-1:xxxxxxexamplearn:cluster/my-cluster",
            "SnapshotRetentionLimit": 0,
            "MaintenanceWindow": "wed:03:00-wed:04:00",
            "SnapshotWindow": "04:30-05:30",
            "ACLName": "my-acl",
            "DataTiering": "false",
            "AutoMinorVersionUpgrade": true
        }
    ]
}

Para obter mais informações sobre como aumentar o número de réplicas usando a CLI, consulte update-cluster na referência de comandos da AWS CLI.

Usando a API do MemoryDB

Para aumentar o número de réplicas em um fragmento do MemoryDB, use a ação UpdateCluster com os seguintes parâmetros:

  • ClusterName – obrigatório. Identifica em qual cluster você deseja aumentar o número de réplicas.

  • ReplicaConfiguration – obrigatório. Permite que você defina o número de réplicas. Para aumentar a contagem de réplicas, defina a propriedade ReplicaCount para o número de réplicas que você deseja nesse fragmento ao final desta operação.

O exemplo a seguir aumenta o número de réplicas no cluster sample-cluster para três. Quando o exemplo é concluído, existem três réplicas em cada fragmento. Esse número se aplica se for um cluster do MemoryDB com um único fragmento ou um cluster do MemoryDB com vários fragmentos.

https://memory-db.us-east-1.amazonaws.com/
      ?Action=UpdateCluster      
      &ReplicaConfiguration.ReplicaCount=3
      &ClusterName=sample-cluster
      &Version=2021-01-01
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20210802T192317Z
      &X-Amz-Credential=<credential>

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

Diminuição do número de réplicas em um cluster

Você pode reduzir o número de réplicas em um cluster do MemoryDB. Você pode reduzir o número de réplicas para zero, mas não pode fazer o failover para uma réplica se seu nó primário falhar.

Você pode usar o AWS Management Console, a AWS CLI ou a API do MemoryDB para reduzir o número de réplicas em um cluster.

Uso do AWS Management Console

Para diminuir o número de réplicas em um cluster do MemoryDB (console), consulte Adição e Remoção de nós de um cluster.

Uso do AWS CLI

Para diminuir o número de réplicas em um cluster do MemoryDB, use o comando update-cluster com os seguintes parâmetros:

  • --cluster-name – obrigatório. Identifica em qual cluster você deseja diminuir o número de réplicas.

  • --replica-configuration – obrigatório.

    ReplicaCount: defina essa propriedade para especificar o número de nós de réplica desejado.

O exemplo a seguir usa --replica-configuration a fim de diminuir o número de réplicas no cluster my-cluster para o valor especificado.

Para Linux, macOS ou Unix:

aws memorydb update-cluster \
    --cluster-name my-cluster \
    --replica-configuration \
        ReplicaCount=1

Para Windows:

aws memorydb update-cluster ^
    --cluster-name my-cluster ^
    --replica-configuration ^
        ReplicaCount=1 ^

Retorna a seguinte resposta em JSON:

{
    "Cluster": {
        "Name": "my-cluster",
        "Status": "updating",
        "NumberOfShards": 1,
        "ClusterEndpoint": {
            "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
            "Port": 6379
        },
        "NodeType": "db.r6g.large",
        "EngineVersion": "6.2",
        "EnginePatchVersion": "6.2.6",
        "ParameterGroupName": "default.memorydb-redis6",
        "ParameterGroupStatus": "in-sync",
        "SubnetGroupName": "my-sg",
        "TLSEnabled": true,
        "ARN": "arn:aws:memorydb:us-east-1:xxxxxxexamplearn:cluster/my-cluster",
        "SnapshotRetentionLimit": 0,
        "MaintenanceWindow": "wed:03:00-wed:04:00",
        "SnapshotWindow": "04:30-05:30",
        "DataTiering": "false",
        "AutoMinorVersionUpgrade": true
    }
}

Para visualizar os detalhes do cluster atualizado quando seu status mudar de Atualizado para Disponível, use o seguinte comando:

Para Linux, macOS ou Unix:

aws memorydb describe-clusters \
    --cluster-name my-cluster
    --show-shard-details

Para Windows:

aws memorydb describe-clusters ^
    --cluster-name my-cluster
    --show-shard-details

Retorna a seguinte resposta em JSON:

{
    "Clusters": [
        {
            "Name": "my-cluster",
            "Status": "available",
            "NumberOfShards": 1,
            "Shards": [
                {
                    "Name": "0001",
                    "Status": "available",
                    "Slots": "0-16383",
                    "Nodes": [
                        {
                            "Name": "my-cluster-0001-001",
                            "Status": "available",
                            "AvailabilityZone": "us-east-1a",
                            "CreateTime": "2021-08-21T20:22:12.405000-07:00",
                            "Endpoint": {
                                "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
                                "Port": 6379
                            }
                        },
                        {
                            "Name": "my-cluster-0001-002",
                            "Status": "available",
                            "AvailabilityZone": "us-east-1b",
                            "CreateTime": "2021-08-21T20:22:12.405000-07:00",
                            "Endpoint": {
                                "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
                                "Port": 6379
                            }
                        }
                    ],
                    "NumberOfNodes": 2
                }
            ],
            "ClusterEndpoint": {
                "Address": "clustercfg.my-cluster.xxxxxx.memorydb.us-east-1.amazonaws.com",
                "Port": 6379
            },
            "NodeType": "db.r6g.large",
            "EngineVersion": "6.2",
            "EnginePatchVersion": "6.2.6",
            "ParameterGroupName": "default.memorydb-redis6",
            "ParameterGroupStatus": "in-sync",
            "SubnetGroupName": "my-sg",
            "TLSEnabled": true,
            "ARN": "arn:aws:memorydb:us-east-1:xxxxxxexamplearn:cluster/my-cluster",
            "SnapshotRetentionLimit": 0,
            "MaintenanceWindow": "wed:03:00-wed:04:00",
            "SnapshotWindow": "04:30-05:30",
            "ACLName": "my-acl",
            "DataTiering": "false",
            "AutoMinorVersionUpgrade": true
        }
    ]
}

Para obter mais informações sobre como diminuir o número de réplicas usando a CLI, consulte update-cluster no referência de comandos da AWS CLI.

Usando a API do MemoryDB

Para diminuir o número de réplicas em um cluster do MemoryDB, use a ação UpdateCluster com os seguintes parâmetros:

  • ClusterName – obrigatório. Identifica em qual cluster você deseja diminuir o número de réplicas.

  • ReplicaConfiguration – obrigatório. Permite que você defina o número de réplicas.

    ReplicaCount: defina essa propriedade para especificar o número de nós de réplica desejado.

O exemplo a seguir usa ReplicaCount para diminuir o número de réplicas no cluster sample-cluster para um. Quando o exemplo é concluído, existe uma réplica em cada fragmento. Esse número se aplica se for um cluster do MemoryDB com um único fragmento ou um cluster do MemoryDB com vários fragmentos.

https://memory-db.us-east-1.amazonaws.com/
      ?Action=UpdateCluster    
      &ReplicaConfiguration.ReplicaCount=1
      &ClusterName=sample-cluster
      &Version=2021-01-01
      &SignatureVersion=4
      &SignatureMethod=HmacSHA256
      &Timestamp=20210802T192317Z
      &X-Amz-Credential=<credential>

Para obter mais informações sobre como diminuir o número de réplicas usando a API, consulte UpdateCluster.