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.
Entornos para el AWS CDK
Un entorno consta de la cuenta de AWS y la región de AWS en las que se implementa una pila de AWS Cloud Development Kit (AWS CDK).
- AWS Cuenta de
-
Al crear una cuenta de AWS, recibirá un ID de cuenta. Este ID es un número de 12 dígitos, como 012345678901, que identifica de forma única a la cuenta. Para obtener más información, consulte Visualización de identificadores de la cuenta de AWS en la Guía de referencia de administración de cuentas de AWS.
- AWS Región de
-
Las regiones de AWS se nombran mediante una combinación de una ubicación geográfica y un número que representa una Zona de disponibilidad en la Región. Por ejemplo, us-east-1 representa una Zona de disponibilidad de la Región Este de EE. UU. (Norte de Virginia) Para obtener más información acerca de las regiones de AWS, consulte Regiones y Zonas de disponibilidad
. Para obtener una lista de códigos de región, consulte Puntos de conexión regionales en la Guía de referencia general de AWS.
El AWS CDK puede determinar los entornos a partir de sus credenciales y archivos de configuración. Estos archivos se pueden crear y administrar con la interfaz de la línea de comandos de AWS (AWS CLI). A continuación, se muestra un ejemplo básico de estos archivos:
- Archivo de credenciales
-
[default] aws_access_key_id=ASIAIOSFODNN7EXAMPLE aws_secret_access_key=wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY aws_session_token = IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE [user1] aws_access_key_id=ASIAI44QH8DHBEXAMPLE aws_secret_access_key=je7MtGbClwBF/2Zp9Utk/h3yCo8nvbEXAMPLEKEY aws_session_token = fcZib3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZ2luX2IQoJb3JpZVERYLONGSTRINGEXAMPLE - Archivo de configuración
-
[default] region=us-west-2 output=json [profile user1] region=us-east-1 output=text
Puede pasar la información del entorno desde estos archivos en el código de CDK a través de las variables del entorno que proporciona CDK. Cuando ejecuta un comando de la CLI de CDK, por ejemplo cdk deploy, proporciona el perfil de sus credenciales y archivos de configuración para recopilar información del entorno.
A continuación, se muestra un ejemplo de cómo especificar estas variables del entorno en el código CDK:
new MyDevStack(app, 'dev', { env: { account: process.env.CDK_DEFAULT_ACCOUNT, region: process.env.CDK_DEFAULT_REGION }});
A continuación, se muestra un ejemplo de cómo pasar los valores asociados al perfil user1 desde sus credenciales y archivos de configuración a la CLI de CDK mediante la opción --profile. Los valores de estos archivos se pasarán a las variables del entorno:
$ cdk deploy <myStack> --profile <user1>
En lugar de utilizar los valores de las credenciales y los archivos de configuración, puede hacer una codificación rígida de los valores del entorno en su código CDK. A continuación, se muestra un ejemplo:
const envEU = { account: '238383838383', region: 'eu-west-1' }; const envUSA = { account: '837873873873', region: 'us-west-2' }; new MyFirstStack(app, 'first-stack-us', { env: envUSA }); new MyFirstStack(app, 'first-stack-eu', { env: envEU });
Más información
Para empezar a utilizar entornos con el AWS CDK, consulte Configurar entornos para utilizarlos con el AWS CDK