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 costituiti 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à

Il AWS CDK CLI è sempre compatibile con le librerie di costruzione con un numero di versione semanticamente inferiore o uguale. È quindi sempre sicuro aggiornare AWS CDK CLI all'interno della stessa versione principale.

La AWS CDK CLI non è 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 il AWS CDK CLI lo consuma 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 versioni che utilizzano quella versione dello schema o successiva. Ciò potrebbe includere le 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 costruzioni 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, aggiorna il 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

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 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.