以前のバージョンからのアップグレード¶

あるバージョンから別のバージョンの Genvid SDK にアップグレードする際には、いくつかの手順があります。このページでは、最後のバージョンからバージョン 1.31.0 にアップデートするために必要な手順を説明します。SDK の以前のバージョンをアップグレードする場合は、こちらで、ご使用のバージョンのための特別なアップグレード手順から始めてください。

In This Section

一般的な更新方法
1.30.0 から 1.31.0 へのアップグレード
以前のバージョンからのアップグレード

一般的な更新方法 ¶

Genvid SDK のアップグレード¶

新規 SDK をローカルにセットアップする方法

新規 SDK をインストールする。
Python スクリプトを実行して、Genvid Toolbox をインストールする。
```
py install-toolbox.py
```
Genvid Bastion スクリプトを実行して、bastion をアップデートする。
```
genvid-bastion reinstall --reconfigure -b {mybastion} -uml
```

配信 Web サイトのアップデート¶

プロジェクトで弊社提供のサンプルのコードを使用する際に、サンプルで consul を使用してサービスを発見しやすくなりました。サンプルを再度ご確認いただき、必要に応じてプロジェクトを更新してください。URL が健全なサービスを指す可能性が高いため、サービスの URL を取得するには、catalog api ではなく consul health api を使用されることをおすすめします。

ゲームのアップデート¶

新機能を適用せずにゲームをアップデートするには、以前の SDK の古い genvid.dll を新しい SDK のものに差し替えます。古いプラグインと統合は、そのままで動作しますが、以下の例外があります。

注意

ご使用の Genvid SDK のバージョンのアップグレードの順序に常に省略することなく従ってください。例えば、バージョン 1.6.0 から 1.10.0 にアップグレードする場合、まず、1.6.0 から 1.7.0 へのアップグレードから始めて各バージョンを進めていってください。

ご使用の特定バージョンに関しては、アップグレード手順一覧を参照してください。

Javascript API のアップグレード¶

Web サイトの Genvid JavaScript API もアップグレードしてください。

クラスタのアップグレード¶

以前のクラスタはそのまま残し、アップデート用に新たに作成することを推奨します。

新しいクラウドベースのクラスタを作成するには、一般的な指示に従ってください。

新しいバージョンにマッチする新規 wingame AMI の設定。
新規クラスタの作成。

新しいローカルクラスタを作成するには、ローカルクラスタの初期化セクションに記載されている一般的な指示に従ってください。

すべてのクラスタの差し替えが完了したら、モジュールセクションページから古い SDK レポジトリを削除して構いません。

既存クラスタのアップデート¶

警告

クラスタをアップデートすることで、全てのインスタンスを置き換えたり、現在の設定を削除することができます。ライブクラスタのアップデートは行わないことをお勧めします。ライブクラスタのアップデートを行う場合、プランを適用する前に、変更内容をよく確認してください。

クラスタの構築に使用するモジュールの更新には、クラスタのインフラストラクチャにあるモジュールセクションの Reimport Module をクリックし、新しいバージョンのモジュールを選択してインポートします。最後に、Terraform セクションの適用をクリックします。

注釈

変更の中には、AWS の適用に時間がかかるものが存在します。特に、IAM の役割やポリシーなどがそれにあたり、作成しなおす際に、競合が発生する場合があります。Terraform プランを適用しなおすことで、問題は解決されます。

Genvid SDK サンプルのアップデート¶

プロジェクトと一緒に、それまでにインストールした Genvid SDK サンプルのアップデートを行ってください。

1.30.0 から 1.31.0 へのアップグレード ¶

`genvid-sdk version` は `genvid-sdk cluster-version` に変更。¶

統一性のためコマンド genvid-sdk cluster-version を genvid-sdk version に名称変更しました。 genvid-sdk version は、 genvid-toolbox パッケージのバージョンを返すようになりました (genvid-bastion version と同様)。

`RuntimeTool.template_dir` は廃止されました。¶

template_dir は廃止されました。 GENVID_BASTION_JOB_TEMPLATE_FOLDER を使用してください。

`SDK.update_config` が更新されました。¶

メソッドを ProjectTool に移動し、新しい引数 isLocal を追加。デフォルトは True です。

`nats-window` は `nats-windows` に変更。¶

商標との整合性を図るため、 nats-window の名称を nats-windows に変更するとともに、関連するタスクやログを追加しました。また、 SDK バージョンではなく、 NATS バージョンをタグとして使用するようになりました。さらに、このタスク自体を nats というジョブの一つのジョブとして統合しました。

この画像やジョブを特別に監視していない限り、この変更による影響はありません。

`local-services` フォルダの変更¶

ROOTDIR/bastion-services/templates/services.nomad.tmpl を ROOTDIR/local-services/templates/services.nomad.tmpl に移動しました。ローカルクラスタの設定は、 genvid-toolbox にハードコードされていましたが、このフォルダから行うようになりました。