Atualizar o AWS CloudFormation StackSets

Para atualizar um StackSet

1. Faça login no AWS Management Console e abra o console AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

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

3. No painel de navegação, escolha StackSets.

4. Na página StackSets, selecione o StackSet que você deseja atualizar.

5. Com o StackSet selecionado, escolha Editar detalhes do StackSet no menu Ações.

6. Na página Escolher um modelo, atualize a seção Permissões conforme necessário ou vá para a próxima etapa.

7. Em Pré-requisito: preparar o modelo, escolha Usar modelo atual para usar o modelo atual ou Substituir modelo atual para especificar um URL do S3 para outro modelo ou fazer upload de um novo modelo.

8. Escolha Próximo.

9. Na página Especificar detalhes do StackSet, em Descrição do StackSet, atualize a descrição do StackSet conforme necessário.

10. Em Parâmetros, atualize os valores dos parâmetros conforme necessário.

11. Escolha Próximo.

12. Na página Configurar opções do StackSet, em Tags, modifique as tags conforme necessário. É possível adicionar, atualizar ou excluir tags. Para obter mais informações sobre como as tags são usadas na AWS, consulte Organizar e acompanhar custos usando tags de alocação de custos da AWS no Guia do usuário do Gerenciamento de Faturamento e Custos da AWS.

13. Em Configuração de execução, é possível atualizar a configuração de execução conforme necessário.

    nota

    Lembre-se de que você não pode alterar as configurações de execução quando há operações em execução ou em fila.

14. 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.

15. Escolha Próximo.

16. Na página Definir opções de implantação, informe forneça as contas e regiões para a atualização.

    O CloudFormation implantará atualizações de pilhas nas contas especificadas na primeira região, depois passará para a próxima e assim por diante, desde que as falhas de implantação de uma região não excedam uma tolerância a falhas especificada.

    1. [Permissões autogerenciadas] Em Contas, Locais de implantação, escolha Implantar pilhas em contas. Cole os IDs das contas de destino usadas para criar o StackSet na caixa de texto, separando os números distintos com vírgulas.

       [Permissões gerenciadas pelo serviço] Siga um destes procedimentos:

       • Escolha Deploy to organizational units (OUs) (Implantar em unidades organizacionais (OUs)). Insira as UOs de destino que você usou para criar seu StackSet.

       • Escolha Deploy to accounts (Implantar em contas). Cole os IDs das UOs ou das contas de destino usados para criar seu StackSet.

    2. Em Especificar regiões, especifique a ordem na qual você deseja que o CloudFormation implemente suas atualizações.

    3. Em Opções de implantação, faça o seguinte:

       • Em Máximo de contas simultâneas, especifique quantas contas são processadas simultaneamente.

       • Em Tolerância a falhas, especifique o número máximo de falhas de conta permitidas por região. A operação será interrompida e não prosseguirá para outras regiões quando esse limite for atingido.

       • Em Simultaneidade de regiões, escolha o modo de processar as regiões: Sequencial (uma região de cada vez) ou Paralelo (várias regiões simultaneamente).

       • Em Modo de simultaneidade, escolha como a simultaneidade se comporta durante a execução de uma operação.

         • Tolerância a falhas estrita: reduz o nível de simultaneidade da conta quando ocorrem falhas, permanecendo dentro da faixa de Tolerância a falhas +1.

         • Tolerância a falhas flexível: mantém o nível de simultaneidade especificado (o valor de Máximo de contas simultâneas) a despeito de falhas.

    4. Escolha Próximo para continuar.

17. Na página Analisar, examine suas escolhas. Para fazer alterações, escolha Editar na seção relacionada.

18. Quando estiver pronto para prosseguir, escolha Enviar.

    O CloudFormation começa a aplicar as atualizações ao seu StackSet e exibe a guia Operações da página de detalhes do StackSet. É possível visualizar o progresso e o status das operações de atualização na guia Operations (Operações).

1. Para atualizar um StackSet

   Use o comando update-stack-set para fazer alterações no seu StackSet.

   Nos exemplos a seguir, vamos atualizar o StackSet usando a opção --parameters. Especificamente, alteramos a frequência de entrega do snapshot padrão para a configuração do canal de entrega de TwentyFour_Hours para Twelve_Hours. Como continuaremos a usar o modelo atual, adicionaremos a opção --use-previous-template.

   Defina o processamento simultâneo de contas e outras preferências de implantação usando a opção --operation-preferences. Esses exemplos usam configurações baseadas em contagem. Observe que MaxConcurrentCount não deve exceder FailureToleranceCount + 1. Para configurações baseadas em porcentagem, use FailureTolerancePercentage ou MaxConcurrentPercentage em vez disso.

   [Permissões autogerenciadas] Para a opção --accounts, forneça os IDs das contas que você deseja que a atualização tenha como destino.

   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template \
     --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \
     --accounts account_ID_1 account_ID_2 \
     --regions us-west-2 us-east-1 \
     --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0

   [Permissões gerenciadas pelo serviço] Na opção --deployment-targets, forneça o ID da raiz da organização ou os IDs das unidades organizacionais (UOs) às quais você deseja que a atualização se aplique.

   aws cloudformation update-stack-set --stack-set-name my-stackset \
     --use-previous-template \
     --parameters ParameterKey=MaximumExecutionFrequency,ParameterValue=Twelve_Hours \
     --deployment-targets OrganizationalUnitIds=ou-rcuk-1x5j1lwo,ou-rcuk-slr5lh0a \
     --regions us-west-2 us-east-1 \
     --operation-preferences MaxConcurrentCount=1,FailureToleranceCount=0

   Para obter mais informações, consulte UpdateStackSet na Referência de API do AWS CloudFormation.

2. Verifique se o StackSet foi atualizado com êxito executando o comando describe-stack-set-operation para mostrar o status e os resultados da operação de atualização. Em --operation-id, use o ID de operação que foi retornado pelo comando update-stack-set.

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