AWS CDK pembuatan versi

Ini adalah Panduan Pengembang AWS CDK v2. CDK v1 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.

Ini adalah Panduan Pengembang AWS CDK v2. CDK v1 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.

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 ke stabil APIs 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 CDK CLI kesesuaian

Setiap versi AWS CDK pustaka utama (aws-cdk-lib) kompatibel dengan AWS CDK CLI (aws-cdk-cli) versi yang terkini pada saat rilis perpustakaan CDK. Ini juga kompatibel dengan versi CDK yang lebih baru CLI. Setiap versi pustaka CDK mempertahankan kompatibilitas ini hingga tanggal Akhir Kehidupan perpustakaan. Oleh karena itu, selama Anda menggunakan versi pustaka CDK yang didukung, selalu aman untuk meningkatkan CDK Anda CLI versi.

Setiap versi perpustakaan CDK juga dapat bekerja dengan CDK CLI versi yang lebih lama dari versi yang saat ini pada saat rilis perpustakaan CDK. Namun, ini tidak dijamin. Kompatibilitas tergantung pada versi skema perakitan cloud library CDK. AWS CDK Menghasilkan perakitan cloud selama sintesis dan CDK CLI mengkonsumsinya untuk penerapan. Skema yang mendefinisikan format perakitan cloud ditentukan dan berversi secara ketat. Oleh karena itu, versi CDK yang lebih lama CLI perlu mendukung versi skema perakitan cloud dari perpustakaan CDK agar kompatibel.

Ketika versi perakitan cloud yang diperlukan oleh pustaka CDK tidak kompatibel dengan versi yang didukung oleh 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 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.

APIs di AWS CDK perpustakaan utama,aws-cdk-lib, stabil, dan perpustakaan 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). APIs 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.

Baru APIs dalam pengembangan 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 APIs tidak pernah dihapus, hanya usang, 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 tingkat yang lebih tinggi (L2 atau L3) APIs mulai dikembangkan untuk AWS layanan yang sebelumnya hanya memiliki L1 APIs, mereka awalnya didistribusikan dalam APIs 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, modul APIs 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.