# Reverta sua pilha do CloudFormation em caso de violação de alarme com acionadores de reversão
Com os acionadores de reversão, você pode fazer com que o CloudFormation monitore o estado da sua aplicação durante a criação e a atualização da pilha e reverter essa operação se a aplicação ultrapassar o limite dos alarmes que você especificou. Para cada trigger de reversão criado, você especifica o alarme do CloudWatch que o CloudFormation deve monitorar. O CloudFormation monitora os alarmes especificados durante a operação de criação ou atualização da pilha, e pelo tempo especificado depois que todos os recursos foram implantados. Se qualquer um dos alarmes entrar no estado `ALARM` durante a operação de pilha ou o período de monitoramento, o CloudFormation reverterá toda a operação de pilha.
Você pode definir um tempo de monitoramento de 0 (padrão) até 180 minutos. Durante esse tempo, o CloudFormation monitora todos os triggers de reversão depois da implantação de todos os recursos necessários pela operação de criação ou atualização da pilha. Se qualquer um dos alarmes entrar no estado `ALARM` durante a operação de pilha ou esse período de monitoramento, o CloudFormation reverterá toda a operação de pilha. Em seguida, para as operações de atualização, se o período de monitoramento expirar sem que qualquer alarme entre no estado `ALARM`, o CloudFormation continuará a descartar recursos antigos normalmente. Se você definir um tempo de monitoramento, mas não especificar um trigger de reversão, o CloudFormation ainda aguardará o tempo especificado antes de limpar os recursos antigos para atualizar as operações. Você pode usar este período de monitoramento para executar qualquer validação manual desejada na pilha, e cancelar ou atualizar a criação da pilha manualmente conforme necessário. Se você definir um tempo de monitoramento de 0 minutos, o CloudFormation ainda fará o monitoramento dos triggers de reversão durante as operações de criação e atualização da pilha e reverterá a operação se um alarme entrar no estado `ALARM`. Em seguida, para as operações de atualização sem alarmes de violação, ele começará a eliminar os recursos antigos imediatamente assim que a operação for concluída.
Por padrão, o CloudFormation somente reverte as operações da pilha se um alarme entrar no estado `ALARM`, não no estado `INSUFFICIENT_DATA`. Para que o CloudFormation também reverta a operação de pilha caso um alarme entre no estado `INSUFFICIENT_DATA`, edite o alerta do CloudWatch para tratar a ausência de dados como `breaching`. Para obter mais informações, consulte [Configuração da forma como os alarmes do CloudWatch tratam dados ausentes](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html#alarms-and-missing-data) no *Manual do usuário do Amazon CloudWatch*.
O CloudFormation não monitora os triggers de reversão quando ele reverte uma pilha durante uma operação de atualização.
Você pode adicionar um máximo de cinco triggers de reversão. Para adicionar um trigger de reversão, especifique o nome do recurso da Amazon (ARN) do alarme do CloudWatch. No momento, `AWS::CloudWatch::Alarm` e `AWS::CloudWatch::CompositeAlarm` podem ser utilizados como gatilhos de reversão. Para obter mais informações sobre os alarmes do CloudWatch, consulte [Uso dos alarmes do CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html), no *Guia do usuário do Amazon CloudWatch*.
Se um determinado alarme do CloudWatch estiver ausente, toda a operação de pilha falhará e será revertida.
Lembre-se de que o acesso ao CloudWatch requer credenciais. Essas credenciais devem ter permissões para acessar os recursos da AWS, como recuperar dados de métricas do CloudWatch sobre seus recursos. Para obter mais informações, consulte [Autenticação e controle de acesso para o CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/auth-and-access-control-cw.html), no *Guia do usuário do Amazon CloudWatch*.
## Adicionar triggers de reversão durante a criação ou atualização da pilha
**Para adicionar gatilhos de reversão durante a criação ou a atualização de pilhas (console)**
1. Durante a criação ou a atualização de uma pilha, na página **Configurar opções de pilha**, em **Opções avançadas**, expanda a seção **Configuração de reversão**.
1. Insira um tempo de monitoramento entre `0` e `180` minutos. O valor padrão é `0`.
1. Especifique o ARN do alarme ou alarme composto do CloudWatch que você deseja usar como gatilho de reversão e escolha **Adicionar ARN de alarme do CloudWatch**.
Por exemplo, o seguinte é um ARN para um alarme do CloudWatch ou um alarme composto, `arn:aws:cloudwatch:{{us-east-1}}:{{123456789012}}:alarm:{{MyAlarmName}}`.
1. Escolha **Avançar** e revise os detalhes da pilha.
1. Quando estiver pronto, escolha **Enviar** para criar ou atualizar a pilha.
**Para adicionar gatilhos de reversão durante a criação ou atualização de pilhas (AWS CLI)**
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-stack.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-stack.html) ou [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack.html) com a opção `--rollback-configuration`.
Por exemplo, o seguinte comando **update-stack** define {{MyCompositeAlarm}} como um gatilho de reversão com um período de monitoramento de 5 minutos:
```
aws cloudformation update-stack --stack-name {{MyStack}} \
--use-previous-template \
--rollback-configuration \
"RollbackTriggers=[{Arn=arn:aws:cloudwatch:{{us-east-1}}:{{123456789012}}:alarm:{{MyCompositeAlarm}},Type={{AWS::CloudWatch::CompositeAlarm}}}],MonitoringTimeInMinutes={{5}}"
```
## Adicionar gatilhos de reversão a um conjunto de alterações
Para adicionar gatilhos de reversão a um conjunto de alterações (console)
1. Durante a criação ou a atualização de um conjunto de alterações, na página **Configurar opções de pilha**, em **Opções avançadas**, expanda a seção **Configuração de reversão**.
1. Insira um tempo de monitoramento entre `0` e `180` minutos. O valor padrão é `5`.
1. Especifique o ARN do alarme ou alarme composto do CloudWatch que você deseja usar como gatilho de reversão e escolha **Adicionar ARN de alarme do CloudWatch**.
Por exemplo, o seguinte é um ARN para um alarme do CloudWatch ou um alarme composto, `arn:aws:cloudwatch:{{us-east-1}}:123456789012:alarm:{{MyAlarmName}}`.
1. Escolha **Avançar** e revise os detalhes do conjunto de alterações.
1. Quando estiver pronto, escolha **Criar conjunto de alterações** para criar o conjunto de alterações.
**Para adicionar gatilhos de reversão a um conjunto de alterações (AWS CLI)**
Use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-change-set.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-change-set.html) com a opção `--rollback-configuration`.
## Visualizar gatilhos de reversão para uma pilha
Para visualizar gatilhos de reversão para uma pilha, consulte a seção **Rollback configuration** (Configuração de reversão).
1. Na página **Pilhas**, escolha, na lista à esquerda, a pilha que você deseja visualizar.
1. Na guia **Informações da pilha**, expanda a seção **Configuração de reversão** para visualizar os gatilhos de reversão.
## Visualizar gatilhos de reversão de um conjunto de alterações
Para visualizar gatilhos de reversão para um conjunto de alterações, consulte a seção **Rollback configuration** (Configuração de reversão).
1. Na página **Pilhas**, escolha, na lista à esquerda, a pilha que você deseja visualizar.
1. Selecione a guia **Conjuntos de alterações** e depois escolha o conjunto de alterações que você deseja visualizar.
1. Escolha a guia **Entrada** e visualize a seção **Configuração de reversão**.