Visualización de un conjunto de cambios - AWS CloudFormation

Visualización de un conjunto de cambios

Después de crear un conjunto de cambios, puede ver los cambios propuestos antes de ejecutarlos. Puede utilizar la consola de CloudFormation, la AWS CLI o la API de CloudFormation para ver los conjuntos de cambios. La consola de proporciona un resumen de los cambios y una lista detallada de los cambios en formato JSON. Las API de AWS CLI y AWS CloudFormation devolverán una lista detallada de los cambios en formato JSON.

View a change set for nested stack (console)
Ver un conjunto de cambios para pilas anidadas (consola)
  1. En la consola de AWS CloudFormation, en Stacks (Pilas), seleccione el nombre de la pila que contiene el conjunto de cambios que desea ver.

  2. En el panel de navegación, seleccione Conjuntos de cambios para ver una lista con los conjuntos de cambios de la pila.

  3. Elija el nombre del conjunto de cambios que desee ver.

    La consola de CloudFormation lo dirigirá a la página de detalles del conjunto de cambios, donde podrá ver el momento de creación del conjunto de cambios, su estado, la información usada para generar el conjunto de cambios y un resumen de estos.

    En la sección Changes (Cambios), cada fila representa un recurso que CloudFormation agregará, modificará, eliminará o mostrará el estado dinámico.

    • Add (Agregar): crea un recurso al agregar un recurso a la plantilla de la pila.

    • Modify (Modificar): modifica un recurso cuando se cambian sus propiedades en la plantilla de la pila.

    • Remove (Eliminar): elimina un recurso al eliminar un recurso existente de la plantilla de la pila.

    • Dynamic (Dinámico): no se puede determinar la acción exacta de cambio de recursos a partir de la plantilla de la pila anidada.

    nota

    Una modificación puede provocar que se interrumpa o sustituya el recurso (recreado). Para obtener más información acerca de las conductas de actualización, consulte Comportamientos de actualización de los recursos de la pila.

    Para centrarse en determinados cambios, utilice la vista de filtro. Por ejemplo, filtrar un tipo de recurso específico, como AWS::CloudFormation::Stack. Para filtrar por recurso específico, especifique su ID físico o lógico, como DeadLetterQueue o NestedStack.

  4. En la sección Changes (Cambios) , elija View nested change set (Ver conjunto de cambios anidados) del conjunto de cambios anidados que desea ver.

    La consola de CloudFormation lo dirige a la página de detalles del conjunto de cambios anidado. Puede elegir Go to root change set (Ir al conjunto de cambios raíz) para ver el conjunto de cambios raíz o, puede elegir View parent chage set (Ver conjunto de cambios principal) para ver el conjunto de cambios principal. Para obtener más información, consulte Change sets for nested stacks (Conjuntos de cambios para pilas anidadas).

  5. En la sección Cambios, seleccione Ver detalles en la columna Cambios a nivel de propiedad para consultar el detalle de los cambios en los valores de la propiedad de un recurso.

  6. La consola de CloudFormation lo redirecciona a la página de cambios a nivel de propiedad para un recurso, en donde puede ver la configuración de la plantilla del recurso antes de la ejecución de un conjunto de cambios y una predicción de la configuración luego de la ejecución del conjunto.

    En la tabla de la sección de cambios a nivel de propiedad, puede ver los valores de Ruta, Tipo de cambio, Valor previo y Valor posterior para las propiedades afectadas. En la tabla, seleccione la casilla de verificación para cada cambio que quiera destacar en las vistas Previo y Posterior de la plantilla a fin de ver los cambios que se realizarán a nivel de propiedad.

    • Agregar: las propiedades agregadas se resaltan en color verde.

    • Modificar: las propiedades modificadas se resaltan en color azul.

    • Eliminar: las propiedades eliminadas se resaltan en color rojo.

