クラウド環境の作成

ゲームで Genvid SDK を使用するには、Genvid クラスタサービスを実行するクラウド環境が必要となります。Azure アカウントの設定から始まり、新しい環境を使用するための準備に必要なすべての手順をご案内します。

重要

Genvid SDK には、Microsoft Azure、Amazon Web Services (AWS) でクラスタを管理するために必要な Terraform テンプレートが含まれています。他のサービスプロバイダ (Google Cloud など) を使用する場合の設定方法については、直接お問い合わせ ください。

初めてクラスタを設定するには、約 1 時間かかります。作成したクラスタは、チームの他のユーザーと共有することができます。

はじめに

注釈

Azure を利用する場合、Python 3.8.x に Genvid Toolbox がインストールされている必要があります。 ツールボックスのインストール。Python のバージョンは以下のコマンドで確認できます。

py -3 --version

Azure で実行するには、まず、Azure へのアクセスが有効になっている Microsoft アカウントが必要です。Genvid Technologies は、お客様のアカウントでの課金については一切責任を負いませんのでご注意ください。

アカウントの設定の詳細については Azure portal を参照してください。

Azure へのサインイン

Azure アカウントを作成したら、ローカルマシンで Azure コマンドラインインターフェイス (CLI) を設定します。以下のコマンドでブラウザページを開き、Azure リソース上で CLI が操作できるように認証を行います。

az login

詳細は Azure Web サイトの Get started with Azure CLI を参照してください。

bastion をまだインストールしていない場合は、以下の手順 Bastion サーバーの設定 でインストールしてください。bastion のインストール後、以下のセクションで説明するイメージの作成を進めることができます。

イメージを作成

新しいクラスタを作成するたびに大きなイメージをアップロードしないようにするには、まずサブスクリプションでベースイメージを作成する必要があります。作成すると、Terraform モジュールで新しい Azure クラスタを構築する際に使用できます。

重要

イメージは、作業する
Genvid SDK のバージョンが上がるたびに、新しいイメージを作成する必要があります。

  1. Azure サブスクリプションへのサインイン

  2. CLI で、以下を実行します。

    genvid-azure-image create-images

イメージの作成には、30 分から 1 時間かかります。終了すると、共有ギャラリー (SDKgallery) を含むリソースグループ (Genvid) が作成されます。共有ギャラリーには Linux 用と Windows 用の 2 つのイメージ:が含まれています。Linux 用は genvidtech-server イメージ定義リソース、Windows 用は genvidtech-wingame という名称で、どちらも現在の SDK バージョンとなります。

create-images コマンドにはオプションの引数があり、Azure 上でリソースを割り当てるためのデフォルト値を、オーバーライドするために使用できます。引数が使用されている場合は、以下のコマンドでも同様にオーバーライドする必要があります。また、Bastion Terraform の設定でグローバルに登録しておくと、Azure クラスタ作成時に利用できるので便利です。作成するクラスタごとに指定する必要はありません。

実行方法は以下の通りです。

  1. Bastion UI を開きます。

  2. Settings をクリックします。

  3. Global Vars をクリックします。

  4. shared_gallery_resource_group_name、 shared_gallery_image_version、shared_gallery_name を**genvid-azure-image create-images** で指定された値で追加します。

    たとえば、作成されたリソースグループが genvidtest であれば、shared_gallery_resource_group_name:genvidtest を追加します。

値が追加されると、新しいクラスタを作成する際に、作成したイメージが使用されます。

ゲーム VM を起動して設定を完了させる

ゲーム VM は、ゲームを実行するためにドライバと設定が必要になります。ここでは、後で使用するための設定を行なうために VM を起動する方法を説明します。この VM でイメージが作成され、Azure クラスタで使用できます。

  1. 以下のコマンドでゲーム VM を作成して起動します。CLUSTER_ID は任意の値に置き換えてください。Azure の仮想マシン名と、我々の命名規則では 15 文字の制限があるため、CLUSTER_ID は最大 5 文字となります。

    genvid-azure-image setup CLUSTER_ID

    img が付加された CLUSTER_ID という名前の Bastion 内のクラスタが起動します。また、VM のパブリック IP が出力されます。

    注意点として、先に実行した create-images コマンドでイメージをインポートする際に使用した場所と同じ場所を指定する必要があります。違う場所を指定すると、Terraform がベースイメージを見つけることができません。デフォルト値を使用していない場合は、Azure リソースグループと共有ギャラリー名も適切に指定する必要があります。その際、コマンドで追加の引数を使用して行うことができます。

    このコマンドで作成されたすべてのリソースは、サフィックス img-setup が付加された CLUSTER_ID の名称の新しい Azure リソースグループに配置されます。

  2. VNC クライアントを使用して、回復した IP とポート 5900 を使用して VM に接続します。パスワードは 1genvid6 です。

  3. 接続後は 初めてゲームマシンに接続する場合 の手順に従ってください。

  4. 次に、 Windows インスタンスの設定 の手順に従います。

設定した VM からイメージを作成する

Windows のゲーム VM の設定が完了したので、以下のコマンドを使ってイメージを作成する必要があります。

前のステップで使用した CLUSTER_ID を使用します。

genvid-azure-image save CLUSTER_ID

サフィックス imgsave が付加された CLUSTER_ID という名前のクラスタが Bastion に作成されます。

イメージが作成されると、他のイメージと同じリソースグループと共有画像ギャラリーに、イメージ定義名 default-wingame で表示されます。

セットアップクラスタのクリーンアップ

この時点で、前のステップで作成した 2 つのクラスタを Bastion から削除し、不要になったリソースを削除する必要があります。以下のコマンドを実行してください。

genvid-azure-image clean CLUSTER_ID

もう一度 CLUSTER_ID を使用します。