Creación de una pila en la consola de CloudFormation
En este tema se describe el proceso de creación de una pila desde la consola de CloudFormation. La consola proporciona una interfaz guiada por un asistente con opciones predefinidas que agilizan el proceso de creación de la pila.
Para crear una pila nueva, debe proporcionar una plantilla de CloudFormation. Esta plantilla es un archivo de texto con formato JSON o YAML que especifica los recursos que desea aprovisionar y las propiedades de configuración de dichos recursos. Para obtener más información, consulte Trabajo con plantillas de CloudFormation.
Para ver ejemplos del uso del comando create-stack de la CLI para crear una pila, consulte Cree, actualice y elimine pilas de CloudFormation con la AWS CLI y PowerShell.
Temas
Creación de una pila
Siga los pasos descritos en esta sección para implementar su plantilla y crear una pila.
Para crear una pila de
-
Abra la consola de AWS CloudFormation en https://console.aws.amazon.com/cloudformation
. -
En la barra de navegación de la parte superior de la pantalla, elija la Región de AWS en la que creó la pila.
-
En la página Pilas, elija Crear pila en la parte superior derecha y, a continuación, elija Con recursos nuevos (estándar).
Como alternativa, puede elegir la opción Con recursos existentes (importar recursos) para importar recursos de AWS existentes que estén descritos en la plantilla. Para obtener más información acerca de esta opción, consulte Importar recursos de AWS a una pila de CloudFormation con una importación de recursos.
-
En la página Crear pila, proceda de uno de los modos siguientes:
-
Para usar una plantilla existente, en Preparar plantilla, seleccione La plantilla está lista. A continuación, en Especificar plantilla, seleccione URL de Amazon S3 o Cargar un archivo de plantilla en función de la ubicación de la plantilla.
-
Si elige URL de Amazon S3, proporcione una URL al archivo de plantilla en un bucket de S3.
Si la plantilla incluye pilas anidadas (p. ej., pilas descritas en otros documentos de plantilla ubicados en subdirectorios), asegúrese de que su bucket de S3 contiene los archivos y directorios necesarios.
Si tiene una plantilla en un bucket compatible con el control de versiones, puede especificar una versión concreta de la plantilla al adjuntar
?versionId=
a la URL: Para obtener más información sobre bucket con control de versiones, consulte Administración de objetos en un bucket con control de versiones habilitado en la Guía del usuario de la consola de Amazon Simple Storage Service.version-id
La URL debe dirigir a una plantilla con un tamaño máximo de 1 MB que esté almacenada en un bucket de S3 en el que tengas permisos de lectura. La URL puede tener una longitud máxima de 1024 caracteres. Algunos recursos pueden requerir que el bucket esté en la misma región que la pila.
-
Si elige Cargar un archivo de plantilla, seleccione Elegir archivo para elegir un archivo de plantilla de su computadora local. El tamaño del archivo de plantilla debe ser de 1 MB o menos.
Una vez que haya elegido la plantilla, CloudFormation carga el archivo y muestra la URL de S3. CloudFormation lo carga en un bucket de Amazon S3 de su Cuenta de AWS. Si ya tiene un bucket de S3 creado por CloudFormation en su Cuenta de AWS, CloudFormation agrega la plantilla a ese bucket. Si todavía no tiene un bucket existente creado con CloudFormation, crea un bucket único para cada región en la que carga un archivo de plantilla.
A continuación, se muestran las consideraciones que existen cuando se utilizan buckets de S3 creados por CloudFormation:
-
Cualquiera con permisos de Amazon S3 en su Cuenta de AWS puede acceder a los buckets.
-
CloudFormation crea los buckets con el cifrado del lado del servidor habilitado de forma predeterminada; por lo tanto, cifra todos los objetos almacenados en el bucket.
Puede administrar directamente las opciones de cifrado para los buckets creados con CloudFormation; por ejemplo, mediante la consola de Amazon S3 en https://console.aws.amazon.com/s3/
o la AWS CLI. Para obtener más información, consulte Establecer el comportamiento del cifrado predeterminado del lado del servidor para los buckets de Amazon S3, en la Guía del usuario de Amazon Simple Storage Service. -
Puede utilizar su propio bucket y administrar sus permisos cargando manualmente las plantillas a Amazon S3. Al crear o actualizar una pila, especifique la URL de Amazon S3 de un archivo de plantilla.
-
-
-
Si no tiene una plantilla lista, puede elegir Usar una plantilla de ejemplo para usar una de la biblioteca de plantillas o Crear desde Application Composer para crear una plantilla con Application Composer. Para obtener más información, consulte Application Composer.
-
-
Seleccione Siguiente para continuar y validar la plantilla.
Antes de continuar, CloudFormation valida su plantilla para identificar errores de sintaxis y algunos de semántica, como las dependencias circulares. Durante la validación, CloudFormation comprueba primero si la plantilla es un JSON válido. Si no lo es, CloudFormation comprueba si la plantilla es un YAML válido. Si ambas comprobaciones fallan, CloudFormation devuelve un error de validación de plantilla.
-
En la página Specify stack (Especificar pila), escriba un nombre de pila en el cuadro Stack name (Nombre de pila).
El nombre de pila es un identificador que le ayuda a encontrar una en particular en una lista de pilas. El nombre de una pila puede contener únicamente caracteres alfanuméricos (con distinción entre mayúsculas y minúsculas) y guiones. Debe comenzar con un carácter alfabético y no puede tener más de 128 caracteres.
-
En la sección Parámetros, especifique los valores para los parámetros que se definen en la plantilla.
-
Seleccione Siguiente para seguir creando la pila.
-
(Opcional) En la página Configurar las opciones la de pila, agregue etiquetas y otras opciones de pila. Para obtener más información, consulte Configurar las opciones la pila.
-
Elija Siguiente para continuar.
-
En la página Revisar y crear, revise los detalles de la pila.
Para cambiar cualquiera de los valores antes de lanzar la pila, elija Atrás en la sección que contiene la configuración que desea cambiar.
-
Si su plantilla contiene recursos de IAM, seleccione la casilla Acepto que CloudFormation pueda crear recursos de IAM con nombres personalizados. Para obtener más información, consulte Reconocimiento de recursos de IAM en plantillas de CloudFormation.
-
(Opcional) Puede crear un conjunto de cambios para obtener una vista previa de la configuración de la pila antes de crearla. En la página Revisar y crear, seleccione Crear conjunto de cambios y siga las instrucciones. Para obtener más información, consulte Obtenga una vista previa de la configuración de la pila.
-
Seleccione Enviar para lanzar su stack.
CloudFormation procederá entonces con la creación de todos los recursos definidos en la plantilla.
Puede supervisar el progreso y el estado de la creación de la pila en la pestaña Eventos de la nueva pila. Para obtener más información, consulte Monitorizar el progreso de la pila.
Configurar las opciones la pila
En la página Configurar opciones de pila, puede configurar opciones para las pilas de CloudFormation como etiquetas, notificación de eventos de pila o una política de pilas.
Puede definir las siguientes opciones de pila:
-
Puede agregar hasta 50 pares de claves y etiquetas a su pila y a cualquier recurso para el que CloudFormation admite el etiquetado. Una etiqueta es una clave y un valor definidos por el cliente que se puede asignar a los recursos de AWS para fines como el seguimiento de los costos.
Una clave puede contener cualquier carácter alfanumérico o espacios. Las claves de etiqueta pueden tener hasta 127 caracteres.
Un valor puede contener cualquier carácter alfanumérico o espacios. Los valores de etiqueta pueden tener hasta 255 caracteres.
- Permisos
-
Un rol de servicio de IAM existente que CloudFormation puede asumir. En lugar de utilizar las credenciales de su cuenta, CloudFormation utiliza las credenciales del rol para crear la pila. Para obtener más información, consulte Rol de servicio AWS CloudFormation.
- Opciones de error de pila
-
Especifica las opciones de error de aprovisionamiento para todas las implementaciones de pilas y operaciones de conjuntos de cambios. Para obtener más información, consulte Elija cómo gestionar los errores al aprovisionar recursos.
La opción Roll back all stack resources (Restaurar todos los recursos de la pila) restaurará todos los recursos especificados en la plantilla cuando el estado de la pila sea
CREATE_FAILED
oUPDATE_FAILED
.Para crear operaciones, la opción Preserve successfully provisioned resources (Conservar los recursos aprovisionados correctamente) conserva el estado de los recursos correctos, mientras que los recursos con errores permanecerán en un estado con error hasta que se lleve a cabo la siguiente operación de actualización.
Para las operaciones de actualización y de conjuntos de cambios, la opción Preserve successfully provisioned resources (Conservar los recursos aprovisionados correctamente) conserva el estado de los recursos correctos y, al mismo tiempo, restaura los recursos con errores al último estado estable conocido. El estado de los recursos con error será
UPDATE_FAILED
. Los recursos sin un último estado estable conocido se eliminarán en la siguiente operación de pila.
También puede definir las siguientes opciones avanzadas para la creación de la pila:
- Stack policy (Política de pila)
-
Define los recursos que desea proteger de actualizaciones involuntarias durante una actualización de pila. De forma predeterminada, se pueden actualizar todos los recursos durante una actualización de pila.
Puede introducir la política de pilas directamente como JSON o cargar un archivo JSON que contenga la política de pilas. Para obtener más información, consulte Impida actualizaciones en los recursos de la pila.
- Rollback configuration (Configuración de restauración automática)
-
Permite que CloudFormation monitorice el estado de su pila durante la creación y la actualización de la pila y restaure dicha operación si la pila sobrepasa el umbral de las alarmas especificadas. Especifique las alarmas de CloudWatch que CloudFormation debe supervisar. Si alguna de las alarmas pasa al estado
ALARM
durante la operación de la pila o el periodo de monitoreo, CloudFormation revierte toda la operación de la pila. Para obtener más información, consulte Revierta su pila de CloudFormation en caso de violación de alarmas con activadores de reversión. - Opciones de notificación
-
Puede especificar un tema de Amazon Simple Notification Service nuevo o ya existente adonde se envían las notificaciones sobre eventos de pila.
Si crea un tema de Amazon SNS, debe especificar un nombre y una dirección de correo electrónico, adonde se envían las notificaciones de eventos de pila.
- Stack creation options (Opciones de creación de pila)
-
Las siguientes opciones está incluidas para la creación de la pila, pero no están disponibles como parte de las actualizaciones de la pila.
- Timeout (Tiempo de espera)
-
Especifica la cantidad de tiempo, en minutos, que CloudFormation debe adjudicar antes de que se agote el tiempo de las operaciones de creación de pilas. Si CloudFormation no puede crear toda la pila en el tiempo asignado, se produce un error de creación porque el tiempo de espera se agota y la pila vuelve a su estado anterior.
De forma predeterminada, no hay tiempo de espera para la creación de pilas. Sin embargo, puede que determinados recursos individuales tengan sus propios tiempos de espera en función de la naturaleza del servicio que implementan. Por ejemplo, si se agota el tiempo de espera de un recurso individual de la pila, también se agota el tiempo de espera de creación de la pila aunque todavía no se haya agotado el tiempo de espera especificado para la creación de la pila.
- Termination protection
-
Evita que una pila se elimine accidentalmente. Si un usuario intenta eliminar una pila con la protección de terminación habilitada, la eliminación fallará y la pila junto con su estado no cambiarán. Para obtener más información, consulte Protección de las pilas de CloudFormation para evitar la eliminación.
La protección de terminación está Disabled (Deshabilitada) de forma predeterminada.
Obtenga una vista previa de la configuración de la pila
Para obtener una vista previa de cómo se configurará una pila de CloudFormation antes de crear la pila, cree un conjunto de cambios. Esta funcionalidad le permite examinar diversas configuraciones y realizar correcciones y cambios en la pila antes de ejecutar el conjunto de cambios. Para obtener más información acerca de conjuntos de cambios, consulte Actualización de pilas de CloudFormation con conjuntos de cambios.
Creación de un conjunto de cambios para una nueva pila
Para crear un conjunto de cambios para una pila nueva, seleccione la plantilla de la pila y especifique la configuración de la pila como lo haría si estuviera creando una nueva pila. A continuación, seleccione crear un nuevo conjunto de cambios en lugar de una pila nueva.
Creación de un conjunto de cambios para una nueva pila
-
En la página Revisar y crear, seleccione Crear conjunto de cambios.
-
En el cuadro de diálogo Crear conjunto de cambios, ingrese el nombre del conjunto de cambios y una descripción, si lo desea. Elija Create change set (Crear conjunto de cambios).
Cuando se crea un conjunto de cambios para una nueva pila, CloudFormation hace lo siguiente:
-
Lanza una nueva pila con un estado de
REVIEW_IN_PROGRESS
. -
Crea un conjunto de cambios para la pila nueva que refleja la configuración de la pila que ha especificado en los pasos anteriores.
CloudFormation muestra la página Change sets (Conjuntos de cambios) para la pila. Mientras CloudFormation crea el conjunto de cambios, su estado es
CREATE_IN_PROGRESS
y el estado de ejecución esUNAVAILABLE
. Cuando CloudFormation lleva a cabo correctamente la creación del conjunto de cambios, establece el estado comoCREATE_COMPLETE
y su estado de ejecución esAVAILABLE
. El estado de la pila se actualiza aREVIEW_IN_PROGRESS
. En este momento, puede ejecutar el conjunto de cambios para completar la creación de la nueva pila.En la sección Changes (Cambios), CloudFormation muestra la configuración propuesta de su pila.
Si CloudFormation no logra crear el conjunto de cambios, establece el estado como
CREATE_FAILED
. Corrija el error que se muestra en el campo Status reason (Motivo del estado) y, a continuación, cree un nuevo conjunto de cambios. En esta fase, puede probar diversas configuraciones y realizar correcciones y cambios en la pila antes de ejecutar el siguiente conjunto de cambios. -
-
Para completar la creación de una nueva pila basada en el conjunto de cambios, elija Execute (Ejecutar) y, a continuación, elija Execute change set (Ejecutar conjunto de cambios).