Modificación de una plantilla de pila - AWS CloudFormation

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Modificación de una plantilla de pila

Si desea modificar los recursos y propiedades declarados en una plantilla de pila, debe modificar la plantilla de la pila. Para garantizar que actualiza únicamente los recursos que desea actualizar, utilice la plantilla de la pila existente como punto de partida y realice las actualizaciones en esa plantilla. Si está administrando su plantilla en un sistema de control de recursos, utilice una copia de dicha plantilla como punto de partida. De lo contrario, puede obtener una copia de la plantilla de la pila de AWS CloudFormation.

Si solo desea modificar los parámetros o los ajustes de una pila (como por ejemplo el tema de Amazon SNS de una pila), puede volver a utilizar la plantilla de la pila existente. No es necesario que obtenga una copia de la plantilla de la pila o que realice modificaciones en la plantilla de la pila.

nota

Si la plantilla incluye un cambio no admitido, AWS CloudFormation devuelve un mensaje diciendo que el cambio no está permitido. No obstante, este mensaje podría ocurrir de forma asíncrona porque AWS CloudFormation crea y actualiza recursos siguiendo un orden no determinístico de forma predeterminada.

Actualización de la plantilla de una pila (consola)

  1. En la página Stacks (Pilas) de la consola de AWS CloudFormation, haga clic en el nombre de la pila que desea actualizar.

  2. En el panel de detalles de la pila seleccionada, seleccione el panel Template (Plantilla) y, a continuación, haga clic en View in Designer (Ver en Designer).

    AWS CloudFormation abre una copia de la plantilla de pila en AWS CloudFormation Designer.

  3. Modifique la plantilla.

    Puede utilizar la interfaz de arrastrar y soltar de AWS CloudFormation Designer o el editor de JSON y YAML integrado para modificar la plantilla. Para obtener más información acerca del uso de AWS CloudFormation Designer, consulte ¿Qué es AWS CloudFormation Designer?.

    Modifique únicamente los recursos que desea actualizar. Utilice los mismos valores que la actual configuración de la pila para los recursos y propiedades que no está actualizando. Puede modificar la plantilla completando cualquiera de las siguientes acciones:

    • Añada nuevos recursos o elimine los recursos existentes.

      Para la mayoría de los recursos, cambiar el nombre lógico de un recurso equivale a la eliminación de ese recurso y a la sustitución por otro nuevo. Cualquier otros recurso que dependa del recurso cuyo nombre se ha cambiado también tendrá que actualizarse y podría provocar su reemplazo. Otros recursos requieren que actualice una propiedad (no solo el nombre lógico) para activar una actualización.

    • Añadir, modificar o eliminar las propiedades de los recursos existentes.

      Consulte la Referencia de tipos de recursos de AWS para obtener información acerca de los efectos de la actualización de propiedades específicas de recursos. Para cada propiedad, los efectos de una actualización serán uno de los siguientes:

    • Añadir, modificar o eliminar atributos para recursos (Metadata, DependsOn, CreationPolicy, UpdatePolicy y DeletionPolicy).

      importante

      No puede actualizar el atributo CreationPolicy, DeletionPolicy o UpdatePolicy por sí mismo. Puede actualizarlos solo cuando incluye cambios que añaden, modifican o eliminan recursos. Por ejemplo, puede añadir o modificar un atributo de metadatos de un recurso.

    • Añadir, modificar o eliminar declaraciones de parámetros. Sin embargo, no puede añadir, modificar o eliminar un parámetro utilizado por un recurso que no admite actualizaciones.

    • Añadir, modificar o eliminar declaraciones de mapeos.

      importante

      Si su pila no utiliza los valores de una mapeo, no puede actualizar la asignación por sí misma. Debe incluir cambios que añaden, modifican o eliminan recursos. Por ejemplo, puede añadir o modificar un atributo de metadatos de un recurso. Si actualiza un valor de mapeo que la pila está utilizando, no es necesario realizar ningún otro cambio para activar una actualización.

    • Añadir, modificar o eliminar declaraciones de condiciones.

      importante

      No puede actualizar condiciones por sí mismas. Puede actualizar condiciones solo cuando incluye cambios que añaden, modifican o eliminan recursos. Por ejemplo, puede añadir o modificar un atributo de metadatos de un recurso.

    • Añadir, modificar o eliminar declaraciones de valores de salida.

    Algunos recursos o propiedades pueden tener limitaciones sobre los valores de la propiedad o cambios a esos valores. Por ejemplo, los cambios en la propiedad AllocatedStorage de un recurso AWS::RDS::DBInstance deben ser superiores a la configuración actual. Si el valor especificado para la actualización no cumple estas restricciones, la actualización de dicho recurso falla. Para las limitaciones específicas en cambios de AllocatedStorage, consulte ModifyDBInstance.

    Las actualizaciones de un recurso pueden afectar a las propiedades de otros recursos. Si utilizó la función Ref o la función Fn::GetAtt para especificar un atributo de un recurso actualizado como parte de un valor de propiedad en otro recurso en la plantilla, AWS CloudFormation también actualiza el recurso que contiene la referencia a la propiedad que ha cambiado. Por ejemplo, si actualizó la propiedad MasterUsername de un recurso AWS::RDS::DBInstance y tenía un recurso AWS::AutoScaling::LaunchConfiguration con una propiedad UserData que contenía una referencia al nombre de la instancia de base de datos mediante la función Ref, AWS CloudFormation vuelve a crear la instancia de base de datos con un nombre nuevo y también actualiza el recurso LaunchConfiguration.

  4. Para comprobar si hay errores de sintaxis en la plantilla, desde la barra de herramientas AWS CloudFormation Designer elija Validate template (Validar plantilla) .

    Vea y arregle cualquier error en el panel Messages (Mensajes) y, a continuación, valide de nuevo la plantilla. Si no ve ningún error, su plantilla es válida desde el punto de vista sintáctico.

  5. Desde la barra de herramientas de AWS CloudFormation Designer, seleccione el menú File (Archivo) ( ) y, a continuación, Save (Guardar) para guardar la plantilla en un bucket de S3 o localmente.

  6. Utilice la plantilla modificada para actualizar la pila directamente o actualice la pila mediante un conjunto de cambios.

Obtención y actualización de una plantilla para una pila (CLI)

  1. Para obtener la plantilla para la pila que desea actualizar, utilice el comando aws cloudformation get-template.

  2. Copie la plantilla, péguela en un archivo de texto, modifíquela y guárdela. Copie únicamente la plantilla. El comando encierra la plantilla entre comillas, pero no copia las comillas alrededor de la plantilla. La plantilla comienza con una llave de apertura y termina con la llave de cierre final. Especifique los cambios a los recursos de la pila en este archivo.

  3. Utilice la plantilla modificada para actualizar la pila directamente o actualice la pila mediante un conjunto de cambios.