Parámetros y AWS CDK - AWS Cloud Development Kit (AWS CDK) v2

Esta es la segunda versión de la Guía para desarrolladores de AWS CDK. La primera versión del CDK pasó a la etapa de mantenimiento el 1.° de junio de 2022 y no cuenta con soporte desde el 1.° de junio de 2023.

Parámetros y AWS CDK

Los parámetros son valores personalizados que se proporcionan en el momento de la implementación. Los parámetros son una característica de AWS CloudFormation. Dado que AWS Cloud Development Kit (AWS CDK) sintetiza las plantillas de AWS CloudFormation, también ofrece compatibilidad con parámetros en el momento de la implementación.

Acerca de los parámetros

Al usar AWS CDK, puede definir parámetros que luego puede utilizar en las propiedades de las construcciones que cree. También puede implementar pilas que contengan parámetros.

Al implementar la plantilla de AWS CloudFormation mediante la CLI de AWS CDK, debe proporcionar los valores de los parámetros en la línea de comandos. Si implementa la plantilla a través de la consola de AWS CloudFormation, se le solicita que ingrese los valores de los parámetros.

En general, no recomendamos utilizar parámetros de AWS CloudFormation con AWS CDK. Las formas habituales de pasar valores a las aplicaciones de AWS CDK son los valores de contexto y las variables de entorno. Dado que no se encuentran disponibles en el momento de la síntesis, los valores de los parámetros no se pueden usar fácilmente para controlar el flujo y otros fines en su aplicación de CDK.

nota

Para realizar el flujo de control con parámetros, puede usar constructos CfnCondition, aunque esto es complicado en comparación con instrucciones if nativas.

El uso de parámetros requiere que tenga en cuenta cómo se comporta el código que está escribiendo en el momento de la implementación y también en el momento de la síntesis. Esto hace que sea más difícil comprender y razonar sobre su aplicación de AWS CDK, en muchos casos por poco beneficio.

Por lo general, es mejor que la aplicación de CDK acepte la información necesaria de manera bien definida y que la utilice directamente para declarar los constructos en la aplicación de CDK. Una plantilla de AWS CDK generada con AWS CloudFormation ideal es concreta, sin valores que deban especificarse en el momento de la implementación.

Sin embargo, hay casos de uso para los que los parámetros de AWS CloudFormation son especialmente adecuados. Si tiene equipos independientes que definen e implementan la infraestructura, por ejemplo, puede usar parámetros para que las plantillas generadas sean más útiles. Además, debido a que AWS CDK admite parámetros de AWS CloudFormation, puede usar AWS CDK con servicios de AWS que usan plantillas de AWS CloudFormation (como Service Catalog). Estos servicios de AWS usan parámetros para configurar la plantilla que se está implementando.

Más información

Para obtener instrucciones sobre cómo desarrollar aplicaciones de CDK con parámetros, consulte Utilice los parámetros de CloudFormation para obtener un valor de CloudFormation.