Questa è la guida per sviluppatori AWS CDK v2. La versione precedente della CDK versione 1 è entrata 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à.

AWS CDK controllo delle versioni

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 costituiti da tre parti numeriche: principale. minore. correggi e aderisci rigorosamente al modello di versionamento semantico. Ciò significa che le modifiche sostanziali alle API stabili 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 CDKCLIcompatibilità

AWS CDK CLIè sempre compatibile con le librerie di costruzione con un numero di versione semanticamente inferiore o uguale. Pertanto, è sempre sicuro aggiornarli AWS CDK CLI all'interno della stessa versione principale.

Non AWS CDK CLI è sempre compatibile con le librerie di costruzione di una versione semanticamente superiore. La compatibilità dipende dal fatto che i due componenti utilizzino la stessa versione dello schema di assemblaggio cloud. Il AWS CDK framework genera un assemblaggio cloud durante la sintesi e AWS CDK CLI lo utilizza per la distribuzione. Lo schema che definisce il formato dell'assembly cloud è rigorosamente specificato e versionato.

AWS le librerie di build che utilizzano una determinata versione dello schema di assemblaggio cloud sono compatibili con AWS CDK CLI le versioni che utilizzano quella versione dello schema o successive. Ciò potrebbe includere versioni di AWS CDK CLI che sono precedenti a una determinata versione della libreria di costruzioni.

Quando la versione di cloud assembly richiesta dalla libreria di costruzione non è compatibile con la versione supportata da AWS 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, aggiornalo AWS 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

Le API nella AWS CDK libreria principale sono stabili e la libreria dispone di versioni semantiche complete. aws-cdk-lib 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 Le API non verranno rimosse da questo pacchetto (sebbene possano essere obsolete) 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 nuove API in 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 Le API non vengono mai rimosse, ma solo obsolete, quindi l'app esistente continua a funzionare con le versioni più recenti di. aws-cdk-lib Quando l'API viene considerata stabile, viene aggiunta una nuova API senza il suffisso. BetaN

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

Stabilità del legame linguistico

Nel corso del 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 l'API 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.