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 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. Abra o console do AWS CloudFormation em https://console.aws.amazon.com/cloudformation.

  2. Na página Pilhas, selecione a pilha em execução para a qual você deseja criar um conjunto de alterações.

  3. 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).

  4. 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 existente e depois Avançar para prosseguir e inserir ou modificar os valores dos parâmetros de entrada.
    Como especificar a localização de um modelo atualizado

    Se você modificou o modelo, escolha Substituir modelo existente e faça uma das seguintes alternativas:

    • 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=version-id 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.

    • 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 Se não tiver modificado o modelo, escolha Editar modelo no Compositor de Aplicações e depois selecione Editar no Compositor de Aplicações. Você será redirecionado para o AWS Infrastructure Composer. Após modificar o modelo, escolha Criar conjunto de alterações e depois Confirmar e continuar no CloudFormation para voltar à página Criar conjunto de alterações para a stack-name, em seguida, escolha Avançar.

  5. Na página Especificar detalhes da pilha, especifique um nome para o conjunto de alterações e, opcionalmente, especifique uma descrição do conjunto de alterações para identificar sua finalidade na seção Visão geral. 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 ocultar informações confidenciais e sobre o uso de parâmetros dinâmicos para gerenciar segredos, consulte a melhor prática Não incorporar credenciais em seus modelos.

  6. Na página Configure stack options (Configurar opções da pilha), atualize as tags da pilha, o perfil 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 obter mais informações sobre os conjuntos de alterações para pilhas aninhadas, consulte Conjuntos de alteração para pilhas aninhadas.

  7. 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 pode criar recursos do IAM). Os recursos do IAM podem modificar as permissões na sua conta da AWS. Analise esses recursos para garantir que você está permitindo apenas as ações que deseja. Para obter mais informações, consulte Controlar o acesso com o AWS Identity and Access Management.

  8. Selecione Enviar.

    Você será redirecionado para a guia Changes (Alterações) da página de detalhes do conjunto de alterações. Enquanto o CloudFormation está gerando o conjunto de alterações, o status do conjunto de alteações é CREATE_PENDING. 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.

    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.

  9. Depois de confirmar que as alterações parecem estar corretas, escolha Executar conjunto de alterações

Create a change set (console)
Para criar um conjunto de alterações (console)

  1. No console do CloudFormation, em 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 existente e depois Avançar para prosseguir e inserir ou modificar os valores dos parâmetros de entrada.
    Como especificar a localização de um modelo atualizado

    Se você modificou o modelo, escolha Substituir modelo existente e faça uma das seguintes alternativas:

    • 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=version-id 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.

    • 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 Se não tiver modificado o modelo, escolha Editar modelo no Compositor de Aplicações e depois selecione Editar no Compositor de Aplicações. Você será redirecionado para o AWS Infrastructure Composer. Após modificar o modelo, escolha Criar conjunto de alterações e depois Confirmar e continuar no CloudFormation para voltar à página Criar conjunto de alterações para a stack-name, em seguida, escolha Avançar.

  4. Na página Especificar detalhes da pilha, especifique um nome para o conjunto de alterações e, opcionalmente, especifique uma descrição do conjunto de alterações para identificar sua finalidade na seção Visão geral. 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 ocultar informações confidenciais e sobre 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, o perfil 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 obter mais informações sobre os conjuntos de alterações para pilhas aninhadas, consulte Conjuntos de alteração 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 pode criar recursos do IAM). Os recursos do IAM podem modificar as permissões na sua conta da AWS. Analise esses recursos para garantir que você está permitindo apenas as ações que deseja. Para obter mais informações, consulte Controlar o acesso com o AWS Identity and Access Management.

  7. Selecione Enviar.

    Você será redirecionado para a guia Changes (Alterações) da página de detalhes do conjunto de alterações. Enquanto o CloudFormation está gerando o conjunto de alterações, o status do conjunto de alteações é CREATE_PENDING. 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.

    Escolha Visualizar detalhes na coluna Alterações no nível da propriedade para visualizar as alterações feitas no nível da propriedade.

    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.

  8. Depois de confirmar que as alterações parecem estar corretas, escolha Executar conjunto de alterações

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

  • Execute o comando 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"