View a markdown version of this page

Executar um conjunto de alterações para uma pilha do CloudFormation - AWS CloudFormation

Executar um conjunto de alterações para uma pilha do CloudFormation

Para fazer as modificações descritas em um conjunto de alterações em sua pilha, execute o conjunto de alterações.

Importante

Depois de executar um conjunto de alterações, o CloudFormation exclui qualquer conjunto de alterações que esteja associado à pilha, já que não são mais válidos para a pilha atualizada. Se uma atualização falhar, você precisará criar um novo conjunto de alterações.

nota

Se o conjunto de alterações tiver sido criado no modo expresso (--deployment-config '{"mode": "EXPRESS"}'), o CloudFormation aplicará o modo expresso quando você executa o conjunto de alterações. O modo expresso conclui as operações de recursos assim que a configuração é aplicada, sem esperar pela estabilização total. Para obter mais informações, consulte Modo Expresso.

Políticas de pilha e como executar um conjunto de alterações

Se você executar um conjunto de alterações em uma pilha que tenha uma política de pilha associada a ela, o CloudFormation impõe a política ao atualizá-la. Não é possível especificar uma política de pilha temporária que substitua a existente ao executar um conjunto de alterações. Para atualizar um recurso protegido, é necessário atualizar a política de pilha ou usar o método de atualização direta. Para obter mais informações, consulte Atualizar pilhas diretamente.

Execute a change set (console)
Para executar um conjunto de alterações

  1. Abra o console do CloudFormation em https://console.aws.amazon.com/cloudformation.

  2. Na barra de navegação na parte superior da tela, escolha sua Região da AWS.

  3. Na página Pilhas, escolha o nome da pilha em execução que você deseja atualizar.

  4. No painel de navegação, escolha Conjuntos de alterações para visualizar uma lista dos conjuntos de alterações da pilha.

  5. Escolha o nome do conjunto alterações que deseja executar.

  6. Na página de detalhes do conjunto de alterações, escolha Executar conjunto de alterações.

    O CloudFormation inicia a atualização da pilha imediatamente. O console do CloudFormation direciona você para a guia Eventos, em que é possível monitorar o progresso da atualização da pilha. Para obter mais informações, consulte Monitorar o progresso da pilha.

Execute a change set for nested stacks (console)
Para executar um conjunto de alterações para pilhas aninhadas

  1. Abra o console do CloudFormation em https://console.aws.amazon.com/cloudformation.

  2. Na barra de navegação na parte superior da tela, escolha sua Região da AWS.

  3. Na página Pilhas, escolha o nome da pilha em execução que você deseja atualizar. Você deve escolher o nome da pilha associado ao conjunto raiz de alterações.

  4. No painel de navegação, escolha Conjuntos de alterações para visualizar uma lista dos conjuntos de alterações da pilha.

  5. Escolha o nome do conjunto raiz de alterações que deseja executar.

  6. Na página de detalhes do conjunto de alterações, escolha Executar conjunto de alterações.

    nota

    O CloudFormation executa as alterações descritas no seu conjunto raiz de alterações e conjuntos de alterações aninhadas, se a opção Habilitado para conjuntos de alterações para pilhas aninhadas tiver sido selecionada durante o processo Criar um conjunto de alterações para uma pilha do CloudFormation.

    O CloudFormation inicia a atualização da pilha imediatamente. O console do CloudFormation direciona você para a guia Eventos, em que é possível monitorar o progresso da atualização da pilha. Para obter mais informações, consulte Monitorar o progresso da pilha.

Para executar um conjunto de alterações (AWS CLI)

  • Execute o comando execute-change-set.

    Especifique o ID do conjunto de alterações que deseja executar, como mostrado no exemplo a seguir:

    aws cloudformation execute-change-set \
    --change-set-name \
      arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000

    O comando no exemplo executa um conjunto de alterações com o ID arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000.

    Depois de executar o comando, o CloudFormation inicia a atualização da pilha. Para visualizar o progresso da pilha, use o comando describe-stacks.