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.

AWS Control de versiones de CDK

En este tema se proporciona información de referencia sobre cómo el AWS Cloud Development Kit (AWS CDK) gestiona el control de versiones.

Los números de versión constan de tres partes numéricas: principal.secundaria.parche y se adhieren de forma estricta al modelo de control de versiones semántico. Esto significa que los cambios importantes en la versión estable APIs se limitan a las versiones principales.

Las versiones secundarias y los parches son compatibles con versiones anteriores. El código escrito en una versión anterior con la misma versión principal se puede actualizar a una versión más reciente dentro de la misma versión principal. También continuará con el compilado y la ejecución, lo que dará el mismo resultado.

AWS Compatibilidad con CDK CLI

Cada versión de la biblioteca principal de AWS CDK (aws-cdk-lib) es compatible con la versión AWS CLI (aws-cdk-cli) de CDK que estaba vigente en el momento del lanzamiento de la biblioteca de CDK. También es compatible con cualquier versión más reciente de la CLI de CDK. Cada versión de la biblioteca CDK mantiene esta compatibilidad hasta la fecha de fin de vida útil de la biblioteca. Por lo tanto, siempre que utilice una versión de biblioteca CDK compatible, siempre es seguro actualizar la versión CLI de CDK.

Cada versión de la biblioteca de CDK también puede funcionar con versiones de CLI de CDK anteriores a la versión actual en el momento del lanzamiento de la biblioteca de CDK. Sin embargo, esto no está garantizado. La compatibilidad depende de la versión del esquema de ensamblaje en la nube de la biblioteca CDK. La AWS CDK genera un ensamblaje de nube durante la síntesis y la CLI de la CDK lo consume para su implementación. El esquema que define el formato del ensamblaje en la nube está estrictamente especificado y versionado. Por lo tanto, una versión anterior de la CLI de CDK tendría que ser compatible con la versión del esquema de ensamblaje en la nube de la biblioteca de CDK para que fuera compatible.

Cuando la versión de ensamblaje en la nube requerida por la biblioteca de CDK no es compatible con la versión compatible con la CLI de CDK, recibirá un mensaje de error como el siguiente:

Cloud assembly schema version mismatch: Maximum schema version supported is 3.0.0, but found 4.0.0.
    Please upgrade your CLI in order to interact with this app.

Para resolver este error, actualice la CLI de CDK a una versión compatible con la versión de ensamblaje de nube requerida o a la última versión disponible. Por lo general, no se recomienda la alternativa (degradar los módulos de la biblioteca de constructos que utiliza la aplicación).

AWS Construya el control de versiones de la biblioteca

Los módulos de la biblioteca AWS Construct pasan por varias etapas a medida que se desarrollan desde el concepto hasta la API madura. Las distintas etapas ofrecen distintos grados de estabilidad de la API en las versiones posteriores de la AWS CDK.

APIs en la biblioteca principal del AWS CDKaws-cdk-lib, son estables y la biblioteca está completamente versionada semánticamente. Este paquete incluye construcciones AWS CloudFormation (L1) para todos los AWS servicios y todos los módulos estables de nivel superior (L2 y L3). (También incluye las clases principales de CDK, como y). App Stack APIs no se eliminarán de este paquete (aunque pueden quedar en desuso) hasta la próxima versión principal del CDK. Ninguna API individual tendrá nunca cambios importantes. Cuando se requiera un cambio importante, se agregará una API completamente nueva.

Las novedades en APIs fase de desarrollo para un servicio ya incorporado aws-cdk-lib se identifican mediante un Beta<N> sufijo, que N comienza en 1 y se incrementa con cada cambio importante que se realice en la nueva API. Beta<N> APIs nunca se eliminan, solo están en desuso, por lo que tu aplicación actual sigue funcionando con las versiones más recientes de. aws-cdk-lib Cuando la API se considera estable, se agrega una nueva API sin el sufijo Beta<N>.

Cuando se APIs empieza a desarrollar un nivel superior (L2 o L3) para un AWS servicio que anteriormente solo tenía el nivel 1 APIs, estos APIs se distribuyen inicialmente en un paquete independiente. El nombre de dicho paquete tiene el sufijo “Alpha” y su versión coincide con la primera versión de la aws-cdk-lib que es compatible con una subversión de alpha. Cuando el módulo admite los casos de uso previstos, se añaden los suyos APIs . aws-cdk-lib

Estabilidad de la vinculación de lenguajes

Con el tiempo, podríamos añadir soporte al AWS CDK para lenguajes de programación adicionales. Si bien la API descrita en todos los lenguajes es la misma, la forma en que se expresa varía según el lenguaje y puede cambiar a medida que evolucione la compatibilidad del lenguaje. Por este motivo, los enlaces de leguaje se tratan como experimentales durante un tiempo hasta que se considere que están listos para su uso en producción.