# Habilite ou desabilite implantações automáticas de StackSets no AWS Organizations
<a name="stacksets-orgs-manage-auto-deployment"></a>

O CloudFormation pode implantar automaticamente pilhas adicionais em novas contas do AWS Organizations quando elas são adicionadas à organização ou às unidades organizacionais (UOs) de destino. Você pode habilitar implantações automáticas e escolher se as pilhas e seu recursos associados serão excluídos ou retidos quando as contas forem removidas das UOs de destino. Essas configurações podem ser modificadas a qualquer momento em StackSets que usam permissões gerenciadas pelo serviço.

## Como as implantações automáticas funcionam
<a name="stacksets-orgs-auto-deployment-example"></a>

Quando as implantações automáticas estão habilitadas, elas são acionadas quando as contas são adicionadas a uma organização ou UO de destino, removidas de uma organização ou UO de destino ou transferidas entre UOs de destino.

Por exemplo, considere `StackSet1`, que tem como destino `OU1` na região `us-east-1`, e `StackSet2`, que tem como destino `OU2` na região `us-east-1`. `OU1` contém `AccountA`. 

Se passarmos a `AccountA` da `OU1` para a `OU2` com as implantações automáticas habilitadas, o CloudFormation executará automaticamente uma operação de exclusão para remover a pilha `StackSet1` da `AccountA` e colocará na fila uma operação de criação que adicionará a pilha `StackSet2` à `AccountA`.

## Considerações
<a name="stacksets-orgs-auto-deployment-considerations"></a>

As seguintes considerações se aplicam quando implantações automáticas são usadas:
+ O recurso de implantações automáticas é habilitado no nível do StackSet. Não é possível ajustar implantações automáticas seletivamente para OUs, contas ou regiões.
+ Os valores de parâmetro substituídos só se aplicam às contas que estão atualmente nas UOs de destino e nas UOs a elas subordinadas. As contas adicionadas às UOs de destino e suas UOs secundárias no futuro usarão os valores padrão do StackSet e não os valores substituídos.
+ As implantações automáticas não consideram filtros de segmentação em nível de conta. Se você usar contas de destino específicas e habilitar implantações automáticas, o StackSet continuará a implantar em novas contas adicionadas na organização implantada. Para evitar implantações em contas recém-adicionadas, desabilite implantações automáticas. 
+ Gerenciamento de dependências: defina até 10 dependências por StackSet, com até 100 dependências por conta. Por exemplo, se você tiver cinco StackSets com cinco dependências cada, você terá 25 dependências contabilizando para o limite de 100 dependências. Você pode solicitar um aumento de limite pelo [console do Service Quotas](https://console.aws.amazon.com/servicequotas/home). As dependências são removidas quando os StackSets são excluídos ou as organizações são desativadas.
+ É recomendável habilitar a execução gerenciada ao usar implantações automáticas. A execução gerenciada permitirá que as operações de implantação automática em várias contas de destino sejam executadas simultaneamente em um StackSet, aumentando a velocidade de processamento, especialmente para organizações maiores.

## Habilitar ou desabilitar implantações automáticas (console)
<a name="stacksets-orgs-manage-auto-deployment-console"></a>

**Para habilitar ou desabilitar implantações automáticas**

1. Faça login no Console de gerenciamento da AWS e abra o console CloudFormation em [https://console.aws.amazon.com/cloudformation](https://console.aws.amazon.com/cloudformation/).

1. Na barra de navegação na parte superior da tela, escolha a Região da AWS em que você criou o StackSet.

1. No painel de navegação, escolha **StackSets**.

1. Na página **StackSets**, selecione a opção ao lado do nome do StackSet a ser atualizado.

1. Escolha **Editar implantação automática** no menu **Ações**, no canto superior direito. 

1. Na caixa de diálogo que é aberta, faça o seguinte:

   1. Em **Implantação automática**, escolha **Ativada** ou **Desativada**.

   1. Em **Comportamento de remoção de conta**, escolha **Excluir pilhas** ou **Reter pilhas**. Os recursos retidos permanecerão em seu estado atual, mas não mais farão parte do StackSet.

   1. Para dependências do **StackSet**, adicione ARNs dependentes do StackSet, permanecendo com dez dependências no máximo.

1. Escolha **Salvar**.

## Habilitar ou desabilitar implantações automáticas (AWS CLI)
<a name="stacksets-orgs-manage-auto-deployment-cli"></a>

**Para habilitar ou desabilitar implantações automáticas**

1. Use o comando [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack-set.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/update-stack-set.html) com a opção `--auto-deployment`.

   O comando a seguir habilita as implantações automáticas.

   ```
   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template --auto-deployment Enabled=true,RetainStacksOnAccountRemoval=true,DependsOn=ARN1,ARN2
   ```

   Como alternativa, para desabilitar as implantações automáticas, especifique `Enabled=false` como o valor para a opção `--auto-deployment`, como no exemplo a seguir. 

   ```
   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template --auto-deployment Enabled=false
   ```

1. Usando o ID da operação que foi retornado como parte da saída de **update-stack-set**, execute [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stack-set-operation.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/describe-stack-set-operation.html) para verificar se o StackSet foi atualizado com êxito.

   ```
   aws cloudformation describe-stack-set-operation --operation-id operation_ID
   ```