AWS CDK controllo delle versioni

Questa è la guida per sviluppatori AWS CDK v2. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Questa è la guida per sviluppatori AWS CDK v2. Il vecchio CDK v1 è entrato in manutenzione il 1° giugno 2022 e ha terminato il supporto il 1° giugno 2023.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Questo argomento fornisce informazioni di riferimento su come il sistema AWS Cloud Development Kit (AWS CDK) gestisce il controllo delle versioni.

I numeri di versione sono composti da tre parti numeriche: principale. minore. correggi e aderisci rigorosamente al modello di versionamento semantico. Ciò significa che le modifiche sostanziali a stable APIs sono limitate alle versioni principali.

Le versioni secondarie e le patch sono retrocompatibili. Il codice scritto in una versione precedente con la stessa versione principale può essere aggiornato a una versione più recente all'interno della stessa versione principale. Inoltre, continuerà a essere compilato ed eseguito, producendo lo stesso risultato.

AWS CDK CLI compatibilità

Ogni versione della AWS CDK libreria principale (aws-cdk-lib) è compatibile con AWS CDK CLI (aws-cdk-cli) versione corrente al momento del rilascio della libreria CDK. È anche compatibile con qualsiasi versione più recente del CDK CLI. Ogni versione della libreria CDK mantiene questa compatibilità fino alla data di fine del ciclo di vita della libreria. Pertanto, purché utilizzi una versione della libreria CDK supportata, è sempre sicuro aggiornare il tuo CDK CLI versione.

Ogni versione della libreria CDK può funzionare anche con CDK CLI versioni precedenti alla versione corrente al momento del rilascio della libreria CDK. Tuttavia, ciò non è garantito. La compatibilità dipende dalla versione dello schema di assemblaggio cloud della libreria CDK. AWS CDK Genera un assemblaggio cloud durante la sintesi e il CDK CLI lo consuma per la distribuzione. Lo schema che definisce il formato dell'assembly cloud è rigorosamente specificato e versionato. Pertanto, una versione precedente del CDK CLI avrebbero bisogno di supportare la versione dello schema di assemblaggio cloud della libreria CDK per renderli compatibili.

Quando la versione di cloud assembly richiesta dalla libreria CDK non è compatibile con la versione supportata dal CDK CLI, viene visualizzato un messaggio di errore simile al seguente:

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.

Per risolvere questo errore, aggiorna il CDK CLI a una versione compatibile con la versione di cloud assembly richiesta o all'ultima versione disponibile. L'alternativa (il downgrade dei moduli della libreria di costruzione utilizzati dall'app) è generalmente sconsigliata.

AWS Controllo delle versioni di Construct Library

I moduli della AWS Construct Library attraversano varie fasi man mano che vengono sviluppati dall'idea all'API matura. Le diverse fasi offrono diversi gradi di stabilità delle API nelle versioni successive di. AWS CDK

APIs nella AWS CDK libreria principale,aws-cdk-lib, sono stabili e la libreria ha una versione semantica completa. Questo pacchetto include costrutti AWS CloudFormation (L1) per tutti i AWS servizi e tutti i moduli stabili di livello superiore (L2 e L3). (Include anche le classi CDK principali come e). App Stack APIs non verranno rimossi da questo pacchetto (sebbene possano essere obsoleti) fino alla prossima versione principale del CDK. Nessuna singola API subirà mai modifiche sostanziali. Quando è necessaria una modifica sostanziale, verrà aggiunta un'API completamente nuova.

Le novità in APIs fase di sviluppo per un servizio già incorporato aws-cdk-lib vengono identificate utilizzando un BetaN suffisso, che N parte da 1 e viene incrementato a ogni modifica sostanziale apportata alla nuova API. BetaN APIs non vengono mai rimossi, ma solo obsoleti, quindi l'app esistente continua a funzionare con le versioni più recenti di. aws-cdk-lib Quando l'API è considerata stabile, viene aggiunta una nuova API senza il BetaN suffisso.

Quando si APIs inizia a sviluppare un livello superiore (L2 o L3) per un AWS servizio che in precedenza aveva solo L1 APIs, questi APIs vengono inizialmente distribuiti in un pacchetto separato. Il nome di tale pacchetto ha il suffisso «Alpha» e la sua versione corrisponde alla prima versione compatibile con aws-cdk-lib una versione secondaria. alpha Quando il modulo supporta i casi d'uso previsti, viene aggiunto a. APIs aws-cdk-lib

Stabilità del legame linguistico

Nel tempo, potremmo aggiungere il supporto AWS CDK per altri linguaggi di programmazione. Sebbene l'API descritta in tutte le lingue sia la stessa, il modo in cui viene espressa varia a seconda della lingua e potrebbe cambiare con l'evoluzione del supporto linguistico. Per questo motivo, le associazioni linguistiche sono considerate sperimentali per un certo periodo, fino a quando non vengono considerate pronte per l'uso in produzione.