Atualizar pilhas diretamente
Quando você deseja implementar rapidamente atualizações em sua pilha, execute uma atualização direta. Com uma atualização direta, você envia um modelo ou parâmetros de entrada que especificam as atualizações dos recursos na pilha e o CloudFormation as implanta imediatamente. Se você quiser usar um modelo para fazer as atualizações, é possível modificar o modelo atual e armazená-lo localmente ou em um bucket do Amazon S3.
Para propriedades de recursos que não suportam atualizações, você deve manter os valores atuais. Para visualizar as alterações que o CloudFormation fará em sua pilha antes de atualizá-la, use conjuntos de alterações. Para ter mais informações, consulte Atualizar pilhas do CloudFormation usando conjuntos de alterações.
Ao atualizar uma pilha, o CloudFormation pode interromper os recursos ou substituir os recursos atualizados, dependendo de quais propriedades você atualiza. Para obter mais informações sobre os comportamentos de atualização de recursos, consulte Compreender atualização de comportamentos de recursos da pilha.
Para atualizar uma pilha de (console)
-
Faça login no AWS Management Console e abra o console AWS CloudFormation em https://console.aws.amazon.com/cloudformation
. -
Na barra de navegação na parte superior da tela, escolha sua Região da AWS.
-
Na página Pilhas, selecione a pilha em execução que você deseja atualizar.
-
No painel de detalhes da pilha, escolha Update (Atualizar).
-
Se você não modificou o modelo de pilha, selecione Usar modelo existente e escolha Avançar.
Se você modificou o modelo, selecione Substituir o modelo existente e especifique a localização do modelo atualizado na seção Especificar modelo:
-
Para um modelo armazenado localmente em seu computador, selecione Upload a template file (Fazer upload de um arquivo de modelo). Selecione Escolher arquivo para navegar até o arquivo e selecioná-lo, depois escolha Próximo.
nota
Se você carregar um arquivo de modelo local, o CloudFormation o carregará dele em um bucket do Amazon Simple Storage Service (Amazon S3) na sua Conta da AWS. Se você ainda não tiver um bucket do S3 que foi criado pelo CloudFormation, ele criará um bucket exclusivo para cada Região na qual você faz upload de um arquivo de modelo. 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.
Considerações para se ter em mente sobre 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.
-
-
Para um modelo armazenado no bucket do Amazon S3, escolha Amazon S3 URL (URL do Amazon S3). Digite ou cole o URL do modelo e escolha Next (Próximo).
Se você tiver um modelo em um bucket com versionamento habilitado, poderá especificar uma versão específica do modelo anexando
?versionId=
ao URL. Para obter mais informações, consulte Trabalhar com objetos em um bucket com versionamento habilitado no Guia do usuário do Amazon Simple Storage Service.version-id
Se algum problema de sintaxe for detectado, o console fornecerá mensagens de erro que ajudarão você a corrigir o modelo.
-
-
Se o seu modelo contém parâmetros, na página Especificar detalhes da pilha, é possível inserir ou modificar os valores dos parâmetros, depois escolha Próximo.
O CloudFormation preenche cada parâmetro com o valor que está definido atualmente na pilha, com exceção de parâmetros declarados com o atributo
NoEcho
. No entanto, ainda é possível usar os valores atuais ao marcar Usar valor existente.Para obter mais informações sobre o uso de
NoEcho
para mascarar informações confidenciais, além do uso de parâmetros dinâmicos para gerenciar segredos, consulte a prática recomendada Não incorporar credenciais em seus modelos. -
Na página Configure stack options (Configurar opções da pilha), é possível atualizar as tags e as permissões aplicadas à pilha e modificar opções avançadas como política de pilha, configurar a reversão ou atualizar o tópico de notificação do Amazon SNS. Para obter mais informações sobre essas opções, consulte Configurar opções da pilha.
-
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 ter mais informações, consulte Confirmar recursos do IAM em modelos do CloudFormation.
-
Escolha Próximo para continuar.
-
Analise as informações e as alterações da pilha que você enviou.
Verifique se você enviou as informações corretas, como os valores de parâmetro ou modelo de URL correto.
Na seção Visualização do conjunto de alterações, verifique se o CloudFormation fará todas as alterações esperadas. Por exemplo, é possível verificar se o CloudFormation adiciona, remove e modifica os recursos que você pretende adicionar, remover ou modificar. O CloudFormation gera esta pré-visualização criando um conjunto de alterações para a pilha. Para ter mais informações, consulte Atualizar pilhas do CloudFormation usando conjuntos de alterações.
-
Quando estiver satisfeito com as suas alterações, clique em Update stack (Atualizar pilha).
nota
Nesse ponto, você também tem a opção de visualizar o conjunto de alterações para rever as atualizações propostas mais cuidadosamente. Para isso, escolha View change set (Visualizar conjunto de alterações) em vez de Update stack (Atualizar pilha). O CloudFormation mostra o conjunto de alterações gerado com base nas suas atualizações. Quando estiver pronto para executar a atualização da pilha, clique em Executar.
O CloudFormation exibe a página de detalhes para a sua pilha, com o painel Events (Eventos) selecionado. Sua pilha agora tem um status de
UPDATE_IN_PROGRESS
. Depois que o CloudFormation tiver concluído com êxito a atualização da pilha, ele definirá o status da pilha comoUPDATE_COMPLETE
.Caso a atualização da pilha falhe, o CloudFormation reverterá automaticamente as alterações e definirá o status como
UPDATE_ROLLBACK_COMPLETE
.nota
É possível cancelar uma atualização enquanto ela está no estado
UPDATE_IN_PROGRESS
. Para ter mais informações, consulte Cancelar uma atualização de pilha.
Para atualizar uma pilha usando a linha de comando
Você pode usar um dos comandos a seguir:
-
update-stack (AWS CLI)
-
Update-CFNStack (AWS Tools for Windows PowerShell)
Para obter exemplos de uso de linha de comando para atualizar uma pilha, consulte Exemplos de comandos de operação de pilha do CloudFormation para o AWS CLI e o PowerShell.