OpenAPI Portal tidak lagi mendukung Alibaba Cloud SDK V1.0. Jika Anda saat ini menggunakan SDK V1.0, kami sangat menyarankan untuk merujuk dokumentasi kami mengenai panduan migrasi dan dukungan.
Untuk kebutuhan khusus atau bantuan lebih lanjut, silakan hubungi kami dengan bergabung ke grup DingTalk kami (ID grup: 60965016010).
1. Ikhtisar
Topik ini menjelaskan kebijakan pemeliharaan untuk Alibaba Cloud SDK, termasuk kebijakan rilis versi, pembaruan, dan akhir dukungan.
2. Kebijakan siklus hidup dan pemeliharaan
Siklus hidup penuh Alibaba Cloud SDK mencakup tahap berikut: ketersediaan umum, pemeliharaan keamanan dasar, dan akhir dukungan. Tabel berikut menjelaskan kebijakan pemeliharaan dan karakteristik setiap tahap.
Tahap Siklus Hidup | Kebijakan Pemeliharaan | Cakupan API dan Siklus Rilis | Rekomendasi | Dukungan di Platform Alibaba Cloud, seperti Help Center dan OpenAPI Portal | Dukungan pada Platform Pihak Ketiga seperti Repositori Kode yang Dihosting dan Komunitas |
Tahap Ketersediaan Umum
| Alibaba Cloud merilis fitur baru, mengoptimalkan kinerja, memperbaiki bug, serta memperbarui patch keamanan untuk SDK. | SDK mendukung semua Operasi API dan secara otomatis diperbarui serta dirilis dalam waktu 24 jam setelah rilis API. | SDK direkomendasikan untuk semua pengguna dan proyek. | Ditandai sebagai Direkomendasikan. Alibaba Cloud menyediakan dokumen lengkap dan kode contoh serta berjanji untuk memperbaruinya sesegera mungkin. | Ditandai sebagai Direkomendasikan. |
Tahap Pemeliharaan Keamanan Dasar | Alibaba Cloud tidak merilis fitur baru tetapi secara rutin memperbarui patch keamanan penting dan memperbaiki bug yang sangat memengaruhi stabilitas layanan untuk SDK. | Cakupan untuk Operasi API tidak dijamin. SDK hanya diperbarui dan dirilis jika diperlukan untuk mendukung Operasi API baru. | SDK cocok untuk sistem yang stabil, namun tidak direkomendasikan untuk proyek baru atau pemula. | Ditandai sebagai Tidak Direkomendasikan. Alibaba Cloud menyediakan dokumen lengkap dan kode contoh tetapi tidak berjanji untuk memperbaruinya sesegera mungkin. Alibaba Cloud menyediakan referensi migrasi untuk membantu pengguna memperbarui ke versi SDK terbaru. | Ditandai sebagai Tidak Direkomendasikan. Alibaba Cloud menyediakan referensi migrasi untuk membantu pengguna memperbarui ke atau menggunakan versi SDK terbaru. |
Tahap Akhir Masa Dukungan
| Alibaba Cloud tidak lagi menyediakan pembaruan apa pun untuk SDK, termasuk pembaruan keamanan. Masalah apa pun tidak diterima untuk SDK. | Alibaba Cloud menghentikan rilis pembaruan SDK. | SDK tidak direkomendasikan untuk pemula mana pun. Sistem yang ada harus bermigrasi ke versi SDK terbaru sesegera mungkin untuk memastikan kelangsungan bisnis dan keamanan. | SDK dibawa offline atau semua pintu masuk disembunyikan. | Ditandai sebagai Akhir Dukungan. Alibaba Cloud menyediakan referensi migrasi untuk membantu pengguna memperbarui ke atau menggunakan versi SDK terbaru. Masalah apa pun tidak diterima untuk SDK. |
3. Kebijakan rilis
Paket Alibaba Cloud SDK dirilis ke manajer paket resmi berbagai bahasa, seperti Maven, npm, Python Package Index (PyPI), NuGet, CocoaPods, dan Packagist. Alibaba Cloud juga menerbitkan kode sumber SDK dalam semua bahasa yang didukung di GitHub. Untuk informasi lebih lanjut, lihat Dukungan Versi.
3.1 Generasi Alibaba Cloud SDK
Alibaba Cloud menyediakan dua generasi SDK: Alibaba Cloud SDK V1.0 dan V2.0. Alibaba Cloud SDK V2.0 menyelesaikan serangkaian masalah yang dihadapi pengembang saat menggunakan Alibaba Cloud SDK V1.0. Alibaba Cloud SDK V2.0 menyediakan banyak fitur baru untuk menyederhanakan penggunaan SDK, mengurangi biaya, serta meningkatkan ketahanan SDK. Untuk informasi lebih lanjut tentang perbedaan antara Alibaba Cloud SDK V1.0 dan V2.0, lihat Alibaba Cloud SDK V1.0 dan V2.0.
Untuk informasi lebih lanjut tentang kebijakan pemeliharaan untuk SDK, lihat bagian Siklus Hidup dan Kebijakan Pemeliharaan dari topik ini. Untuk informasi lebih lanjut tentang status akhir dukungan SDK setiap generasi dalam berbagai bahasa, lihat Dukungan Versi.
3.2 Spesifikasi nomor versi
Perubahan nomor versi Alibaba Cloud SDK setiap generasi mematuhi Spesifikasi Semantic Versioning.
Nomor versi berada dalam format Major.Minor.Patch.
|
Menaikkan versi utama SDK menunjukkan bahwa SDK telah mengalami perubahan signifikan dan substansial untuk mendukung idiom dan pola baru dalam bahasa saat ini. Versi utama diperkenalkan ketika perubahan dilakukan pada antarmuka publik, seperti nama kelas, nama metode, nama parameter, jenis parameter, perilaku, atau semantik. Dengan kata lain, versi utama diperkenalkan ketika perubahan yang merusak dilakukan dalam SDK. Setelah versi utama dirilis, Anda harus memperbarui klien untuk menggunakan SDK terbaru. Anda harus memperbarui versi utama berdasarkan laporan rilis SDK yang disediakan oleh Alibaba Cloud, seperti Laporan Rilis untuk Elastic Compute Service (ECS) SDK for Java V3.1.17.
3.3 Jaminan kompatibilitas
SDK dari generasi yang berbeda tidak kompatibel satu sama lain. Untuk informasi lebih lanjut tentang cara memutakhirkan Alibaba Cloud SDK V1.0 ke V2.0, lihat Tingkatkan Alibaba Cloud SDK V1.0 ke V2.0.
Nomor versi Alibaba Cloud SDK dari generasi yang sama mematuhi Spesifikasi Semantic Versioning. Alibaba Cloud memastikan bahwa versi minor dan versi patch SDK dalam semua bahasa kompatibel mundur. Hanya versi utama yang mungkin tidak kompatibel mundur.
4. Kebijakan pembaruan
Alibaba Cloud secara rutin memberikan pembaruan untuk Alibaba Cloud SDK dan dependensinya yang mendasar. Dependensi pihak ketiga diklasifikasikan menjadi tiga kategori berikut:
Sistem operasi seperti CentOS 7, Windows 7, Windows 10, dan macOS 12.x
Runtimes bahasa seperti Java 8, Java 11, .NET Core, PHP7, PHP8, dan Node.js 14.x
Pustaka dan kerangka kerja pihak ketiga seperti OpenSSL, .NET Framework 4.5, dan Java EE
Siklus hidup dependensi pihak ketiga ditentukan oleh komunitas bahasa terkait atau vendor yang memiliki komponen tersebut. Setiap komunitas atau vendor menerbitkan garis waktu akhir masa pakai untuk produknya sendiri.
Kebijakan pemeliharaan setiap komunitas bahasa:
Node.js: github.com
Python: devguide.python.org
Ruby: www.ruby-lang.org
Java: www.oracle.com
Go: golang.org
.NET Core: dotnet.microsoft.com
PHP: www.php.net
Setelah komunitas atau vendor mengakhiri dukungan untuk versi bahasa, Alibaba Cloud memastikan dukungan berkelanjutan untuk versi bahasa itu dalam Alibaba Cloud SDK setidaknya selama satu tahun.
Versi bahasa menunjukkan versi yang dirilis oleh komunitas atau vendor untuk bahasa pemrograman tertentu, seperti Java 8 dan Python 3.7.
5. Kebijakan akhir dukungan
5.1 Titik pemicu
Setelah komunitas bahasa mengumumkan akhir dukungan untuk versi bahasa atau pustaka dependensi, Alibaba Cloud mengeluarkan pengumuman akhir dukungan untuk versi bahasa atau pustaka dependensi tersebut dalam satu tahun atau lebih dan mengakhiri dukungan untuk versi bahasa atau pustaka dependensi tersebut enam bulan kemudian. Akhir dukungan tidak memengaruhi penggunaan normal SDK yang ada, tetapi tidak akan ada patch keamanan atau fitur baru yang disediakan.
5.2 Isi pengumuman
Alasan spesifik untuk mengakhiri dukungan
Waktu spesifik untuk mengakhiri dukungan
Langkah-langkah untuk terus menggunakan SDK yang ada dan memperbarui ke SDK yang didukung
Referensi migrasi
5.3 Metode notifikasi
Alibaba Cloud memberikan penjelasan resmi tentang alasan mengakhiri dukungan dan memberi tahu pengguna dengan metode berikut:
Menerbitkan dan mengirimkan pengumuman akhir masa dukungan satu tahun sebelumnya. Misalnya, pengumuman akhir masa dukungan dipublikasikan di referensi SDK di OpenAPI Portal dan Help Center, serta dikirimkan kepada pengguna melalui pesan di OpenAPI Portal dan Konsol Manajemen Alibaba Cloud.
Menyediakan referensi migrasi dalam referensi SDK di Portal OpenAPI dan Pusat Bantuan.
Menambahkan notifikasi dalam SDK untuk beberapa bahasa. Misalnya, notifikasi peringatan ditampilkan saat Anda menginstal versi SDK yang tidak didukung.