Esta es la guía para AWS CDK desarrolladores de la versión 2. La CDK versión anterior entró en mantenimiento el 1 de junio de 2022 y finalizó el soporte 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.
Cómo empezar con el AWS CDK
Comience con ella creando una Cuenta de AWS, configurando la interfaz de línea de AWS CDK comandos (AWS CDK CLI) y creando su primera aplicación de CDK. AWS Cloud Development Kit (AWS CDK)
Requisitos previos
Antes de empezar con el AWS CDK, le recomendamos que tenga un conocimiento básico de lo que AWS CDK es. Para obtener más información, consulte ¿Qué es el AWS CDK? y Aprenda los conceptos AWS CDK básicos.
Paso 1: Crear un Cuenta de AWS usuario administrativo
Si usted o su organización son nuevos AWS, deben registrarse Cuenta de AWS y crear un usuario administrativo. Para obtener instrucciones, consulte Cómo configurar IAM en la Guía del usuario de IAM.
Puede gestionar la IAM mediante distintos métodos, por ejemplo, a través de la AWS consola, la AWS Command Line Interface (AWS CLI) o mediante las interfaces de aplicación (APIs) en la interfaz asociada. SDKs Cuando utilice IAM con el AWS CDK CLI, lo utilizará principalmente AWS CLI para configurar y administrar las credenciales de seguridad. Para obtener más información, consulte AWS Command Line Interface (CLI) y los kits de desarrollo de software (SDKs) en la Guía del usuario de IAM.
Una vez que haya creado un usuario administrativo, puede empezar a usarlo AWS CDK instalando el CLI CDK. Sin embargo, le recomendamos que primero determine su método de administración de los usuarios, siguiendo la práctica recomendada de IAM de aplicar permisos con privilegios mínimos. En lugar de utilizar el usuario administrativo para todo, debe crear usuarios de IAM y conceder únicamente los permisos necesarios para realizar una tarea.
Paso 2: Determine el método de administración de los usuarios
Una vez que haya creado su usuario Cuenta de AWS y el usuario administrativo, querrá determinar el método de administración de los usuarios. Para obtener más información sobre los diferentes métodos de administración de usuarios, consulte Descripción general de la administración de AWS identidades: usuarios en la Guía del usuario de IAM.
Si su organización tiene un método para gestionar los usuarios, siga sus instrucciones. De lo contrario, le recomendamos que lo utilice AWS IAM Identity Center para crear y administrar usuarios. Con IAM Identity Center, puede gestionar Cuentas de AWS los usuarios y los permisos desde un servicio gestionado de forma centralizada. También puede utilizar un proveedor de identidad para autenticar a los usuarios y proporcionar credenciales temporales para su uso con la CDK. CLI Esta es una práctica recomendada de seguridad de IAM. Para obtener una introducción al Centro de identidades de IAM, consulte ¿Qué es el Centro de identidades de IAM? en la Guía del AWS IAM Identity Center usuario.
Como usuario, debe configurar las credenciales de seguridad en su entorno de desarrollo local para la CDKCLI. Para ello, le recomendamos que utilice install y utilice AWS Command Line Interface (AWS CLI).
Paso 3: Instale el AWS CLI
Como usuario, lo usa AWS CLI para crear y administrar los archivos de configuración y credenciales en su máquina local. Estos archivos se utilizan para almacenar, administrar y generar credenciales de seguridad para su uso con la CLI CDK.
Para instalarlo AWS CLI, consulte Instalar o actualizar a la versión más reciente de AWS CLI en la Guía del AWS Command Line Interface usuario.
Para obtener más información sobre estos archivos, consulte los ajustes de configuración y de los archivos de credenciales en la Guía del AWS Command Line Interface usuario.
Tras instalarlo AWS CLI, configurará las credenciales de seguridad en un paso posterior.
Paso 4: Requisitos previos del lenguaje de instalación Node.js y programación
Todos AWS CDK los desarrolladores, independientemente del lenguaje de programación compatible que vayan a utilizar, necesitan la versión Node.js
importante
Las versiones 13.0.0 a 13.6.0 de Node.js no son compatibles con él AWS CDK debido a problemas de compatibilidad con sus dependencias.
Otros requisitos previos del lenguaje de programación dependen del lenguaje que se utilice para desarrollar las aplicaciones: AWS CDK
Para obtener información más detallada, consulte la sección de requisitos previos para su idioma:
Depreciación de idiomas de terceros
Solo se admite la versión en cada idioma hasta el final de su vida útil y está sujeta a cambios con previo aviso. EOL
Paso 5: Instale el AWS CDKCLI
Utilice el Node Package Manager para instalar el CDK. CLI Le recomendamos que lo instale globalmente mediante el siguiente comando:
$
npm install -g aws-cdk
Para instalar una versión específica del CDKCLI, 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 CDK CLI en proyectos individuales de la CDK. Para ello, elimine la -g
opción del npm install
comando. A continuación, utilice npx aws-cdk
para invocar el CLI CDK. Esto ejecutará una versión local si existe. De lo contrario, se utilizará la versión instalada globalmente.
nota
Si aparece un error de permiso y tienes acceso de administrador a tu sistema, inténtalosudo npm install -g
aws-cdk
.
Ejecute el siguiente comando para comprobar que la instalación se ha realizado correctamente. AWS CDK CLIDebería mostrar el número de versión:
$
cdk --version
Si recibe un mensaje de error, intente desinstalarlo AWS CDK CLI ejecutando lo siguiente:
$
npm uninstall -g aws-cdk
A continuación, repita los pasos para volver a instalar el AWS CDK CLI.
Paso 6: Configure las credenciales de seguridad para la CDK CLI
Cuando desarrolle AWS CDK en su entorno local, utilizará principalmente la CDK CLI para interactuar con ella. AWS Estas interacciones incluyen la implementación de pilas de CDK, la realización de diferencias de pilas, la importación de recursos a la CDK y mucho más.
Para realizar estas acciones, debe configurar las credenciales de seguridad de la CDK CLI en su máquina local. Esto le permite AWS saber quién es y qué permisos tiene. Para obtener instrucciones, consulte Configure las credenciales de seguridad para AWS CDKCLI.
Paso 7: Inicie su entorno AWS
Las pilas de CDK se implementan en los entornos. AWS Antes de poder implementar una pila de CDK en un entorno, primero se debe iniciar el entorno.
Para arrancar el entorno, utilice el comando CDK. CLI cdk bootstrap
Para ver instrucciones, consulte Cómo arrancar su entorno.
Paso 8: (opcional) Instale herramientas adicionales AWS CDK
AWS Toolkit for Visual Studio Code
Paso 9: Crea tu primera aplicación CDK
Ya está listo para empezar a utilizar la AWS CDK creando su primera aplicación de CDK. Para obtener instrucciones, consulte Tutorial: Crea tu primera AWS CDK aplicación.