Esta es la guía para AWS CDK desarrolladores de la versión 2. La versión anterior del CDK v1 entró en mantenimiento el 1 de junio de 2022 y dejó de ofrecer 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.

AWS CDK control de versiones

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

Los números de versión constan de tres partes numéricas de la versión: la principal. menor. parche y adhiérase estrictamente al modelo de control de versiones semántico. Esto significa que los cambios más importantes en las API estables se limitan a las versiones principales.

Las versiones menores 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 seguirá compilándose y ejecutándose, produciendo el mismo resultado.

AWS CDKCLIcompatibilidad

Siempre AWS CDK CLI es compatible con bibliotecas de construcción con un número de versión semánticamente inferior o igual. Por lo tanto, siempre es seguro actualizar la AWS CDK CLI misma versión principal.

No siempre AWS CDK CLI es compatible con bibliotecas de construcción de una versión semánticamente superior. La compatibilidad depende de si los dos componentes utilizan la misma versión del esquema de ensamblaje en la nube. El AWS CDK marco genera un ensamblaje de nube durante la síntesis y lo AWS CDK CLI consume para su implementación. El esquema que define el formato del ensamblaje en la nube está estrictamente especificado y versionado.

AWS Las bibliotecas de construcción que utilizan una versión determinada del esquema de ensamblaje de nubes son compatibles con AWS CDK CLI las versiones que utilizan esa versión del esquema o una versión posterior. Esto podría incluir versiones anteriores a AWS CDK CLI una versión de una biblioteca de construcción determinada.

Cuando la versión de ensamblaje en la nube requerida por la biblioteca de construcción no es compatible con la versión compatible con la AWS CDK CLI, 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, AWS CDK CLI actualícela a una versión compatible con la versión de ensamblaje en 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 construcción que usa tu aplicación).

AWS Construye 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 diferentes etapas ofrecen diversos grados de estabilidad de la API en las versiones posteriores de AWS CDK.

Las API de la AWS CDK biblioteca principal son estables y la biblioteca está completamente versionada semánticamente. aws-cdk-lib 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 Las API no se eliminarán de este paquete (aunque es posible que estén en desuso) hasta la próxima versión principal de la CDK. Ninguna API individual tendrá nunca cambios importantes. Cuando se requiera un cambio importante, se añadirá una API completamente nueva.

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

Cuando las API de nivel superior (L2 o L3) comienzan a desarrollarse para un AWS servicio que anteriormente solo tenía API de nivel 1, esas API 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 con la aws-cdk-lib que es compatible, con una subversión. alpha Cuando el módulo admite los casos de uso previstos, se añaden sus API. aws-cdk-lib

Estabilidad de la vinculación de idiomas

Con el tiempo, podríamos añadir soporte a AWS CDK otros lenguajes de programación. Si bien la API descrita en todos los lenguajes es la misma, la forma en que se expresa varía según el idioma y puede cambiar a medida que evolucione el soporte lingüístico. Por este motivo, los enlaces de idiomas se consideran experimentales durante un tiempo hasta que se considera que están listos para su uso en producción.