OpenAPI Portal は Alibaba Cloud SDK V1.0 のサポートを終了しました。現在 SDK V1.0 をご利用の場合は、ドキュメントで移行ガイドとサポートをご確認いただくことを強く推奨します。
特定の要件やさらなる支援が必要な場合は、DingTalk グループ (グループ ID: 60965016010) にご参加の上、お問い合わせください。
1. 概要
このトピックでは、バージョンリリースポリシー、更新ポリシー、サポート終了ポリシーなど、Alibaba Cloud SDK のメンテナンスポリシーについて説明します。
2. ライフサイクルとメンテナンスポリシー
Alibaba Cloud SDK のライフサイクル全体は、次の段階で構成されています。一般提供段階、基本セキュリティメンテナンス段階、およびサポート終了段階。次の表は、各段階のメンテナンスポリシーと特性を示しています。
ライフサイクル段階 | メンテナンスポリシー | API カバレッジとリリースサイクル | 推奨事項 | ヘルプセンターや OpenAPI Portal などの Alibaba Cloud プラットフォームでのサポート | ホストされているコードリポジトリやコミュニティなどのサードパーティプラットフォームでのサポート |
一般提供段階
| Alibaba Cloud は新機能のリリース、パフォーマンスの最適化、バグの修正、SDK のセキュリティパッチの更新を行います。 | SDK はすべての API 操作をサポートし、API のリリース後 24 時間以内に自動的に更新およびリリースされます。 | SDK はすべてのユーザーとプロジェクトに推奨されます。 | 推奨としてマークされています。 Alibaba Cloud は、一連のドキュメントとサンプルコードを提供し、できるだけ早く更新することを約束します。 | 推奨としてマークされています。 |
基本セキュリティメンテナンス段階 | Alibaba Cloud は新機能をリリースしませんが、重要なセキュリティパッチを定期的に更新し、サービスの安定性を著しく阻害する SDK のバグを修正します。 | API 操作のカバレッジは保証されていません。 SDK は、必要な場合にのみ、新しい API 操作をサポートするために更新およびリリースされます。 | SDK は安定して稼働しているシステムに適しており、新しいプロジェクトや初心者にはお勧めしません。 | 推奨しないとしてマークされています。 Alibaba Cloud は、一連のドキュメントとサンプルコードを提供しますが、できるだけ早く更新することを約束するものではありません。 Alibaba Cloud は、ユーザーが最新の SDK バージョンに更新するための移行リファレンスを提供します。 | 推奨しないとしてマークされています。 Alibaba Cloud は、ユーザーが最新の SDK バージョンに更新または使用するための移行リファレンスを提供します。 |
サポート終了段階
| Alibaba Cloud は、セキュリティ更新を含む SDK の更新を一切提供しなくなります。 SDK では、いかなる種類の問題も受け付けられません。 | Alibaba Cloud は SDK の更新のリリースを停止します。 | SDK は初心者にはお勧めしません。既存のシステムは、ビジネスの継続性とセキュリティを確保するために、できるだけ早く最新の SDK バージョンに移行する必要があります。 | SDK はオフラインになるか、すべての入り口が非表示になります。 | サポート終了としてマークされています。 Alibaba Cloud は、ユーザーが最新の SDK バージョンに更新または使用するための移行リファレンスを提供します。 SDK では、いかなる種類の問題も受け付けられません。 |
3. リリースポリシー
Alibaba Cloud SDK のパッケージは、Maven、npm、Python Package Index（PyPI）、NuGet、CocoaPods、Packagist など、さまざまな言語の公式パッケージマネージャーにリリースされます。 Alibaba Cloud はまた、GitHub 上のサポートされているすべての言語で SDK のソースコードを公開しています。詳細については、「バージョンのサポート」をご参照ください。
3.1 Alibaba Cloud SDK の世代
Alibaba Cloud は 2 つの世代の SDK を提供しています。Alibaba Cloud SDK V1.0 と V2.0 です。 Alibaba Cloud SDK V2.0 は、開発者が Alibaba Cloud SDK V1.0 を使用するときに発生する一連の問題を解決します。 Alibaba Cloud SDK V2.0 は、SDK の使用を簡素化し、SDK の使用コストを削減し、SDK の堅牢性を向上させるための多くの新機能を提供します。 Alibaba Cloud SDK V1.0 と V2.0 の違いの詳細については、「Alibaba Cloud SDK V1.0 と V2.0」をご参照ください。
SDK のメンテナンスポリシーの詳細については、このトピックのライフサイクルとメンテナンスポリシーセクションをご参照ください。さまざまな言語の各世代の SDK のサポート終了ステータスの詳細については、「バージョンのサポート」をご参照ください。
3.2 バージョン番号の仕様
各世代の Alibaba Cloud SDK のバージョン番号の変更は、セマンティックバージョニング仕様に準拠しています。
バージョン番号は Major.Minor.Patch 形式です。
|
SDK のメジャーバージョンをインクリメントすると、現在の言語の新しいイディオムとパターンをサポートするために、SDK に重要な変更が加えられたことを示します。メジャーバージョンは、クラス名、メソッド名、パラメーター名、パラメータータイプ、動作、セマンティクスなどのパブリックインターフェースに変更が加えられたときに導入されます。つまり、SDK で互換性を損なう変更が行われたときに、メジャーバージョンが導入されます。メジャーバージョンがリリースされた後、最新の SDK を使用するには、クライアントを更新する必要があります。 Java V3.1.17 用 Elastic Compute Service（ECS）SDK のリリースレポートなど、Alibaba Cloud が提供する SDK リリースレポートに基づいて、メジャーバージョンを更新する必要があります。
3.3 互換性の保証
異なる世代の SDK は互いに互換性がありません。 Alibaba Cloud SDK V1.0 から V2.0 へのアップグレード方法の詳細については、「Alibaba Cloud SDK V1.0 から V2.0 へのアップグレード」をご参照ください。
同じ世代の Alibaba Cloud SDK のバージョン番号は、セマンティックバージョニング仕様に準拠しています。 Alibaba Cloud は、すべての言語の SDK のマイナーバージョンとパッチバージョンに下位互換性があることを保証します。メジャーバージョンのみが下位互換性がない場合があります。
4. 更新ポリシー
Alibaba Cloud は、Alibaba Cloud SDK とその基盤となる依存関係を定期的に更新します。サードパーティの依存関係は、次の 3 つのカテゴリに分類されます。
CentOS 7、Windows 7、Windows 10、macOS 12.x などのオペレーティングシステム
Java 8、Java 11、.NET Core、PHP7、PHP8、Node.js 14.x などの言語ランタイム
OpenSSL、.NET Framework 4.5、Java EE などのサードパーティライブラリとフレームワーク
サードパーティの依存関係のライフサイクルは、関連する言語コミュニティまたはその特定のコンポーネントを所有するベンダーによって決定されます。各コミュニティまたはベンダーは、自社製品のサポート終了タイムラインを公開しています。
各言語コミュニティのメンテナンスポリシー:
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
コミュニティまたはベンダーが言語バージョンのサポートを終了した後、Alibaba Cloud は Alibaba Cloud SDK でのその言語バージョンのサポートを少なくとも 1 年間継続することを保証します。
言語バージョンは、コミュニティまたはベンダーが特定のプログラミング言語（Java 8 や Python 3.7 など）に対してリリースしたバージョンを示します。
5. サポート終了ポリシー
5.1 サポート終了のきっかけ
言語のコミュニティが言語バージョンまたは依存ライブラリのサポート終了を発表した後、Alibaba Cloud は約 1 年で言語バージョンまたは依存ライブラリのサポート終了の発表を行い、6 か月後に言語バージョンまたは依存ライブラリのサポートを終了します。サポートの終了は、既存の SDK の通常の使用には影響しませんが、セキュリティパッチや新機能は提供されません。
5.2 発表内容
サポート終了の具体的な理由
サポート終了の具体的な時間
既存の SDK を引き続き使用し、サポートされている SDK に更新するための手順
移行リファレンス
5.3 通知方法
Alibaba Cloud は、サポート終了の理由に関する公式の説明を提供し、次の方法でユーザーに通知します。
1 年前にサポート終了のお知らせを公開し、ユーザーに送信します。たとえば、サポート終了のお知らせは OpenAPI Portal とヘルプセンターの SDK リファレンスに公開され、OpenAPI Portal と Alibaba Cloud 管理コンソールのメッセージを使用してユーザーに送信されます。
OpenAPI ポータルとヘルプセンターの SDK リファレンスに移行リファレンスを提供します。
一部の言語の SDK に通知を追加します。たとえば、サポートされていない SDK バージョンをインストールしようとすると、警告通知が表示されます。