

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Creación de un grupo de reproducción mediante un clúster existente
<a name="Replication.CreatingReplGroup.ExistingCluster"></a>

El siguiente procedimiento añade un grupo de replicación a su clúster de un solo nodo de Valkey o Redis OSS (modo de clúster deshabilitado), que es necesario para actualizar el clúster a la última versión de Valkey. Se trata de un procedimiento in situ que no implica ningún tiempo de inactividad ni pérdida de datos. Al crear un grupo de replicación para un clúster de un solo nodo, el nodo del clúster se convierte en el nodo principal del nuevo clúster. Si no tiene un clúster de Valkey o Redis OSS (modo de clúster deshabilitado) que pueda utilizar como el nuevo principal del clúster; consulte [Creación de un grupo de replicación de Valkey o Redis OSS desde cero](Replication.CreatingReplGroup.NoExistingCluster.md).

Un clúster disponible es un clúster de Valkey o Redis OSS de un solo nodo existente. Actualmente, Valkey o Redis OSS (modo de clúster habilitado) no admiten la creación de un clúster con réplicas mediante un clúster de un solo nodo disponible. Si desea crear un clúster de Valkey o Redis OSS (modo de clúster habilitado), consulte [Creación de un clúster de Valkey o Redis OSS (modo de clúster habilitado) (consola)](Replication.CreatingReplGroup.NoExistingCluster.Cluster.md#Replication.CreatingReplGroup.NoExistingCluster.Cluster.CON).

## Creación de un grupo de replicación mediante un clúster existente (consola)
<a name="Replication.CreatingReplGroup.ExistingCluster.CON"></a>

Consulte el tema [Usando el ElastiCache Consola de administración de AWS](Clusters.AddNode.md#Clusters.AddNode.CON).

## Creación de un grupo de replicación mediante un clúster de Valkey o Redis OSS disponible (AWS CLI)
<a name="Replication.CreatingReplGroup.ExistingCluster.CLI"></a>

Hay dos pasos para crear un grupo de replicación con réplicas de lectura al utilizar un clúster de caché de Valkey o Redis OSS disponible para el nodo principal cuando se utiliza la AWS CLI.

Al AWS CLI utilizar el, se crea un grupo de replicación que especifica el nodo independiente disponible como nodo principal del clúster `--primary-cluster-id` y la cantidad de nodos que desea en el clúster mediante el comando CLI,`create-replication-group`. Incluya los siguientes parámetros.

**--replication-group-id**  
El nombre del grupo de replicación que va a crear. El valor de este parámetro se usa como la base de los nombres de los nodos añadidos con un número de tres dígitos secuencial añadido al final de `--replication-group-id`. Por ejemplo, `sample-repl-group-001`.  
Las restricciones de nomenclatura de los grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) son las siguientes:  
+ Deben contener entre 1 y 40 caracteres alfanuméricos o guiones.
+ Deben comenzar por una letra.
+ No pueden contener dos guiones consecutivos.
+ No pueden terminar con un guion.

**--replication-group-description**  
Descripción del grupo de replicación.

**--num-node-groups**  
El número de nodos que desea en este clúster. Este valor incluye el nodo principal. Este parámetro tiene un valor máximo de seis.

**--primary-cluster-id**  
El nombre del nodo del clúster de Valkey o Redis OSS (modo de clúster deshabilitado) disponible que desea que sea el nodo principal en este grupo de replicación.

El siguiente comando crea el grupo de replicación `sample-repl-group` mediante el clúster de Valkey o Redis OSS (modo de clúster deshabilitado) disponible `redis01` como el nodo principal del grupo de replicación. Crea dos nuevos nodos que son réplicas de lectura. La configuración de `redis01` (es decir, grupo de parámetros, grupo de seguridad, tipo de nodo, versión del motor, etc.) se aplicará a todos los nodos del grupo de reproducción.

Para Linux, macOS o Unix:

```
aws elasticache create-replication-group \
   --replication-group-id sample-repl-group \
   --replication-group-description "demo cluster with replicas" \
   --num-cache-clusters 3 \
   --primary-cluster-id redis01
```

Para Windows:

```
aws elasticache create-replication-group ^
   --replication-group-id sample-repl-group ^
   --replication-group-description "demo cluster with replicas" ^
   --num-cache-clusters 3 ^
   --primary-cluster-id redis01
```

Para obtener información y parámetros adicionales que desee utilizar, consulte el AWS CLI tema[create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html).

**A continuación, añada réplicas de lectura al grupo de replicación.**  
Después de haber creado el grupo de reproducción, agregue de una a cinco réplicas de lectura con el comando `create-cache-cluster`, asegurándose de incluir los siguientes parámetros. 

**--cache-cluster-id**  
El nombre del clúster que va a añadir al grupo de replicación.  
Las restricciones para la asignación de nombres de clúster son las siguientes:  
+ Deben contener entre 1 y 40 caracteres alfanuméricos o guiones.
+ Deben comenzar por una letra.
+ No pueden contener dos guiones consecutivos.
+ No pueden terminar con un guion.


**--replication-group-id**  
Es el nombre del grupo de replicación al que va a añadir este clúster.

Repita este comando para cada réplica de lectura que desee agregar al grupo de reproducción, cambiando únicamente el valor del parámetro `--cache-cluster-id`.

**nota**  
Recuerde que un grupo de reproducción no puede tener más de cinco réplicas de lectura. Si intenta agregar una réplica de lectura a un grupo de reproducción que ya tenga cinco réplicas de lectura hará que la operación falle.

El siguiente código añade la réplica de lectura `my-replica01` al grupo de replicación `sample-repl-group`. La configuración del clúster principal (grupo de parámetros, grupo de seguridad, tipo de nodo, etc.) se aplicará a los nodos que se agreguen al grupo de reproducción.

Para Linux, macOS o Unix:

```
aws elasticache create-cache-cluster \
   --cache-cluster-id my-replica01 \
   --replication-group-id sample-repl-group
```

Para Windows:

```
aws elasticache create-cache-cluster ^
   --cache-cluster-id my-replica01 ^
   --replication-group-id sample-repl-group
```

El resultado de este comando será algo similar a lo que se muestra a continuación.

```
{
    "ReplicationGroup": {
        "Status": "creating",
        "Description": "demo cluster with replicas",
        "ClusterEnabled": false,
        "ReplicationGroupId": "sample-repl-group",
        "SnapshotRetentionLimit": 1,
        "AutomaticFailover": "disabled",
        "SnapshotWindow": "00:00-01:00",
        "SnapshottingClusterId": "redis01",
        "MemberClusters": [
            "sample-repl-group-001",
            "sample-repl-group-002",
            "redis01"
        ],
        "CacheNodeType": "cache.m4.large",
        "DataTiering": "disabled",
        "PendingModifiedValues": {}
    }
}
```

Para obtener información adicional, consulte los AWS CLI temas:
+ [create-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/create-replication-group.html)
+ [modify-replication-group](https://docs.aws.amazon.com/cli/latest/reference/elasticache/modify-replication-group.html)

## Añadir réplicas a un clúster (API) independiente de Valkey o Redis OSS (modo de clúster desactivado) ElastiCache
<a name="Replication.CreatingReplGroup.ExistingCluster.API"></a>

Al utilizar la ElastiCache API, se crea un grupo de replicación que especifica el nodo independiente disponible como nodo principal del clúster `PrimaryClusterId` y la cantidad de nodos que desea que haya en el clúster mediante el comando CLI,`CreateReplicationGroup`. Incluya los siguientes parámetros.

**ReplicationGroupId**  
El nombre del grupo de replicación que va a crear. El valor de este parámetro se usa como la base de los nombres de los nodos añadidos con un número de tres dígitos secuencial añadido al final de `ReplicationGroupId`. Por ejemplo, `sample-repl-group-001`.  
Las restricciones de nomenclatura de los grupos de replicación de Valkey o Redis OSS (modo de clúster deshabilitado) son las siguientes:  
+ Deben contener entre 1 y 40 caracteres alfanuméricos o guiones.
+ Deben comenzar por una letra.
+ No pueden contener dos guiones consecutivos.
+ No pueden terminar con un guion.

**ReplicationGroupDescription**  
Descripción del clúster con réplicas.

**NumCacheClusters**  
El número de nodos que desea en este clúster. Este valor incluye el nodo principal. Este parámetro tiene un valor máximo de seis.

**PrimaryClusterId**  
El nombre del clúster de Valkey o Redis OSS (modo de clúster deshabilitado) disponible que desea que sea el nodo principal en este clúster.

El siguiente comando crea el clúster con réplicas `sample-repl-group` mediante el clúster de Valkey o Redis OSS (modo de clúster deshabilitado) `redis01` disponible como el nodo principal del grupo de replicación. Crea dos nuevos nodos que son réplicas de lectura. La configuración de `redis01` (es decir, grupo de parámetros, grupo de seguridad, tipo de nodo, versión del motor, etc.) se aplicará a todos los nodos del grupo de reproducción.

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=CreateReplicationGroup 
   &Engine=redis
   &EngineVersion=6.0
   &ReplicationGroupDescription=Demo%20cluster%20with%20replicas
   &ReplicationGroupId=sample-repl-group
   &PrimaryClusterId=redis01
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

Para obtener información adicional, consulte los temas de ElastiCache APL:
+ [CreateReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateReplicationGroup.html)
+ [ModifyReplicationGroup](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_ModifyReplicationGroup.html)

**A continuación, añada réplicas de lectura al grupo de replicación.**  
Después de haber creado el grupo de reproducción, agregue de una a cinco réplicas de lectura con la operación `CreateCacheCluster`, asegurándose de incluir los siguientes parámetros. 

**CacheClusterId**  
El nombre del clúster que va a añadir al grupo de replicación.  
Las restricciones para la asignación de nombres de clúster son las siguientes:  
+ Deben contener entre 1 y 40 caracteres alfanuméricos o guiones.
+ Deben comenzar por una letra.
+ No pueden contener dos guiones consecutivos.
+ No pueden terminar con un guion.


**ReplicationGroupId**  
Es el nombre del grupo de replicación al que va a añadir este clúster.

Repita esta operación para cada réplica de lectura que desee agregar al grupo de reproducción, cambiando únicamente el valor del parámetro `CacheClusterId`.

El siguiente código agrega la réplica de lectura `myReplica01` al grupo de reproducción `myReplGroup`. La configuración del clúster principal (grupo de parámetros, grupo de seguridad, tipo de nodo, etc.) se aplicará a los nodos que se agreguen al grupo de reproducción.

```
https://elasticache.us-west-2.amazonaws.com/
	?Action=CreateCacheCluster
	&CacheClusterId=myReplica01
	&ReplicationGroupId=myReplGroup
	&SignatureMethod=HmacSHA256
	&SignatureVersion=4
	&Version=2015-02-02
	&X-Amz-Algorithm=&AWS;4-HMAC-SHA256
	&X-Amz-Credential=[your-access-key-id]/20150202/us-west-2/elasticache/aws4_request
	&X-Amz-Date=20150202T170651Z
	&X-Amz-SignedHeaders=content-type;host;user-agent;x-amz-content-sha256;x-amz-date
	&X-Amz-Signature=[signature-value]
```

Para obtener información y parámetros adicionales que quizás quieras usar, consulta el tema sobre la ElastiCache API[CreateCacheCluster](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_CreateCacheCluster.html).