GS2-Freeze API リファレンス

GS2のマイクロサービスのバージョンを固定するためのインターフェースを提供するマイクロサービス

GS2は日々更新されており、その更新による影響を最小限にするためにコードベースを固定する機能を提供します。
本マイクロサービスを通してバージョンを固定する機能を提供しますが、不具合修正や脆弱性への対処といったサポートは最新のコードベースからの差分としてしか提供されません。
そのため、本機能を利用したとしても最低でも1ヶ月に一回（毎週を推奨）は最新のコードベースに追従するようにしてください。

GS2-Freeze の中心となる概念が「ステージ (Stage)」です。
ステージは「特定の時点で固定された GS2 マイクロサービスのバージョンの集合」を表します。

ゲームのクライアント・サーバーは、利用したいステージを指定してGS2のAPIを呼び出すことで、そのステージに固定されたバージョンのマイクロサービスを利用できます。

ステージのバージョンを更新する操作を「プロモート (Promote)」と呼びます。
プロモートを実行すると、ソースステージに固定されているバージョンが、対象のステージにコピーされます。
たとえば「staging ステージのバージョンを production ステージへプロモートする」ことで、検証済みのバージョンを本番に反映できます。

プロモート後に問題が発覚した場合は、「ロールバック (Rollback)」を実行して直前のバージョンに戻すことが可能です。

sortNumber を利用することで、複数のステージを「開発」「ステージング」「本番」のような階層として並べることができます。
ソート順はマネージメントコンソール上の表示順や、プロモート対象を選択する際の参考情報として用いられます。