リアルタイムサーバースクリプトを Amazon GameLift にアップロードします

ゲームにリアルタイムサーバーをデプロイする準備ができたら、完了したリアルタイムサーバースクリプトファイルを Amazon GameLift にアップロードします。これは、Amazon GameLift スクリプトリソースを作成し、スクリプトファイルの場所を指定して行います。既存のスクリプトリソースの新しいファイルをアップロードして、すでにデプロイされているサーバースクリプトファイルを更新することもできます。

新しいスクリプトリソースを作成すると、Amazon GameLift は一意のスクリプト ID (script-1111aaaa-22bb-33cc-44dd-5555eeee66ff など） を割り当て、スクリプトファイルのコピーをアップロードします。アップロードの時間はスクリプトファイルのサイズおよび接続速度によって異なります。

スクリプトリソースを作成すると、Amazon GameLift は新しいリアルタイムサーバーフリートでスクリプトをデプロイします。Amazon GameLift は、サーバースクリプトをフリート内の各インスタンスにインストールし、スクリプトファイルを /local/game に配置します。

サーバースクリプトに関するフリートのアクティブ化の問題をトラブルシューティングする方法については、「Amazon GameLift フリートの問題をデバッグする」を参照してください。

スクリプトファイルをパッケージ化する

サーバースkクリプトでは、1 つ以上のファイルを組み合わせて単一 .zip のファイルにまとめ、アップロードすることができます。.zip ファイルには、スクリプトが実行に必要なすべてのファイルが含まれている必要があります。

zip スクリプトファイルは、ローカルファイルディレクトリまたは Amazon Simple Storage Service (Amazon S3) バケットのいずれかに保存することができます。

ローカルディレクトリからスクリプトファイルをアップロードする

スクリプトファイルをローカルに保存している場合は、そこからスクリプトファイルを Amazon GameLift にアップロードできます。スクリプトリソースを作成するには、Amazon GameLift コンソールまたは AWS Command Line Interface (AWS CLI) のいずれかを使用します。

Amazon GameLift console

スクリプトリソースを作成するには

1. [Amazon GameLift コンソール] を開きます。

2. ナビゲーションペインで [ホスティング]、[スクリプト] を選択します。

3. [スクリプト] ページで [スクリプトを作成] を選択します。

4. [スクリプトを作成] ページの [スクリプト設定] で、次の操作を行います。

   1. [名前] にスクリプト名を入力します。

   2. (オプション) [バージョン] にバージョン情報を入力します。スクリプトのコンテンツは更新できるため、バージョンデータは、更新を追跡する場合に便利です。

   3. [スクリプトソース] で [.zip ファイルをアップロード] を選択します。

   4. [スクリプトファイル] では、[ファイルを選択] を選択し、スクリプトを含む.zip ファイルを参照して、そのファイルを選択します。

5. (オプション) [タグ] に [キー] と [値] のペアを入力して、スクリプトにタグを追加します。

6. [Create] (作成) を選択します。

   Amazon GameLift は、ID を新しいスクリプトに割り当て、指定した zip ファイルをアップロードします。新しいスクリプト (例: ステータス) は、コンソールの [スクリプト] ページで確認できます。

AWS CLI

create-script AWS CLI コマンドを使用して、新しいスクリプトを定義し、サーバースクリプトファイルをアップロードします。

スクリプトリソースを作成するには

1. この zip ファイルを、AWS CLI を使用できるディレクトリに配置します。

2. コマンドラインウィンドウを開き、zip ファイルを配置したディレクトリに切り替えます。

3. 次の create-script コマンドとパラメータを入力します。--zip-file パラメータで、文字列 fileb:// を zip ファイルの名前に必ず追加します。Amazon GameLift が圧縮されたコンテンツを処理できるように、ファイルはバイナリとして識別されます。

   aws gamelift create-script \
       --name user-defined name of script \
       --script-version user-defined version info \
       --zip-file fileb://name of zip file \
       --region region name

   例

   aws gamelift create-script \
       --name "My_Realtime_Server_Script_1" \
       --script-version "1.0.0" \
       --zip-file fileb://myrealtime_script_1.0.0.zip \
       --region us-west-2

   リクエストに応じて、Amazon GameLift より、新しいスクリプトオブジェクトが返ります。

4. 新しいスクリプトを表示するには、describe-script を呼び出します。

Amazon S3 からスクリプトファイルをアップロードする

スクリプトファイルは Amazon S3 バケットに保存する、そしてそこから Amazon GameLift にアップロードできます。スクリプトを作成する場合、S3 バケットのロケーションを指定すると、Amazon GameLift によって、スクリプトファイルは Amazon S3 から取得されます。

スクリプトリソースを作成するには

1. スクリプトファイルを S3 バケットに保存します。サーバースクリプトファイルを含む.zip ファイルを作成し、それを管理しているAWS アカウント 内の S3 バケットにアップロードします。オブジェクト URI をメモします。Amazon GameLift スクリプトを作成するときに必要になります。

   注記

   Amazon GameLift は、ピリオド (.) を含む名前の S3 バケットからのアップロードをサポートしていません。

2. Amazon GameLift にスクリプトファイルへのアクセス権を付与します。サーバースクリプトを含む S3 バケットへのアクセスを Amazon GameLift に許可する AWS Identity and Access Management IAM ロールを作成するには、Amazon の IAM サービスロールを設定する GameLift の手順に従ってください。新しいロールを作成したら、名前を書き留めておきます。これはスクリプトの作成時に必要になります。

3. [Create a script].(スクリプトを作成します)。Amazon GameLift コンソールまたは AWS CLI を使用して新しいスクリプトレコードを作成します。このリクエストを実行するには、「Amazon GameLift の IAM アクセス許可の例」に記載のとおり、IAM PassRole アクセス許可が必要です。

Amazon GameLift console

1. [Amazon GameLift コンソール] のナビゲーションペインで、[ホスティング]、[スクリプト] を選択します。

2. [スクリプト] ページで [スクリプトを作成] を選択します。

3. [スクリプトを作成] ページの [スクリプト設定] で、次の操作を行います。

   1. [名前] にスクリプト名を入力します。

   2. (オプション) [バージョン] にバージョン情報を入力します。スクリプトのコンテンツは更新できるため、バージョンデータは、更新を追跡する場合に便利です。

   3. [スクリプトソース] では [Amazon S3 URI] を選択します。

   4. Amazon S3 にアップロードしたスクリプトオブジェクトの S3 URI を入力し、[オブジェクトバージョン] を選択します。Amazon S3 URI とオブジェクトのバージョンを覚えていない場合は、[S3 の参照] を選択し、スクリプトオブジェクトを検索します。

4. (オプション) [タグ] に [キー] と [値] のペアを入力して、スクリプトにタグを追加します。

5. [Create] (作成) を選択します。

   Amazon GameLift は、ID を新しいスクリプトに割り当て、指定した zip ファイルをアップロードします。新しいスクリプト (例: ステータス) は、コンソールの [スクリプト] ページで確認できます。

AWS CLI

create-script AWS CLI コマンドを使用して、新しいスクリプトを定義し、サーバースクリプトファイルをアップロードします。

1. コマンドラインウィンドウを開き、AWS CLI を使用できるディレクトリに切り替えます。

2. 次の create-script コマンドとパラメータを入力します。--storage-location パラメータでは、スクリプトファイルの Amazon S3 バケットの場所を指定します。

   aws gamelift create-script \
       --name [user-defined name of script] \
       --script-version [user-defined version info] \
       --storage-location "Bucket"=S3 bucket name,"Key"=name of zip file in S3 bucket,"RoleArn"=Access role ARN \
       --region region name

   例

   aws gamelift create-script \
       --name "My_Realtime_Server_Script_1" \
       --script-version "1.0.0" \
       --storage-location "Bucket"="gamelift-script","Key"="myrealtime_script_1.0.0.zip","RoleArn"="arn:aws:iam::123456789012:role/S3Access" \
       --region us-west-2

   リクエストに応じて、Amazon GameLift より、新しいスクリプトオブジェクトが返ります。

3. 新しいスクリプトを表示するには、describe-script を呼び出します。

スクリプトファイルを更新する

Amazon GameLift コンソールまたは update-scriptAWS CLI コマンドを使用して、スクリプトリソースのメタデータを更新できます。

スクリプトリソースのスクリプトコンテンツを更新することもできます。Amazon GameLift は、更新されたスクリプトリソースを使用するすべてのフリートインスクリプトコンテンツをスクリプトデプロイします。更新されたスクリプトがデプロイされると、新しいゲームセッションの開始時に、インスタンスはそれを使用します。更新時にすでに実行されているゲームセッションは更新済みスクリプトを使用しません。

スクリプトファイルを更新するには

• ローカルに保存されたスクリプトファイルの場合、更新されたスクリプト .zip ファイルをアップロードするには、Amazon GameLift コンソールまたは update-script コマンドを使用します。

• Amazon S3 バケットに保存されたスクリプトファイルの場合、更新されたスクリプトファイルを S3 バケットにアップロードします。Amazon GameLift は、更新されたスクリプトファイルを定期的にチェックし、S3 バケットから直接取得します。