View a change set (console)
Ver un conjunto de cambios (consola)
  1. En la consola de AWS CloudFormation, en Stacks (Pilas), seleccione el nombre de la pila que contiene el conjunto de cambios que desea ver.

  2. En el panel de navegación, elija Change Sets (Conjuntos de cambios) para ver una lista con los conjuntos de cambios de la pila.

  3. Elija el nombre del conjunto de cambios que desee ver.

    La consola de CloudFormation lo dirigirá a la página de detalles del conjunto de cambios, donde podrá ver el momento de creación del conjunto de cambios, su estado, la información usada para generar el conjunto de cambios y un resumen de estos.

    En la sección Changes (Cambios), cada fila representa un recurso que CloudFormation agregará, modificará o eliminará.

    • Add (Agregar): crea un recurso al agregar un recurso a la plantilla de la pila.

    • Modify (Modificar): modifica un recurso cuando se cambian sus propiedades en la plantilla de la pila.

    • Remove (Eliminar): elimina un recurso al eliminar un recurso existente de la plantilla de la pila.

    nota

    Una modificación puede provocar que se interrumpa o sustituya el recurso (recreado). Para obtener más información acerca de las conductas de actualización, consulte Comportamientos de actualización de los recursos de la pila.

    Para centrarse en determinados cambios, utilice la vista de filtro. Por ejemplo, filtrar un tipo de recurso específico, como AWS::EC2::Instance. Para filtrar por recurso específico, especifique su ID físico o lógico, como myWebServer o i-123abcd4.

  4. En la sección Cambios, seleccione Ver detalles en la columna Cambios a nivel de propiedad para consultar los cambios en los valores que se realizaron en los recursos.

  5. La consola de CloudFormation lo redirecciona a la página de cambios a nivel de propiedad para un recurso, en donde puede ver la configuración de la plantilla del recurso antes de la ejecución de un conjunto de cambios y una predicción de la configuración luego de la ejecución del conjunto.

    En la tabla de la sección de cambios a nivel de propiedad, puede ver los valores de Ruta, Tipo de cambio, Valor previo y Valor posterior para las propiedades afectadas. En la tabla, seleccione la casilla de verificación para cada cambio que quiera destacar en las vistas Previo y Posterior de la plantilla a fin de ver los cambios que se realizarán a nivel de propiedad.

    • Agregar: las propiedades agregadas se resaltan en color verde.

    • Modificar: las propiedades modificadas se resaltan en color azul.

    • Eliminar: las propiedades eliminadas se resaltan en color rojo.

