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.
Introducción al AWS CDK
Comience con AWS Cloud Development Kit (AWS CDK) mediante la instalación y configuración de la interfaz de la línea de comandos de AWS CDK (CLI de AWS CDK). A continuación, utilice la CLI de CDK para crear su primera aplicación de CDK, arrancar el entorno de AWS e implementar la aplicación.
Requisitos previos
Antes de comenzar con AWS CDK, complete todos los requisitos previos. Estos requisitos previos son necesarios para los principiantes en AWS o en programación. Para obtener instrucciones, consulte Requisitos previos de AWS CDK.
Le recomendamos que tenga conocimientos básicos sobre qué es AWS CDK. Para obtener más información, consulte ¿Qué es el AWS CDK? y Más información acerca de los conceptos básicos de AWS CDK.
Instale la CLIAWS CDK
Para instalar la CLI de CDK, utilice el Administrador de paquetes de Node. Le recomendamos que la instale de forma global con el siguiente comando:
$npm install -g aws-cdk
Para instalar una versión específica de la CLI de CDK, utilice la siguiente estructura de comandos:
$npm install -g aws-cdk@X.YY.Z
Si desea utilizar varias versiones de AWS CDK, considere la posibilidad de instalar una versión correspondiente de la CLI de CDK en proyectos de CDK individuales. Para ello, elimine la opción -g del comando npm install. A continuación, utilice npx aws-cdk para invocar la CLI de CDK. Esto ejecutará una versión local, en caso de que exista. De lo contrario, se utilizará la versión instalada de forma global.
Solucionar problemas en la instalación de la CLI de CDK
Si aparece un error de permiso y tiene acceso de administrador en el sistema, ejecute lo siguiente:
$sudo npm install -g aws-cdk
Si recibe un mensaje de error, intente desinstalar la CLI de CDK al ejecutar lo siguiente:
$npm uninstall -g aws-cdk
A continuación, repita los pasos para volver a instalar la CLI de CDK.
Compruebe que la instalación de la CLI de CDK se realizó correctamente
Ejecute los siguientes comandos para comprobar que se instaló correctamente. La CLI de AWS CDK debería mostrar el número de versión:
$cdk --version
Configuración del AWS CDKCLI
Después de instalar la CLI de CDK, puede empezar a usarla para desarrollar aplicaciones en su máquina local. Para interactuar con AWS, por ejemplo, para implementar aplicaciones, debe tener las credenciales de seguridad configuradas en su máquina local con permisos para realizar cualquier acción que inicie.
Para configurar las credenciales de seguridad en su máquina local, utilice la AWS CLI. La forma de configurar las credenciales de seguridad depende de la forma en que administre los usuarios. Para obtener instrucciones, consulte Authentication and access credentials en la Guía del usuario de AWS Command Line Interface.
La CLI de CDK utilizará de forma automática las credenciales de seguridad que configure con la AWS CLI. Por ejemplo, si es usuario de IAM Identity Center, puede utilizar el comando aws configure sso para configurar credenciales de seguridad. Si es usuario de IAM, puede utilizar el comando aws configure. La AWS CLI lo guiará en la configuración de las credenciales de seguridad en su máquina local y guardará la información necesaria en sus archivos config y credentials. A continuación, cuando utilice la CLI de CDK, por ejemplo, si implementa una aplicación con cdk deploy, la CLI de CDK utilizará las credenciales de seguridad que haya configurado.
Al igual que la AWS CLI, la CLI de CDK utilizará el perfil default de forma predeterminada. Puede especificar un perfil mediante la opción --profile de la CLI de CDK. Para obtener más información sobre el uso de credenciales de seguridad con la CLI de CDK, consulte Configuración de las credenciales de seguridad para la CLI de AWS CDK.
(Opcional) Instalar herramientas de AWS CDK adicionales
AWS Toolkit for Visual Studio Code
Creación de su primera aplicación de CDK
Ahora está listo para empezar a utilizar AWS CDK con la creación de su primera aplicación de CDK. Para obtener instrucciones, consulte Tutorial: cómo crear su primera aplicación de AWS CDK.
