Ini adalah Panduan Pengembang AWS CDK v2. CDKV1 yang lebih lama memasuki pemeliharaan pada 1 Juni 2022 dan mengakhiri dukungan pada 1 Juni 2023.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

AWS CDK pembuatan versi

Topik ini memberikan informasi referensi tentang cara AWS Cloud Development Kit (AWS CDK) menangani pembuatan versi.

Nomor versi terdiri dari tiga bagian versi numerik: mayor. kecil. patch, dan benar-benar mematuhi model versi semantik. Ini berarti bahwa melanggar perubahan pada API stabil terbatas pada rilis utama.

Rilis minor dan patch kompatibel ke belakang. Kode yang ditulis dalam versi sebelumnya dengan versi utama yang sama dapat ditingkatkan ke versi yang lebih baru dalam versi utama yang sama. Ini juga akan terus membangun dan menjalankan, menghasilkan output yang sama.

AWS CDKCLIkompatibilitas

AWS CDK CLIItu selalu kompatibel dengan pustaka konstruksi dengan nomor versi yang lebih rendah atau sama secara semantik. Oleh karena itu, selalu aman untuk meningkatkan AWS CDK CLI versi utama yang sama.

AWS CDK CLIIni tidak selalu kompatibel dengan pustaka konstruksi dari versi yang lebih tinggi secara semantik. Kompatibilitas tergantung pada apakah versi skema perakitan cloud yang sama digunakan oleh dua komponen. AWS CDK Kerangka kerja menghasilkan perakitan cloud selama sintesis dan AWS CDK CLI mengkonsumsinya untuk penerapan. Skema yang mendefinisikan format perakitan cloud ditentukan dan berversi secara ketat.

AWS pustaka konstruksi menggunakan versi skema perakitan cloud tertentu kompatibel dengan versi yang menggunakan AWS CDK CLI versi skema tersebut atau yang lebih baru. Ini mungkin termasuk rilis AWS CDK CLI yang lebih awal dari rilis pustaka konstruksi tertentu.

Jika versi perakitan cloud yang diperlukan oleh pustaka konstruksi tidak kompatibel dengan versi yang didukung oleh AWS CDK CLI, Anda menerima pesan kesalahan seperti berikut:

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.

Untuk mengatasi kesalahan ini, perbarui AWS CDK CLI ke versi yang kompatibel dengan versi perakitan cloud yang diperlukan, atau ke versi terbaru yang tersedia. Alternatifnya (menurunkan modul library build yang digunakan aplikasi Anda) umumnya tidak disarankan.

AWS Membangun versi Perpustakaan

Modul-modul di AWS Construct Library bergerak melalui berbagai tahap saat dikembangkan dari konsep ke API yang matang. Tahapan yang berbeda menawarkan berbagai tingkat stabilitas API di versi berikutnya AWS CDK.

API di AWS CDK pustaka utama,aws-cdk-lib, stabil, dan pustaka sepenuhnya berversi semantik. Paket ini mencakup konstruksi AWS CloudFormation (L1) untuk semua AWS layanan dan semua modul tingkat tinggi (L2 dan L3) yang stabil. (Ini juga termasuk kelas CDK inti seperti App danStack). API tidak akan dihapus dari paket ini (meskipun mungkin tidak digunakan lagi) hingga rilis utama CDK berikutnya. Tidak ada API individual yang akan mengalami perubahan yang melanggar. Ketika perubahan yang melanggar diperlukan, API yang sama sekali baru akan ditambahkan.

API baru yang sedang dikembangkan untuk layanan yang sudah aws-cdk-lib dimasukkan diidentifikasi menggunakan BetaN akhiran, di mana N dimulai dari 1 dan ditambah dengan setiap perubahan yang melanggar ke API baru. BetaN API tidak pernah dihapus, hanya tidak digunakan lagi, sehingga aplikasi Anda yang ada terus bekerja dengan versi yang lebih baru. aws-cdk-lib Saat API dianggap stabil, API baru tanpa BetaN akhiran ditambahkan.

Ketika API tingkat tinggi (L2 atau L3) mulai dikembangkan untuk AWS layanan yang sebelumnya hanya memiliki API L1, API tersebut awalnya didistribusikan dalam paket terpisah. Nama paket semacam itu memiliki akhiran “Alpha”, dan versinya cocok dengan versi pertama yang aws-cdk-lib kompatibel dengan, dengan alpha sub-versi. Ketika modul mendukung kasus penggunaan yang dimaksudkan, API-nya ditambahkan keaws-cdk-lib.

Stabilitas pengikatan bahasa

Seiring waktu, kami mungkin menambahkan dukungan untuk bahasa pemrograman tambahan. AWS CDK Meskipun API yang dijelaskan dalam semua bahasa adalah sama, cara API diekspresikan bervariasi menurut bahasa dan mungkin berubah seiring berkembangnya dukungan bahasa. Untuk alasan ini, binding bahasa dianggap eksperimental untuk sementara waktu sampai dianggap siap untuk digunakan produksi.