

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

# Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster"></a>

Você pode criar um cluster do Valkey ou Redis OSS (modo cluster habilitado) (API/CLI: *grupo de replicação*) usando o console do ElastiCache, a AWS CLI ou a API do ElastiCache. Um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) tem de 1 a 500 fragmentos (API/CLI: grupos de nós), um nó primário em cada fragmento e até 5 réplicas de leitura em cada fragmento. É possível criar um cluster com alto número de fragmentos e baixo número de réplicas totalizando até 90 nós por cluster. Essa configuração do cluster pode variar de 90 fragmentos e 0 réplicas para 15 fragmentos e 5 réplicas, que é o número máximo de réplicas permitidas.

O limite de nó ou fragmento pode ser aumentado para um máximo de 500 por cluster se a versão do mecanismo Valkey ou Redis OSS for 5.0.6 ou posterior. Por exemplo, você pode optar por configurar um cluster de 500 nós que varia entre 83 fragmentos (uma primária e 5 réplicas por fragmento) e 500 fragmentos (primário único e sem réplicas). Verifique se existem endereços IP disponíveis suficientes para acomodar o aumento. As armadilhas comuns incluem as sub-redes no grupo de sub-redes têm um intervalo CIDR muito pequeno ou as sub-redes são compartilhadas e fortemente usadas por outros clusters. Para obter mais informações, consulte [Criação de um grupo de sub-redes](SubnetGroups.Creating.md).

 Para versões abaixo de 5.0.6, o limite é 250 por cluster.

Para solicitar um aumento de limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e selecione o tipo de limite **Nodes per cluster per instance type** (Nós por cluster por tipo de instância). 

**Topics**
+ [Uso do console do ElastiCache](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON)
+ [Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início (AWS CLI)](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CLI)
+ [Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início (API do ElastiCache)](#Replication.CreatingReplGroup.NoExistingCluster.Cluster.API)

## Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON"></a>

Para criar um cluster do Valkey ou Redis OSS (modo cluster habilitado), consulte [Criação de um cluster do Valkey ou Redis OSS (modo cluster habilitado) (console)](Clusters.Create.md#Clusters.Create.CON.RedisCluster). Certifique-se de habilitar o modo de cluster, **Cluster Mode enabled (Scale Out)**, e especifique pelo menos dois fragmentos e um nó de réplica em cada.

## Criação de um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início (AWS CLI)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster.CLI"></a>

O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) usando a AWS CLI.

Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para o comando `create-replication-group` da AWS CLI. Inclua os seguintes parâmetros.

**--replication-group-id**  
O nome do grupo de replicação que você está criando.  
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.

**--replication-group-description**  
Descrição do grupo de replicação.

**--cache-node-type**  
O tipo de nó para cada nó no grupo de replicação.  
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.  
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).

**--cache-parameter-group**  
Especifique o grupo de parâmetros `default.redis6.x.cluster.on` ou um grupo de parâmetros derivado de `default.redis6.x.cluster.on` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Para obter mais informações, consulte [Alterações de parâmetros do Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).

**--engine**  
redis

**--engine-version**  
3.2.4

**--num-node-groups**  
O número de grupos de nós neste grupo de replicação. Os valores válidos são 1 a 500.  
O limite de nó/fragmento pode ser aumentado para um máximo de 500 por cluster. Para solicitar um aumento do limite, consulte [Limites de serviço da AWS](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html) e selecione o tipo de limite "Nodes per cluster per instance type" (Nós por cluster por tipo de instância). 

**--replicas-per-node-group**  
O número de nós de réplica em cada grupo de nós. Os valores válidos são 0 a 5.

**--network-type**  
`ipv4`, `ipv` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como `ipv4` ou `ipv6`.

Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `--transit-encryption-enabled` ou `--at-rest-encryption-enabled` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `--cache-subnet-group`.
+ Você também deve incluir o parâmetro `--auth-token` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.

A seguinte operação cria o grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) `sample-repl-group` com três grupos de nós/fragmentos (--num-node-groups), cada um com três nós, uma réplica primária e duas réplicas de leitura (--replicas-per-node-group).

Para Linux, macOS ou Unix:

```
aws elasticache create-replication-group \
   --replication-group-id sample-repl-group \
   --replication-group-description "Demo cluster with replicas" \
   --num-node-groups 3 \
   --replicas-per-node-group 2 \
   --cache-node-type cache.m4.large \ 
   --engine redis \   
   --security-group-ids SECURITY_GROUP_ID \    
   --cache-subnet-group-name SUBNET_GROUP_NAME>
```

Para Windows:

```
aws elasticache create-replication-group ^
   --replication-group-id sample-repl-group ^
   --replication-group-description "Demo cluster with replicas" ^
   --num-node-groups 3 ^
   --replicas-per-node-group 2 ^
   --cache-node-type cache.m4.large ^ 
   --engine redis ^   
   --security-group-ids SECURITY_GROUP_ID ^      
   --cache-subnet-group-name SUBNET_GROUP_NAME>
```

