Criar uma pilha no console do CloudFormation
Este tópico descreve o processo criar uma pilha no console do CloudFormation. O console fornece uma interface orientada por um assistente com opções predefinidas para agilizar o processo de criação de pilhas.
Para criar uma nova pilha, você precisa fornecer um modelo do CloudFormation. Esse modelo é um arquivo de texto no formato JSON ou YAML que especifica os recursos que você deseja provisionar e as propriedades da configuração desses recursos. Para obter mais informações, consulte Trabalhar com modelos do CloudFormation.
Para obter exemplos de uso do comando create-stack da CLI para criar uma pilha, consulte Criar, atualizar e excluir pilhas do CloudFormation com o AWS CLI e o PowerShell.
Criar uma pilha
Siga as etapas desta seção para implantar seu modelo e criar uma pilha.
Para criar uma pilha do
-
Abra o console do AWS CloudFormation em https://console.aws.amazon.com/cloudformation
. -
Na barra de navegação na parte superior da tela, escolha a Região da AWS na qual a pilha deve ser criada.
-
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 Importe recursos da AWS para uma pilha do CloudFormation com uma importação de recursos.
-
Na página Criar uma pilha, faça o seguinte:
-
Para usar um modelo existente, em Preparar modelo, escolha O modelo está pronto. 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=à 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, no Guia do usuário do Amazon Simple Storage Service.version-idO 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/
, ou a AWS CLI. Para obter mais informações, consulte Definir o comportamento padrão da criptografia para os buckets do Amazon S3 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 não tiver um modelo pronto, você poderá escolher Usar um modelo de amostra para usar um modelo de amostra da biblioteca de modelos ou Criar a partir do Application Composer para criar um modelo com o Application Composer. Para obter mais informações, consulte Application Composer.
-
-
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.
-
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.
-
Na seção Parâmetros, especificam valores para os parâmetros que foram definidos no modelo.
-
Escolha Avançar para continuar criando a pilha.
-
(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.
-
Escolha Próximo para continuar.
-
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.
-
Se o seu modelo contiver recursos do IAM, marque a caixa de seleção de reconhecimento para reconhecer que o CloudFormation pode criar recursos do IAM com nomes personalizados. Para obter mais informações, consulte Confirmar recursos do IAM em modelos do CloudFormation.
-
(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.
-
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.
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:
-
É 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.
- Permissões
-
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 AWS CloudFormation.
- 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.
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_FAILEDouUPDATE_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.
- Rollback configuration (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
ALARMdurante 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. - 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.
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.
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
-
Na página Revisar e criar, escolha Criar conjunto de alterações.
-
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 paraCREATE_COMPLETEe o status de execução éAVAILABLE. O status da pilha é atualizado paraREVIEW_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. -
-
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).
