Criar um conjunto de alterações - AWS CloudFormation

Criar um conjunto de alterações

Para criar um conjunto de alterações para uma pilha em execução, envie as alterações que você deseja fazer fornecendo um modelo modificado, novos valores de parâmetros de entrada ou ambos. O CloudFormation gera um conjunto de alterações comparando sua pilha com as alterações enviadas.

É possível modificar um modelo antes de criar o conjunto de alterações ou durante a criação do conjunto de alterações.

Create a change set for nested stacks (console)

Para criar um conjunto de alterações para pilhas aninhadas (console)

  1. No console do AWS CloudFormation, em Stacks (Pilhas), escolha a pilha em execução para a qual deseja criar um conjunto de alterações.

  2. No painel de detalhes da pilha, escolha Stack actions (Ações da pilha) e selecione Create change set for current stack (Criar conjunto de alterações da pilha atual).

  3. Na página Create change set for stack-name (Criar conjunto de alterações para nome-pilha), execute um dos seguintes procedimentos para modificar os valores do parâmetro de entrada, especificar a localização de um modelo de atualização ou modificar o modelo:

    Tarefa Ação
    Como modificar os valores do parâmetro de entrada Escolha Usar modelo atual e clique em Próximo para prosseguir e inserir ou modificar os valores do parâmetro de entrada.
    Como especificar a localização de um modelo atualizado

    Caso tenha modificado o modelo, escolha Replace current template (Substituir modelo atual) e execute um dos seguintes procedimentos:

    • 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 tiver um modelo em um bucket com versionamento ativado, você poderá indicar uma versão específica do modelo, como https://s3.amazonaws.com/templates/myTemplate.template?versionId=123ab1cdeKdOW5IH4GAcYbEngcpTJTDW. Para obter mais informações, consulte Gerenciar objetos em um bucket habilitado para versionamento no Guia do usuário do console do Amazon Simple Storage Service.

    • Para um modelo armazenado localmente em seu computador, escolha Upload a template file (Fazer upload de um arquivo de modelo). Escolha Choose File (Escolher arquivo) para navegar até o arquivo e selecioná-lo, depois escolha Next (Próximo).

    Como modificar o modelo Caso não tenha modificado o modelo, escolha Edit template in designer (Editar modelo no designer) e selecione View in designer (Exibir no designer). Você será redirecionado para o AWS CloudFormation Designer. Após ter modificado o modelo, escolha para retornar à página Create change set for stack-name (Criar conjunto de alterações para nome-pilha) e selecione Next (Próximo).
  4. Se o seu modelo contém parâmetros, na página Specify stack details (Especificar detalhes da pilha), insira ou modifique os valores do parâmetro de entrada aplicáveis e escolha Next (Próximo).

    Se você estiver reutilizando o modelo da pilha, o CloudFormation preencherá cada parâmetro com o valor atual nela, com exceção dos parâmetros declarados com o atributo NoEcho. Para usar os valores existentes para esses parâmetros, selecione Use existing value (Usar valor existente).

    Para obter mais informações sobre o uso de NoEcho para mascarar informações confidenciais, bem como o uso de parâmetros dinâmicos para gerenciar segredos, consulte a melhor prática Não incorporar credenciais em seus modelos.

  5. Na página Configure stack options (Configurar opções da pilha), atualize as tags da pilha, a função de serviço do IAM, a política da pilha, a configuração de reversão, o tópico de notificação do Amazon SNS (se for o caso) ou altere os conjuntos e escolha Next (Próximo).

    nota

    Os conjuntos de alterações para pilhas aninhadas são habilitados por padrão, o que criará conjuntos de alterações para todas as pilhas aninhadas especificadas em seu modelo. Para mais informações sobre conjuntos de alterações para pilhas aninhadas, consulte Conjuntos de alterações para pilhas aninhadas.

  6. Na página Review stack-name (Revisar nome-pilha), revise as alterações para esse conjunto de alterações.

    Se o modelo incluir recursos do AWS Identity and Access Management (IAM), selecione I acknowledge that CloudFormation might create IAM resources (Reconheço que CloudFormation poderá criar recursos do IAM). Os recursos do IAM podem modificar permissões em sua conta da AWS; analise esses recursos para garantir que você está permitindo apenas as ações pretendidas. Para obter mais informações, consulte Controlar o acesso com o AWS Identity and Access Management.

  7. Escolha Criar conjunto de alterações. Especifique um nome para o conjunto de alterações e, opcionalmente, especifique uma descrição do conjunto de alterações para identificar sua finalidade. Selecione Create change set (Criar conjunto de alterações).

    Você será redirecionado para a guia Changes (Alterações) da página de detalhes do conjunto de alterações. Enquanto o CloudFormation gera o conjunto de alterações, o status dele será CREATE_IN_PROGRESS. Depois de ter criado o conjunto de alterações, o CloudFormation definirá o status como CREATE_COMPLETE. Na seção Alterações, o CloudFormation relaciona todas as alterações que serão feitas em sua pilha. Para obter mais informações, consulte Visualizar um conjunto de alterações.

    
                  A página de detalhes do conjunto de alterações aninhadas.

    Se o CloudFormation falhar na criação do conjunto de alterações (exibindo o status FAILED), corrija o erro exibido no campo Status e recrie o conjunto de alterações.

Create a change set (console)

