Uso de módulos del registro privado de CloudFormation
En este tema se explica cómo utilizar los módulos en las plantillas de CloudFormation. Piense en los módulos como agrupaciones de recursos prediseñados que puede agregar a sus plantillas.
Para usar un módulo, los pasos son los siguientes:
-
Registre los módulos: registre los módulos en el registro de CloudFormation como extensiones privadas. Asegúrese de que esté registrado en la Cuenta de AWS y en la región en la que trabaja. Para obtener más información, consulte Conceptos de registro de CloudFormation.
-
Inclúyalo en la plantilla: agrega el módulo a la sección Referencia sintáctica de la sección Resources para las plantillas de CloudFormation de la plantilla de CloudFormation, tal como lo haría con otros recursos. También tendrá que proporcionar las propiedades necesarias para el módulo.
-
Cree o actualice la pila: al iniciar una operación de pila, CloudFormation genera una plantilla procesada que resuelve los módulos incluidos en los recursos apropiados.
-
Previsualice de los cambios: antes de realizar cambios, puede usar un conjunto de cambios para ver qué recursos se agregarán o cambiarán. Para obtener más información, consulte Actualización de pilas de CloudFormation con conjuntos de cambios.
Considere el siguiente ejemplo: tiene una plantilla que contiene recursos y módulos. La plantilla contiene un recurso individual, ResourceA
, como así también un módulo, ModuleParent
. Ese módulo contiene dos recursos, ResourceB
y ResourceC
, además de un módulo anidado, ModuleChild
. ModuleChild
contiene un único recurso, ResourceD
. Si crea una pila a partir de esta plantilla, CloudFormation procesa la plantilla y resuelve los módulos a los recursos apropiados. La pila resultante tiene cuatro recursos: ResourceA
, ResourceB
, ResourceC
y ResourceD
.
CloudFormation realiza un seguimiento de los recursos de una pila que se crearon a partir de módulos. Puede ver esta información en las pestañas Eventos, Recursos y Desviaciones de una pila determinada, y también se incluye en vistas previas de conjuntos de cambios.
Los módulos se distinguen de los recursos de una plantilla porque se adhieren a la siguiente convención de nomenclatura de cuatro partes, a diferencia de la típica convención de tres partes utilizada por los recursos:
organization
::service
::use-case
::MODULE