Actualizar la plantilla de pila - AWS CloudFormation

Actualizar la plantilla de pila

Para modificar los recursos o las propiedades de una pila de CloudFormation, debe actualizar la plantilla de la pila. Comience con la plantilla existente para esa pila y realice los cambios en ella. Si tiene su plantilla almacenada 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 desde 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 sin obtener una copia.

Puede modificar una plantilla de pila de CloudFormation por medio de Application Composer o de un editor de texto.

Actualizar una plantilla de pila existente mediante Application Composer

  1. En la página Pilas de la consola de CloudFormation, seleccione el nombre de la pila que desea actualizar.

  2. En el panel de detalles de la pila seleccionada, elija la pestaña Plantilla y, a continuación, elija Ver en Designer.

  3. CloudFormation abre la plantilla en Application Composer. Aquí puede arrastrar, soltar, configurar y conectar recursos (tarjetas) desde la paleta Recursos. Para más información consulte Cómo crear una composición en AWS Application Composer.

Para actualizar una plantilla de conjunto de pilas con la AWS CLI

  1. Para obtener la plantilla de la pila que desea actualizar, utilice el comando get-template de la CLI.

  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.

Tenga en cuenta los siguientes puntos cuando realice cambios en la plantilla:

  • No puede agregar, modificar o eliminar un parámetro utilizado por un recurso que no admite actualizaciones.

  • 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 iniciar una actualización.

  • Algunos recursos pueden tener restricciones en cuanto a los valores que se pueden establecer para determinadas propiedades. Por ejemplo, los cambios en la propiedad AllocatedStorage de una instancia de base de datos de RDS deben ser superiores al valor actual. Si la actualización infringe estas reglas, esa parte fallará.

  • La actualización de un recurso también puede afectar a otros que hagan referencia a él. Si usa funciones como Ref o GetAtt para establecer una propiedad basada en otro recurso, CloudFormation también actualizará el recurso de referencia cuando cambie el recurso al que se hace referencia.

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

nota

A veces, CloudFormation no permite ciertos cambios que intente realizar y le dirá que el cambio no está permitido. Este mensaje puede ocurrir de manera asincrónica, ya que CloudFormation crea y actualiza recursos en un orden no determinista de forma predeterminada.