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
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.
catatan
Untuk detail selengkapnya tentang skema perakitan cloud, lihat Pembuatan Versi Cloud Assembly
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 Beta
akhiran, di mana N
N
dimulai dari 1 dan ditambah dengan setiap perubahan yang melanggar ke API baru. Beta
API tidak pernah dihapus, hanya tidak digunakan lagi, sehingga aplikasi Anda yang ada terus bekerja dengan versi yang lebih baru. N
aws-cdk-lib
Saat API dianggap stabil, API baru tanpa Beta
akhiran ditambahkan.N
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.
Language | Stability |
---|---|
TypeScript | Stable |
JavaScript | Stable |
Python | Stable |
Java | Stable |
C#/.NET | Stable |
Go | Stable |