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

Esta es la guía para desarrolladores de AWS CDK v2. 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.

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.

Parámetros y el 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 los constructos 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 CloudFormation generada con AWS CDK 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 con servicios de AWS CDK 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 los parámetros, consulte Cómo usar parámetros de CloudFormation para obtener un valor de CloudFormation.