AWS CDK versionamento

Este é o Guia do Desenvolvedor AWS CDK v2. O CDK v1 antigo entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Este é o Guia do Desenvolvedor AWS CDK v2. O CDK v1 antigo entrou em manutenção em 1º de junho de 2022 e encerrou o suporte em 1º de junho de 2023.

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Este tópico fornece informações de referência sobre como o AWS Cloud Development Kit (AWS CDK) lida com o controle de versão.

Os números de versão consistem em três partes numéricas: major.minor.patch, e seguem estritamente o modelo de versionamento semântico. Isso significa que as mudanças significativas na versão estável APIs estão limitadas às versões principais.

As versões minor e patch são compatíveis com versões anteriores. O código escrito em uma versão anterior com a mesma versão major pode ser atualizado para uma versão mais recente dentro da mesma versão major. Ele também continuará a ser construído e executado, produzindo a mesma saída.

AWS CDK CLI   compatibilidade

Cada versão da AWS CDK biblioteca principal (aws-cdk-lib) é compatível com o AWS CDK CLI (aws-cdk-cli) versão atual na época do lançamento da biblioteca CDK. Também é compatível com qualquer versão mais recente do CDK CLI. Cada versão da biblioteca CDK mantém essa compatibilidade até a data de fim da vida útil da biblioteca. Portanto, desde que você esteja usando uma versão compatível da biblioteca CDK, é sempre seguro atualizar seu CDK CLI versão.

Cada versão da biblioteca CDK também pode funcionar com o CDK CLI versões anteriores à versão atual na época do lançamento da biblioteca CDK. No entanto, isso não é garantido. A compatibilidade depende da versão do esquema de montagem em nuvem da biblioteca CDK. Isso AWS CDK gera uma montagem de nuvem durante a síntese e o CDK CLI o consome para implantação. O esquema que define o formato da montagem da nuvem é estritamente especificado e versionado. Portanto, uma versão mais antiga do CDK CLI precisariam oferecer suporte à versão do esquema de montagem em nuvem da biblioteca CDK para que fossem compatíveis.

Quando a versão de montagem em nuvem exigida pela biblioteca CDK não é compatível com a versão suportada pela CDK CLI, você recebe uma mensagem de erro como a seguinte:

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 esse erro, atualize o CDK CLI para uma versão compatível com a versão de montagem em nuvem necessária ou para a versão mais recente disponível. A alternativa (rebaixar os módulos da Biblioteca de Constructos que sua aplicação usa) geralmente não é recomendada.

AWS Controle de versão da Construct Library

Os módulos na AWS Construct Library passam por vários estágios à medida que são desenvolvidos, do conceito à API madura. Estágios diferentes oferecem vários graus de estabilidade da API nas versões subsequentes do AWS CDK.

APIs na AWS CDK biblioteca principal,aws-cdk-lib, são estáveis e a biblioteca é totalmente versionada semanticamente. Este pacote inclui construções AWS CloudFormation (L1) para todos os AWS serviços e todos os módulos estáveis de nível superior (L2 e L3). (Também inclui as classes principais do CDK, como App eStack). APIs não serão removidos desse pacote (embora possam estar obsoletos) até a próxima versão principal do CDK. Nenhuma API individual jamais terá alterações significativas. Quando uma alteração significativa for necessária, uma API totalmente nova será adicionada.

Os novos APIs em desenvolvimento para um serviço já incorporado aws-cdk-lib são identificados usando um BetaN sufixo, que N começa em 1 e é incrementado a cada alteração significativa na nova API. BetaN APIs nunca são removidos, apenas obsoletos, portanto, seu aplicativo existente continua funcionando com versões mais recentes do. aws-cdk-lib Quando a API é considerada estável, uma nova API sem o sufixo BetaN é adicionada.

Quando os níveis superiores (L2 ou L3) APIs começam a ser desenvolvidos para um AWS serviço que antes tinha apenas L1 APIs, eles APIs são inicialmente distribuídos em um pacote separado. O nome desse pacote tem um sufixo “Alpha” e sua versão corresponde à primeira versão de aws-cdk-lib com a qual é compatível, com uma subversão alpha. Quando o módulo suporta os casos de uso pretendidos, APIs eles são adicionadosaws-cdk-lib.

Estabilidade de vinculação de linguagem

Com o tempo, poderemos adicionar suporte ao AWS CDK para linguagens de programação adicionais. Embora a API descrita em todas as linguagens seja a mesma, a forma como a API é expressa varia de acordo com a linguagem e pode mudar à medida que o suporte à linguagem evolui. Por esse motivo, as vinculações de linguagem são consideradas experimentais por um tempo até serem consideradas prontas para uso em produção.