

# Configuración de clústeres de Aurora DSQL mediante AWS CloudFormation
<a name="mr-cluster-setup"></a>

 Puede usar el mismo recurso CloudFormation `AWS::DSQL::Cluster` para implementar y administrar clústeres de Aurora DSQL de una sola región y de varias regiones. 

Consulte la [referencia del tipo de recurso de Amazon Aurora DSQL](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/AWS_DSQL.html) para obtener más información sobre cómo crear, modificar y administrar clústeres mediante el recurso `AWS::DSQL::Cluster`.

## Creación de la configuración inicial del clúster
<a name="mr-cluster-initial"></a>

En primer lugar, cree una plantilla de AWS CloudFormation para definir el clúster de varias regiones:

```
---
Resources:
  MRCluster:
    Type: AWS::DSQL::Cluster
    Properties:
      DeletionProtectionEnabled: true
      MultiRegionProperties:
        WitnessRegion: us-west-2
```

Cree pilas en ambas regiones mediante los siguientes comandos de la CLI de AWS:

```
aws cloudformation create-stack --region us-east-2 \
    --stack-name MRCluster \
    --template-body file://mr-cluster.yaml
```

```
aws cloudformation create-stack --region us-east-1 \
    --stack-name MRCluster \
    --template-body file://mr-cluster.yaml
```

## Búsqueda de identificadores de clúster
<a name="mr-cluster-find"></a>

Recupere los ID de recursos físicos para los clústeres:

```
aws cloudformation describe-stack-resources -region us-east-2 \
    --stack-name MRCluster \
    --query 'StackResources[].PhysicalResourceId'
[
  "auabudrks5jwh4mjt6o5xxhr4y"
]
```

```
aws cloudformation describe-stack-resources -region us-east-1 \
    --stack-name MRCluster \
    --query 'StackResources[].PhysicalResourceId'
[
  "imabudrfon4p2z3nv2jo4rlajm"
]
```

## Actualización de la configuración del clúster
<a name="mr-cluster-update"></a>

Actualice la plantilla de AWS CloudFormation para incluir los ARN del clúster:

```
---
Resources:
  MRCluster:
    Type: AWS::DSQL::Cluster
    Properties:
      DeletionProtectionEnabled: true
      MultiRegionProperties:
        WitnessRegion: us-west-2
        Clusters:
        - arn:aws:dsql:us-east-2:123456789012:cluster/auabudrks5jwh4mjt6o5xxhr4y
        - arn:aws:dsql:us-east-1:123456789012:cluster/imabudrfon4p2z3nv2jo4rlajm
```

Aplique la configuración actualizada a ambas regiones:

```
aws cloudformation update-stack --region us-east-2 \
    --stack-name MRCluster \
    --template-body file://mr-cluster.yaml
```

```
aws cloudformation update-stack --region us-east-1 \
    --stack-name MRCluster \
    --template-body file://mr-cluster.yaml
```