O comando anterior gera a seguinte saída.

```
{
    "ReplicationGroup": {
        "Status": "creating", 
        "Description": "Demo cluster with replicas", 
        "ReplicationGroupId": "sample-repl-group", 
        "SnapshotRetentionLimit": 0, 
        "AutomaticFailover": "enabled", 
        "SnapshotWindow": "05:30-06:30", 
        "MemberClusters": [
            "sample-repl-group-0001-001", 
            "sample-repl-group-0001-002", 
            "sample-repl-group-0001-003", 
            "sample-repl-group-0002-001", 
            "sample-repl-group-0002-002", 
            "sample-repl-group-0002-003", 
            "sample-repl-group-0003-001", 
            "sample-repl-group-0003-002", 
            "sample-repl-group-0003-003"
        ], 
        "PendingModifiedValues": {}
    }
}
```

Quando você cria um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início, você pode configurar cada fragmento do cluster usando o parâmetro `--node-group-configuration`, como mostra o exemplo a seguir, que configura dois grupos de nós (console: fragmentos). O primeiro fragmento tem dois nós: um primário e uma réplica de leitura. O segundo fragmento tem três nós: um primário e duas réplicas de leitura.

**--node-group-configuration**  
A configuração para cada grupo de nós. O parâmetro `--node-group-configuration` consiste nos seguintes campos.  
+ `PrimaryAvailabilityZone`: a zona de disponibilidade onde o nó primário desse grupo de nós está localizado. Se esse parâmetro for omitido, o ElastiCache escolherá a zona de disponibilidade para o nó primário.

  **Exemplo:** us-west-2a.
+ `ReplicaAvailabilityZones`: uma lista separada por vírgulas de zonas de disponibilidade em que as réplicas de leitura estão localizadas. O número de Zonas de disponibilidade nessa lista deve corresponder ao valor de `ReplicaCount`. Se esse parâmetro for omitido, o ElastiCache escolherá as zonas de disponibilidade para os nós de réplica.

  **Exemplo:** "us-west-2a,us-west-2b,us-west-2c"
+ `ReplicaCount`: o número de nós de réplica nesse grupo de nós.
+ `Slots`: uma string que especifica o espaço de chaves para o grupo de nós. A string está no formato `startKey-endKey`. Se esse parâmetro for omitido, o ElastiCache alocará as chaves igualmente entre os grupos de nós.

  **Exemplo:** "0-4999"

   

A operação a seguir cria o grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) `new-group` com dois grupos de nós/fragmentos (`--num-node-groups`). Ao contrário do exemplo anterior, cada grupo de nós está configurado de forma diferente do outro grupo de nós (`--node-group-configuration`).

Para Linux, macOS ou Unix:

```
aws elasticache create-replication-group \
  --replication-group-id new-group \
  --replication-group-description "Sharded replication group" \
  --engine redis \    
  --snapshot-retention-limit 8 \
  --cache-node-type cache.m4.medium \
  --num-node-groups 2 \
  --node-group-configuration \
      "ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
      "ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"
```

Para Windows:

```
aws elasticache create-replication-group ^
  --replication-group-id new-group ^
  --replication-group-description "Sharded replication group" ^
  --engine redis ^    
  --snapshot-retention-limit 8 ^
  --cache-node-type cache.m4.medium ^
  --num-node-groups 2 ^
  --node-group-configuration \
      "ReplicaCount=1,Slots=0-8999,PrimaryAvailabilityZone='us-east-1c',ReplicaAvailabilityZones='us-east-1b'" \
      "ReplicaCount=2,Slots=9000-16383,PrimaryAvailabilityZone='us-east-1a',ReplicaAvailabilityZones='us-east-1a','us-east-1c'"
```

A operação anterior gera a seguinte saída.

```
{
    "ReplicationGroup": {
        "Status": "creating", 
        "Description": "Sharded replication group", 
        "ReplicationGroupId": "rc-rg", 
        "SnapshotRetentionLimit": 8, 
        "AutomaticFailover": "enabled", 
        "SnapshotWindow": "10:00-11:00", 
        "MemberClusters": [
            "rc-rg-0001-001", 
            "rc-rg-0001-002", 
            "rc-rg-0002-001", 
            "rc-rg-0002-002", 
            "rc-rg-0002-003"
        ], 
        "PendingModifiedValues": {}
    }
}
```

Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico sobre a AWS CLI [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).

## Criação de um grupo de replicação no Valkey ou Redis OSS (modo cluster habilitado) do início (API do ElastiCache)
<a name="Replication.CreatingReplGroup.NoExistingCluster.Cluster.API"></a>

