# Configurar clusters do Aurora DSQL usando o AWS CloudFormation
<a name="mr-cluster-setup"></a>

 Você pode usar o mesmo recurso `AWS::DSQL::Cluster` do CloudFormation para implantar e gerenciar clusters do Aurora DSQL de região única e multirregião. 

Consulte a [referência do tipo de recurso do Amazon Aurora DSQL](https://docs.aws.amazon.com/AWSCloudFormation/latest/TemplateReference/AWS_DSQL.html) para saber mais sobre como criar, modificar e gerenciar clusters usando o recurso `AWS::DSQL::Cluster`.

## Criação da configuração inicial do cluster
<a name="mr-cluster-initial"></a>

Primeiro crie um modelo AWS CloudFormation para definir seu cluster multirregional:

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

Crie pilhas em ambas as regiões usando os seguintes comandos da CLI da 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
```

## Localizar identificadores de cluster
<a name="mr-cluster-find"></a>

Recupere os IDs de recursos físicos para seus clusters:

```
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"
]
```

## Atualizar a configuração do cluster
<a name="mr-cluster-update"></a>

Atualize seu modelo do AWS CloudFormation para incluir ambos os ARNs do cluster:

```
---
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 a configuração atualizada em ambas as regiões:

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