# Criar uma pilha no console do CloudFormation
Você pode criar um modelo de pilha e depois usá-lo para criar uma pilha usando o console do CloudFormation ou uma ferramenta de linha de comando. O console oferece uma interface guiada por assistente com opções predefinidas para agilizar o processo de criação de pilhas.
**Topics**
+ [Criar uma pilha](#create-stack)
+ [Configurar opções da pilha](#configure-stack-options)
+ [Visualizar a configuração da sua pilha](#cfn-console-create-stacks-changesets)
## Criar uma pilha
Siga as etapas desta seção para implantar seu modelo e criar uma pilha.
**Pré-requisitos**
+ Você deve ter criado um modelo de pilha. Para obter mais informações, consulte [Trabalhar com modelos do CloudFormation](template-guide.md).
**Para criar uma pilha de (console)**
1. Abra o console do 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 na qual a pilha deve ser criada.
1. Na página **Pilhas**, escolha **Criar pilha** no canto superior direito e selecione **Com novos recursos (padrão)**.
Se preferir, escolha a opção **Com recursos existentes (importar recursos)** para importar os recursos da AWS existentes descritos no modelo. Para obter mais informações sobre essa opção, consulte [Importar recursos da AWS para uma pilha do CloudFormation](import-resources.md).
1. Na página **Criar uma pilha**, faça o seguinte:
+ Para usar um modelo existente, em **Pré-requisito: preparar modelo**, escolha **Escolher um modelo existente**. Em seguida, em **Especificar modelo**, escolha **URL do Amazon S3** ou **Carregar um arquivo de modelo** com base na localização do modelo.
+ Se você escolher **URL do Amazon S3**, forneça uma URL para o arquivo de modelo em um bucket do S3.
Se seu modelo incluir pilhas aninhadas (por exemplo, pilhas descritas em outros documentos de modelos localizados em subdiretórios), verifique se seu bucket do S3 contém os arquivos e diretórios necessários.
Se você tiver um modelo de um bucket habilitado para controle de versão, poderá especificar uma versão específica do modelo anexando `?versionId=version-id` à URL. Para obter mais informações sobre buckets habilitados por controle de versão, consulte [Trabalhar com objetos em um bucket habilitado com controle de versão](https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-objects-versioned-bucket.html), no *Guia do usuário do Amazon Simple Storage Service*.
O URL deve apontar para um modelo com um tamanho máximo de 1 MB que esteja armazenado em um bucket do S3 para o qual você tenha permissões de leitura. O URL pode ter no máximo 1.024 caracteres. Alguns recursos podem exigir que o bucket esteja na mesma região que a pilha.
+ Se escolher **Carregar um arquivo de modelo**, escolha **Escolher arquivo** para escolher um arquivo de modelo no computador local. O arquivo de modelo deve ter 1 MB ou menos.
Após escolher o modelo, o CloudFormation faz upload do arquivo e exibe o URL do S3. O CloudFormation o carrega em um bucket do Amazon S3 na sua Conta da AWS. Se você já tiver um bucket do S3 que foi criado pelo CloudFormation em sua Conta da AWS, o CloudFormation adicionará o modelo a esse bucket. Se você ainda não tiver um bucket criado pelo CloudFormation, ele criará um bucket exclusivo para cada região em que você carregar um arquivo de modelo.
Veja a seguir algumas considerações ao usar buckets do S3 criados pelo CloudFormation:
+ Os buckets são acessíveis a qualquer pessoa com permissões do Amazon S3 na sua conta Conta da AWS.
+ O CloudFormation cria os buckets com a criptografia no lado do servidor habilitada por padrão, criptografando, assim, todos os objetos armazenados no bucket.
Gerencie diretamente as opções de criptografia para buckets criados pelo CloudFormation usando, por exemplo, o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/), ou a AWS CLI. Para obter mais informações, consulte [Definir o comportamento padrão da criptografia para os buckets do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucket-encryption.html) no *Guia do usuário do Amazon Simple Storage Service*.
+ É possível utilizar seu próprio bucket e gerenciar suas permissões carregando modelos manualmente no Amazon S3. Ao criar ou atualizar uma pilha, especifique o URL de um arquivo de modelo do Amazon S3.
+ Se tiver um modelo pronto, você poderá escolher **Compilar do Infrastructure Composer** para criar um modelo com o Infrastructure Composer. Para obter mais informações, consulte [Compositor de Infraestrutura da AWS](infrastructure-composer-for-cloudformation.md).
1. Escolha **Avançar** para continuar e validar o modelo.
Antes de continuar, o CloudFormation valida seu modelo para verificar erros sintáticos e alguns semânticos, como dependências circulares. Durante a validação, o CloudFormation primeiro verifica se o modelo é JSON válido. Caso não seja, o CloudFormation verifica se o modelo é YAML válido. Se as duas verificações falharem, o CloudFormation retornará um erro de validação de modelo.
1. Na página **Specify stack details (Especificar detalhes da pilha)**, digite o nome de uma pilha na caixa **Stack name (Nome da pilha)**.
O nome da pilha é um identificador que ajuda a encontrar uma determinada pilha em uma lista de pilhas. Um nome de pilha pode conter apenas caracteres alfanuméricos (sensíveis a maiúsculas e minúsculas) e hifens. Ele deve começar com um caractere alfabético e não pode ter mais de 128 caracteres.
1. Na seção **Parâmetros**, especificam valores para os parâmetros que foram definidos no modelo.
1. Escolha **Avançar** para continuar criando a pilha.
1. (Opcional) Na página **Configurar opções de pilha**, altere as opções de pilha padrão. Para obter mais informações, consulte [Configurar opções da pilha](#configure-stack-options).
1. Se o seu modelo contém recursos do IAM, em **Recursos**, escolha **Eu reconheço que este modelo pode criar recursos do IAM** para especificar que você deseja usar recursos do IAM no modelo. Para obter mais informações, consulte [Confirmar recursos do IAM em modelos do CloudFormation](control-access-with-iam.md#using-iam-capabilities).
1. Escolha **Próximo** para continuar.
1. Na página **Revisar e criar**, revise os detalhes de sua pilha.
Para alterar qualquer um dos valores antes de iniciar a pilha, selecione **Editar** na seção que contém a configuração que deseja alterar.
1. (Opcional) É possível criar um conjunto de alterações para visualizar a configuração da pilha do antes de criá-la. Na página **Revisar e criar**, escolha **Criar conjunto de alterações** e siga as instruções. Para obter mais informações, consulte [Visualizar a configuração da sua pilha](#cfn-console-create-stacks-changesets).
1. Escolha **Enviar** para lançar sua pilha.
O CloudFormation criará todos os recursos definidos no modelo.
Você pode monitorar o progresso e o status da criação da pilha na guia **Eventos** da nova pilha. Para obter mais informações, consulte [Monitorar o progresso da pilha](monitor-stack-progress.md).
**Para criar uma pilha usando a linha de comando**
Você pode usar um dos comandos a seguir:
+ [https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-stack.html](https://docs.aws.amazon.com/cli/latest/reference/cloudformation/create-stack.html) (AWS CLI)
+ [https://docs.aws.amazon.com/powershell/latest/reference/items/New-CFNStack.html](https://docs.aws.amazon.com/powershell/latest/reference/items/New-CFNStack.html) (AWS Tools for Windows PowerShell)
Para obter exemplos de uso da linha de comando para criar uma pilha, consulte [Exemplos de comandos de operação de pilha do CloudFormation para o AWS CLI e o PowerShell](service_code_examples.md).
## Configurar opções da pilha
Na página **Configurar opções de pilha**, é possível configurar opções para as pilhas do CloudFormation, como etiquetas, notificação de eventos de pilha, ou uma política de pilha.
É possível definir as seguintes opções de pilha:
**Tags**
É possível adicionar até 50 pares de chave de etiquetas à sua pilha e a qualquer recurso para o qual o CloudFormation suporte a marcação. Uma etiqueta é uma chave e um valor definidos pelo cliente que podem ser atribuídos aos recursos da AWS para fins como controle de custos.
Uma **Chave** consiste em quaisquer caracteres alfanuméricos ou espaços. As chaves de tag podem ter até 127 caracteres.
Um **Valor** consiste em quaisquer caracteres alfanuméricos ou espaços. Os valores de tags podem ter até 255 caracteres.
Após a criação da pilha, adicionar, atualizar ou remover tags em nível de pilha iniciará uma atualização na pilha. Todos os recursos compatíveis com propagação de tags em nível des pilha também serão atualizados.
**permissões do**
Um perfil de serviço existente do IAM que o CloudFormation pode assumir. Em vez de usar as credenciais de sua conta, o CloudFormation usa as credenciais da função para criar a pilha. Para obter mais informações, consulte [Função de serviço do CloudFormation](using-iam-servicerole.md).
**Stack failure options (Opções de falha da pilha**
Especifica as opções de falha de provisionamento de todas as implantações de pilha e operações de conjunto de alterações. Para obter mais informações, consulte [Escolha como lidar com falhas ao provisionar recursos](stack-failure-options.md).
A opção **Roll back all stack resources** (Reverter todos os recursos da pilha) reverterá todos os recursos especificados no modelo quando o status da pilha for `CREATE_FAILED` ou `UPDATE_FAILED`.
Para operações de criação, a opção **Preserve successfully provisioned resources** (Preservar recursos provisionados com sucesso) preserva o estado dos recursos bem-sucedidos, enquanto os recursos com falha permanecerão em um estado de falha até que a próxima operação de atualização seja realizada.
Para operações de atualização e conjunto de alterações, a opção **Preserve successfully provisioned resources** (Preservar recursos provisionados com sucesso) preserva o estado dos recursos bem-sucedidos e reverte os recursos com falha para o último estado estável conhecido. Os recursos com falha estarão em um estado de `UPDATE_FAILED`. Os recursos sem um último estado estável conhecido serão excluídos na próxima operação de pilha.
Também é possível definir as seguintes opções avançadas para a criação da pilha:
**Política de pilha**
Define os recursos que você deseja proteger contra atualizações não intencionais durante uma atualização da pilha. Por padrão, todos os recursos podem ser atualizados durante uma atualização da pilha.
É possível inserir a política de pilha diretamente como JSON ou fazer upload de um arquivo JSON que contém a política de pilha. Para obter mais informações, consulte [Impedir atualizações nos recursos de pilha](protect-stack-resources.md).
**Configuração de reversão**
Você pode fazer com que o CloudFormation monitore o estado de sua pilha durante a criação e atualização de pilhas, e que você reverta essa operação se a pilha violar os limites de qualquer um dos alarmes especificados. Especifique os alarmes do CloudWatch que o CloudFormation deve monitorar. 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. Para obter mais informações, consulte [Reverta sua pilha do CloudFormation em caso de violação de alarme com acionadores de reversão](using-cfn-rollback-triggers.md).
**Opções de notificação**
É possível especificar um tópico novo ou existente do Amazon Simple Notification Service para onde as notificações sobre eventos de pilha são enviadas.
Se você criar um tópico do Amazon SNS, é necessário especificar um nome e um endereço de e-mail para onde as notificações de eventos de pilha deverão ser enviadas.
**Stack creation options (Opções de criação de pilha**
As opções a seguir estão inclusas para a criação da pilha, mas não estão disponíveis como parte das atualizações dela.
**Timeout (Tempo limite**
Especifica a quantidade de tempo, em minutos, que o CloudFormation deve alocar antes de exceder o tempo limite das operações de criação de pilha. Se o CloudFormation não puder criar a pilha inteira dentro do tempo alocado, além de não ser criada, a pilha será revertida.
Por padrão, não há tempo limite para criação da pilha. No entanto, recursos individuais podem ter seus próprios limites de tempo com base na natureza do serviço que implementam. Por exemplo, se um recurso individual em sua pilha expirar, a criação dela também expirará, ainda que o tempo limite especificado para a criação não tenha sido atingido.
**Termination protection**
Impede que uma pilha seja excluída acidentalmente. Se um usuário tentar excluir uma pilha com proteção contra encerramento ativada, a exclusão falhará e a pilha, incluindo o status dela, permanecerá inalterada. Para obter mais informações, consulte [Proteger pilhas do CloudFormation contra exclusão](using-cfn-protect-stacks.md).
Por padrão, a proteção contra encerramento está **Disabled (Desabilitada)**.
## Visualizar a configuração da sua pilha
Para visualizar como uma pilha do CloudFormation será configurada antes de criar a pilha, crie um conjunto de alterações. Essa funcionalidade permite que você examine várias configurações e faça correções e alterações na pilha antes de executar o conjunto de alterações. Para obter mais informações sobre conjuntos de alterações, consulte [Atualizar pilhas do CloudFormation usando conjuntos de alterações](using-cfn-updating-stacks-changesets.md).
### Criar um conjunto de alterações para uma pilha nova
Para criar um conjunto de alterações para uma pilha nova, selecione o modelo de pilha e especifique a configuração da pilha como você faria se estivesse criando uma nova pilha e escolha criar um novo conjunto de alterações em vez de uma nova pilha.
**Para criar um conjunto de alterações para uma nova pilha**
1. Na página **Revisar e criar**, escolha **Criar conjunto de alterações**.
1. Na caixa de diálogo **Criar conjunto de alterações**, insira um nome para o conjunto de alterações e uma descrição, se desejado. Escolha **Criar conjunto de alterações**.
Quando você cria um conjunto de alterações para uma nova pilha, o CloudFormation faz o seguinte:
+ Inicia uma nova pilha com um status de `REVIEW_IN_PROGRESS`.
+ Cria um conjunto de alterações para a nova pilha que reflete a configuração da pilha especificada nas etapas anteriores.
O CloudFormation exibe a página **Change sets** (Conjuntos de alterações) para a pilha proposta. Enquanto o CloudFormation cria o conjunto de alterações, o status é `CREATE_IN_PROGRESS`, e o status de execução é `UNAVAILABLE`. Quando o CloudFormation conclui com êxito a criação do conjunto de alterações, ele define o status do conjunto de alterações para `CREATE_COMPLETE` e o status de execução é `AVAILABLE`. O status da pilha é atualizado para `REVIEW_IN_PROGRESS`. Nesse ponto, você pode executar o conjunto de alterações para concluir a criação da nova pilha.
No painel **Changes** (Alterações), o CloudFormation exibe a configuração proposta da pilha.
Se o CloudFormation não conseguir criar o conjunto de alterações, ele definirá o status para `CREATE_FAILED`. Corrija o erro exibido no campo **Status reason** (Motivo do status) e crie um novo conjunto de alterações. Nesse estágio, você pode tentar várias configurações e fazer correções e alterações na pilha antes de executar o próximo conjunto de alterações.
1. Para concluir a criação de uma nova pilha com base no conjunto de alterações, escolha **Execute** (Executar), especifique sua configuração de reversão e depois escolha **Execute change set** (Executar conjunto de alterações).