O procedimento a seguir cria um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) usando a API do ElastiCache.

Ao criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) do início, você cria o grupo de replicação e todos os seus nós com uma única chamada para a operação `CreateReplicationGroup` da API do ElastiCache. Inclua os seguintes parâmetros.

**ReplicationGroupId**  
O nome do grupo de replicação que você está criando.  
As restrições de nomenclatura do grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado) são as seguintes:  
+ Devem conter 1 a 40 caracteres alfanuméricos ou hifens.
+ Deve começar com uma letra.
+ Não podem conter dois hifens consecutivos.
+ Não podem terminar com um hífen.

**ReplicationGroupDescription**  
Descrição do grupo de replicação.

**NumNodeGroups**  
O número de grupos de nós que você deseja criar com esse grupo de replicação. Os valores válidos são 1 a 500.

**ReplicasPerNodeGroup**  
O número de nós de réplica em cada grupo de nós. Os valores válidos são 1 a 5.

**NodeGroupConfiguration**  
A configuração para cada grupo de nós. O parâmetro `NodeGroupConfiguration` consiste nos seguintes campos.  
+ `PrimaryAvailabilityZone`: a zona de disponibilidade onde o nó primário desse grupo de nós está localizado. Se esse parâmetro for omitido, o ElastiCache escolherá a zona de disponibilidade para o nó primário.

  **Exemplo:** us-west-2a.
+ `ReplicaAvailabilityZones`: uma lista de zonas de disponibilidade em que as réplicas de leitura estão localizadas. O número de Zonas de disponibilidade nessa lista deve corresponder ao valor de `ReplicaCount`. Se esse parâmetro for omitido, o ElastiCache escolherá as zonas de disponibilidade para os nós de réplica.
+ `ReplicaCount`: o número de nós de réplica nesse grupo de nós.
+ `Slots`: uma string que especifica o espaço de chaves para o grupo de nós. A string está no formato `startKey-endKey`. Se esse parâmetro for omitido, o ElastiCache alocará as chaves igualmente entre os grupos de nós.

  **Exemplo:** "0-4999"

   

**CacheNodeType**  
O tipo de nó para cada nó no grupo de replicação.  
Os tipos de nó a seguir são compatíveis com o ElastiCache. Em linhas gerais, os tipos da geração atual fornecem mais memória e poder computacional a um custo mais baixo em comparação aos equivalentes das geração anteriores.  
Para obter mais informações sobre detalhes de performance para cada tipo de nó, consulte [Tipos de instância do Amazon EC2](https://aws.amazon.com/ec2/instance-types/).

**--data-tiering-enabled**  
Defina esse parâmetro se estiver usando um tipo de nó r6gd. Se não quiser classificação de dados em níveis, defina `--no-data-tiering-enabled`. Para obter mais informações, consulte [Classificação de dados em níveis no ElastiCache](data-tiering.md).

**CacheParameterGroup**  
Especifique o grupo de parâmetros `default.redis6.x.cluster.on` ou um grupo de parâmetros derivado de `default.redis6.x.cluster.on` para criar um grupo de replicação do Valkey ou Redis OSS (modo cluster habilitado). Para obter mais informações, consulte [Alterações de parâmetros do Redis OSS 6.x](ParameterGroups.Engine.md#ParameterGroups.Redis.6-x).

**--network-type**  
`ipv4`, `ipv` ou `dual-stack`. Se você escolher pilha dupla, deverá definir o parâmetro `--IpDiscovery` como `ipv4` ou `ipv6`.

**Mecanismo**  
redis

**EngineVersion**  
6.0

Se você quiser habilitar a criptografia em trânsito ou em repouso neste grupo de replicação, adicione um ou ambos os parâmetros `TransitEncryptionEnabled=true` ou `AtRestEncryptionEnabled=true` e cumpra as seguintes condições.
+ Seu grupo de replicação deve estar executando o Redis OSS versão 3.2.6 ou 4.0.10.
+ O grupo de replicação precisa ser criado em uma Amazon VPC.
+ Você também deve incluir o parâmetro `CacheSubnetGroup`.
+ Você também deve incluir o parâmetro `AuthToken` com o valor de string especificado pelo cliente para o token AUTH (senha) necessário para realizar operações neste grupo de replicação.

As quebras de linha foram adicionadas para legibilidade.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=CreateReplicationGroup 
   &CacheNodeType=cache.m4.large
   &CacheParemeterGroup=default.redis6.xcluster.on
   &Engine=redis
   &EngineVersion=6.0
   &NumNodeGroups=3
   &ReplicasPerNodeGroup=2
   &ReplicationGroupDescription=test%20group
   &ReplicationGroupId=myReplGroup
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Para obter informações adicionais e parâmetros que você queira usar, consulte o tópico sobre a API do ElastiCache [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html).