Ver un conjunto de cambios (AWS CLI)
  1. Para obtener el ID del conjunto de cambios, ejecute el comando aws cloudformation list-change-sets.

    Especifique el ID de pila de la pila que tenga el conjunto de cambios que desea ver, tal y como se muestra en el ejemplo siguiente:

    $ aws cloudformation list-change-sets \ --stack-name arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000

    CloudFormation devuelve una lista de conjuntos de cambios, similar a esta:

    { "Summaries": [ { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000", "Status": "CREATE_COMPLETE", "ChangeSetName": "SampleChangeSet", "CreationTime": "2020-11-18T20:44:05.889Z", "StackName": "SampleStack", "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet/1a2345b6-0000-00a0-a123-00abc0abc000" }, { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000", "Status": "CREATE_COMPLETE", "ChangeSetName": "SampleChangeSet-conditional", "CreationTime": "2020-11-18T21:15:56.398Z", "StackName": "SampleStack", "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-conditional/1a2345b6-0000-00a0-a123-00abc0abc000" }, { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000", "Status": "CREATE_COMPLETE", "ChangeSetName": "SampleChangeSet-replacement", "CreationTime": "2020-11-18T21:03:37.706Z", "StackName": "SampleStack", "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-replacement/1a2345b6-0000-00a0-a123-00abc0abc000" } ] }
  2. Ejecute el comando aws cloudformation describe-change-set, especificando el ID del conjunto de cambios que desea ver. Por ejemplo:

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

    CloudFormation devuelve información sobre el conjunto de cambios especificado:

    { "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/SampleStack/1a2345b6-0000-00a0-a123-00abc0abc000", "Status": "CREATE_COMPLETE", "ChangeSetName": "SampleChangeSet-direct", "Parameters": [ { "ParameterValue": "testing", "ParameterKey": "Purpose" }, { "ParameterValue": "ellioty-useast1", "ParameterKey": "KeyPairName" }, { "ParameterValue": "t2.micro", "ParameterKey": "InstanceType" } ], "Changes": [ { "ResourceChange": { "ResourceType": "AWS::EC2::Instance", "PhysicalResourceId": "i-1abc23d4", "Details": [ { "ChangeSource": "DirectModification", "Evaluation": "Static", "Target": { "Attribute": "Tags", "RequiresRecreation": "Never" } } ], "Action": "Modify", "Scope": [ "Tags" ], "LogicalResourceId": "MyEC2Instance", "Replacement": "False" }, "Type": "Resource" } ], "CreationTime": "2020-11-18T23:35:25.813Z", "Capabilities": [], "StackName": "SampleStack", "NotificationARNs": [], "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/SampleChangeSet-direct/9edde307-960d-4e6e-ad66-b09ea2f20255" }

    Utilice --include-property-values con describe-change-set para enumerar los cambios a nivel de propiedad.

    La clave Changes enumera los cambios de los recursos. Si fuera a ejecutar este conjunto de cambios, CloudFormation actualizaría las etiquetas de la instancia de EC2 i-1abc23d4. Para obtener una descripción de cada campo, consulte Change el tipo de datos en la referencia de la API de AWS CloudFormation.

    Para obtener más ejemplos de conjuntos de cambio, consulte Ejemplo de conjuntos de cambio.

Consulta de los cambios a nivel de propiedad en un conjunto de cambios (AWS CLI)
  • El comando que figura a continuación muestra los cambios a nivel de propiedad relacionados con un conjunto de cambios para un recurso AWS::EC2::NetworkInterface que elimina la propiedad Ipv4Prefixes, modifica la Description del recurso y agrega una Tag:

    $ aws cloudformation describe-change-set --include-property-values --change-set-name arn:aws:cloudformation:us-east-1:123456789012:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841
    "ChangeSetName": "ExampleChangeSet", "ChangeSetId": "arn:aws:cloudformation:us-east-1:803642222207:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841", "StackId": "arn:aws:cloudformation:us-east-1:803642222207:stack/ExampleStack/ab664180-f686-11ee-9e29-12cd92393671", "StackName": "ExampleStack", "Description": null, "Parameters": null, "CreationTime": "2024-04-09T18:04:59.935000+00:00", "ExecutionStatus": "AVAILABLE", "Status": "CREATE_COMPLETE", "StatusReason": null, "NotificationARNs": [], "RollbackConfiguration": { "RollbackTriggers": [] }, "Capabilities": [], "Tags": null, "ParentChangeSetId": null, "IncludeNestedStacks": true, "RootChangeSetId": null, "OnStackFailure": null, { "Changes": [ { "Type": "Resource", "ResourceChange": { "Action": "Modify", "LogicalResourceId": "EC2NetworkInterface00eni067fd35b649a05b7100Tpyls", "PhysicalResourceId": "eni-067fd35b649a05b71", "ResourceType": "AWS::EC2::NetworkInterface", "Replacement": "False", "Scope": [ "Properties", "Tags" ], "Details": [ { "Target": { "Attribute": "Properties", "Name": "Ipv4Prefixes", "RequiresRecreation": "Never", "Path": "/Properties/Ipv4Prefixes", "BeforeValue": "[]", "AttributeChangeType": "Remove" }, "Evaluation": "Static", "ChangeSource": "DirectModification" }, { "Target": { "Attribute": "Properties", "Name": "Description", "RequiresRecreation": "Never", "Path": "/Properties/Description", "BeforeValue": "", "AfterValue": "Description", "AttributeChangeType": "Modify" }, "Evaluation": "Static", "ChangeSource": "DirectModification" }, { "Target": { "Attribute": "Tags", "RequiresRecreation": "Never", "Path": "/Properties/Tags/0", "AfterValue": "{\"Key\":\"Test\",\"Value\":\"Test\"}", "AttributeChangeType": "Add" }, "Evaluation": "Static", "ChangeSource": "DirectModification" } ], "BeforeContext": "{\"Properties\":{\"Description\":\"\",\"PrivateIpAddress\":\"172.31.76.2\",\"PrivateIpAddresses\":[{\"PrivateIpAddress\":\"172.31.76.2\",\"Primary\":\"true\"}],\"SecondaryPrivateIpAddressCount\":\"0\",\"Ipv6PrefixCount\":\"0\",\"Ipv4Prefixes\":[],\"Ipv4PrefixCount\":\"0\",\"GroupSet\":[\"sg-05a45689b1059e82d\"],\"Ipv6Prefixes\":[],\"SubnetId\":\"subnet-455e8969\",\"SourceDestCheck\":\"true\",\"InterfaceType\":\"interface\",\"Tags\":[]},\"UpdateReplacePolicy\":\"Retain\",\"DeletionPolicy\":\"Retain\"}", "AfterContext": "{\"Properties\":{\"Description\":\"Description\",\"PrivateIpAddress\":\"172.31.76.2\",\"PrivateIpAddresses\":[{\"PrivateIpAddress\":\"172.31.76.2\",\"Primary\":\"true\"}],\"SecondaryPrivateIpAddressCount\":\"0\",\"Ipv6PrefixCount\":\"0\",\"Ipv4PrefixCount\":\"0\",\"GroupSet\":[\"sg-05a45689b1059e82d\"],\"Ipv6Prefixes\":[],\"SubnetId\":\"subnet-455e8969\",\"SourceDestCheck\":\"true\",\"InterfaceType\":\"interface\",\"Tags\":[{\"Value\":\"Test\",\"Key\":\"Test\"}]},\"UpdateReplacePolicy\":\"Retain\",\"DeletionPolicy\":\"Retain\"}" } } ], "ChangeSetName": "ExampleChangeSet", "ChangeSetId": "arn:aws:cloudformation:us-east-1:123456789012:changeSet/ExampleChangeSet/9f7b541b-126b-44f7-998e-932174557841", "StackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/ExampleStack/ab664180-f686-11ee-9e29-12cd92393671",