Para criar um conjunto de alterações (console)

  1. No console do AWS CloudFormation, em Stacks (Pilhas), escolha a pilha em execução para a qual deseja criar um conjunto de alterações.

  2. No painel de detalhes da pilha, escolha Stack actions (Ações da pilha) e selecione Create change set for current stack (Criar conjunto de alterações da pilha atual).

  3. Na página Create change set for stack-name (Criar conjunto de alterações para nome-pilha), execute um dos seguintes procedimentos para modificar os valores do parâmetro de entrada, especificar a localização de um modelo de atualização ou modificar o modelo:

    Tarefa Ação
    Como modificar os valores do parâmetro de entrada Escolha Usar modelo atual e clique em Próximo para prosseguir e inserir ou modificar os valores do parâmetro de entrada.
    Como especificar a localização de um modelo atualizado

    Caso tenha modificado o modelo, escolha Replace current template (Substituir modelo atual) e execute um dos seguintes procedimentos:

    • 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 tiver um modelo em um bucket com versionamento ativado, você poderá indicar uma versão específica do modelo, como https://s3.amazonaws.com/templates/myTemplate.template?versionId=123ab1cdeKdOW5IH4GAcYbEngcpTJTDW. Para obter mais informações, consulte Gerenciar objetos em um bucket habilitado para versionamento no Guia do usuário do console do Amazon Simple Storage Service.

    • Para um modelo armazenado localmente em seu computador, escolha Upload a template file (Fazer upload de um arquivo de modelo). Escolha Choose File (Escolher arquivo) para navegar até o arquivo e selecioná-lo, depois escolha Next (Próximo).

    Como modificar o modelo Caso não tenha modificado o modelo, escolha Edit template in designer (Editar modelo no designer) e selecione View in designer (Exibir no designer). Você será redirecionado para o AWS CloudFormation Designer. Após ter modificado o modelo, escolha para retornar à página Create change set for stack-name (Criar conjunto de alterações para nome-pilha) e selecione Next (Próximo).
  4. Se o seu modelo contém parâmetros, na página Specify stack details (Especificar detalhes da pilha), insira ou modifique os valores do parâmetro de entrada aplicáveis e escolha Next (Próximo).

    Se você estiver reutilizando o modelo da pilha, o CloudFormation preencherá cada parâmetro com o valor atual nela, com exceção dos parâmetros declarados com o atributo NoEcho. Para usar os valores existentes para esses parâmetros, selecione Use existing value (Usar valor existente).

    Para mais informações sobre o uso de NoEcho para mascarar informações confidenciais, bem como o uso de parâmetros dinâmicos para gerenciar segredos, consulte a prática recomendada Não incorporar credenciais em seus modelos.

  5. Na página Configure stack options (Configurar opções da pilha), atualize as tags da pilha, a função de serviço do IAM, a política da pilha, a configuração de reversão, o tópico de notificação do Amazon SNS (se for o caso) ou altere os conjuntos e escolha Next (Próximo).

    nota

    Os conjuntos de alterações para pilhas aninhadas são habilitados por padrão, o que criará conjuntos de alterações para todas as pilhas aninhadas especificadas em seu modelo. Para criar um conjunto de alterações apenas para a pilha atual, escolha Disabled (Desabilitado). Para mais informações sobre conjuntos de alterações para pilhas aninhadas, consulte Conjuntos de alterações para pilhas aninhadas.

  6. Na página Review stack-name (Revisar nome-pilha), revise as alterações para esse conjunto de alterações.

    Se o modelo incluir recursos do AWS Identity and Access Management (IAM), selecione I acknowledge that CloudFormation might create IAM resources (Reconheço que CloudFormation poderá criar recursos do IAM). Os recursos do IAM podem modificar permissões em sua conta da AWS; analise esses recursos para garantir que você está permitindo apenas as ações pretendidas. Para obter mais informações, consulte Controlar o acesso com o AWS Identity and Access Management.

  7. Escolha Criar conjunto de alterações. Especifique um nome para o conjunto de alterações e, opcionalmente, especifique uma descrição do conjunto de alterações para identificar sua finalidade. Selecione Create change set (Criar conjunto de alterações).

    Você será redirecionado para a guia Changes (Alterações) da página de detalhes do conjunto de alterações. Enquanto o CloudFormation gera o conjunto de alterações, o status dele será CREATE_IN_PROGRESS. Depois de ter criado o conjunto de alterações, o CloudFormation definirá o status como CREATE_COMPLETE. Na seção Alterações, o CloudFormation relaciona todas as alterações que serão feitas em sua pilha. Para obter mais informações, consulte Visualizar um conjunto de alterações.

    
                A página de detalhes do conjunto de alterações.

    Se o CloudFormation falhar na criação do conjunto de alterações (exibindo o status FAILED), corrija o erro exibido no campo Status e recrie o conjunto de alterações.

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

  • Execute o comando aws cloudformation create-change-set.

    Você envia suas alterações como opções de comando. Você pode especificar novos valores de parâmetros, um modelo modificado, ou ambos. Por exemplo, o comando a seguir cria um conjunto de alterações chamado SampleChangeSet para a pilha SampleStack. O conjunto de alterações usa o modelo da pilha atual, mas com um valor diferente para o parâmetro Purpose:

    aws cloudformation create-change-set --stack-name arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000 --change-set-name SampleChangeSet --use-previous-template --parameters ParameterKey="InstanceType",UsePreviousValue=true ParameterKey="KeyPairName",UsePreviousValue=true ParameterKey="Purpose",ParameterValue="production"