1.19.0 から 1.20.0 へのアップグレード¶
gvencode
オプションの変更¶
gvencode
オプション -p healthPort を -h healthAddress に変更。IPAddress:Port を含む文字列が必要になりました。gvencode
を呼び出すテンプレートを調整してください。
Nomad をアップグレード¶
Genvid SDK で使用している Nomad のバージョンをアップグレードしました。そのため、コードの調整が必要になる場合があります。
Windows の Nomad によるジョブでは、IPv6 アドレスがデフォルトで優先されます。今回の変更により、IPv6 のサポートを追加しました。Nomad テンプレートを調整して IPv6 アドレス (たとえば、::1) を検出し、適切にラップを行うことが必要になることがあります。
セットアップを Genvid SDK サンプルの 1 つをもとに行っている場合、セットアップの :file:config.ts を、 IPv6 アドレスを正しくラップする :file:/samples/tutorial/web/utils/config.ts に置き換えてください。
注釈
更新された config.ts
ファイルは、すべての Genvid SDK デモで使用いただけます。
新しい JavaScript API モジュール¶
Genvid SDK で、JavaScript モジュールの NPM パッケージでのインポートがサポートされるようになりました。実行するには、genvid
および genvidMath
の両パッケージをインストールします。
npm install -s path/to/genvid.tgz
npm install -s path/to/genvid-math.tgz
その後は、通常通りインポートできます。
import { createGenvidClient, IGenvidClient } from 'genvid';
import * as genvidMath from 'genvid-math';
注釈
Web アプリケーションを Dockerize する場合、インポート前に Docker に tgz ファイルをコピーしておく必要があります。
Genvid モジュールを NPM パッケージでインポートして Dockerize するサンプルについては、 Web サンプル または 負荷テスターサンプル を参照してください。
<scrip src=」…」/> タグを参照している場合 genvid.umd.js
および genvid-math.umd.js
ファイルの参照を推奨します。」genvid」 ライブラリは、グローバル変数 genvid
および genvidMath
ライブラリ (「genvidMath」) で公開されます。
Genvid TypeScript 定義ファイルは、ソースコードに直接 含めない ことをお勧めします。アップグレードを簡略化するために必要な場合、Genvid SDK は /api/web/legacy_types/
フォルダに用意されています。
このメソッドのサンプルについては、 DirectX Cube サンプル統合 および Unreal Engine サンプルを参照してください。
詳細については、 Web サイト統合 セクションを参照してください。
DockerTool
が default
に DOCKER_MACHINE_NAME
を設定しなくなりました。¶
環境変数 DOCKER_MACHINE_NAME
が設定されていない場合でも、DockerTool
は default
に設定しなくなりました。クライアントはデフォルト設定を使用して Docker ホストに接続します。これは他の環境変数から取得することができます。これにより、DockerTool
が、Docker Machine (Docker for Windows など) を使用しないローカル Docker を使って動作できるようになります。
既知の問題アップグレード後 Terraform Command がクラッシュする¶
場合によっては、既存のクラスタで Bastion UI から Terraform コマンドを実行すると、Terraform コマンドがクラッシュすることがあります。この問題が発生した場合:
.genvid/terraform/workdir/YOUR_CLUSTER_NAME/tf/.terraform/
(ユーザーフォルダ内) にアクセスする。- フォルダ内のすべてのモジュールとファイルを削除する。
- コマンドページから、モジュールをインポートしなおす。
その後、Terraform コマンドが適切に動作するようになります。
既知の問題既知の問題: アップグレード後、既存のクラスタの DESTROY、または PLAN APPLY を実行しようとするとエラーが発生する。¶
Genvid SDK のアップグレード後、[PLAN APPLY]、[PLAN DESTROY] の terraform コマンドがエラーになり、メッセージが表示されます。
エラー:モジュールの読み込みエラー: module vpc: not found, may need to run 『terraform init』.
修正するには、以下のモジュールをインポートし直してください。
- Open Bastion-UI
- Terraform をクリックします。
- 左のナビゲーションバーでクラスタ名のリンクをクリックします。
- re-import module をクリックします。
- [PLAN DESTROY] または [PLAN APPLY] をクリックします。
- 問題が解決するはずです。
ローカルクラスタが Bastion のセットアップ中に構成されなくなりました。¶
genvid-bastion install
コマンドが、ローカルクラスタの自動セットアップを行わなくなりました。他の genvid-sdk
コマンドを実行する前に、以下のコマンドでローカルクラスタを作成できます。
genvid-sdk setup
以前設定したローカルクラスタのアップグレードを行う場合にも、この処理が必要です。
ローカルクラスタの設定後、以下のコマンドを実行して構成します。
genvid-sdk load-config-sdk
C# ラッパーが Failure ステータスを検知するようになりました。¶
statusFailed(status)
関数を使用して、Genvid SDK 関数から戻ってきたステータスが失敗かどうかを検証することができます。この関数は、エラーでない警告をフィルタ処理します。
アップデートを行うには、新しい C# ラッパー DLL を現在のものにコピーします。
Unity サンプルおよびプレハブに対して、 Genvid MILE SDK Unity アセット パッケージ を新しい C# ラッパーでビルドし直し、プロジェクトに再インストールします。