Amazon S3 内のファイルを使用して構築を作成する - Amazon GameLift Servers

Amazon S3 内のファイルを使用して構築を作成する

ビルドファイルを Amazon S3 に保存し、そこから Amazon GameLift Servers にアップロードできます。ビルドを作成するときに S3 バケットのロケーションを指定すると、Amazon GameLift Servers は Amazon S3 から直接ビルドファイルを取得します。

ビルドリソースを作成するには
  1. 構築ファイルをAmazon S3 に保存する。パッケージ化されたビルドファイルを含む .zip ファイルを作成し、それを AWS アカウント の S3 バケットにアップロードします。バケットラベルとファイル名をメモしておきます。Amazon GameLift Servers ビルドを作成するときに必要になります。

  2. Amazon GameLift Servers にビルドファイルへのアクセスを許可します。Amazon S3 でゲームビルドファイルにアクセスする」の指示に従って IAM ロールを作成します。ロールを作成したら、新しいロールの Amazon リソースネーム (ARN) をメモしておきます。ビルドを作成するときにこれが必要になります。

  3. ビルドを作成します。Amazon GameLift Servers コンソールまたは AWS CLI を使用して新しいビルドレコードを作成します。「Amazon GameLift Servers 向け IAM アクセス許可の例」の説明の通り、PassRole アクセス許可が必要です。

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

  2. [ビルド] ページで [ビルドを作成] を選択します。

  3. [ビルドを作成] ページの [ビルド設定] で、次の操作を行います。

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

    2. [バージョン] に、バージョンを入力します。ビルドのコンテンツは更新できるので、バージョンデータは更新の追跡に役立ちます。

    3. [オペレーティングシステム (OS]) では、ゲームサーバービルドの OS を選択します。この値を後で更新することはできません。

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

    5. [IAM ロール] では、Amazon GameLift Servers に S3 バケットとビルドオブジェクトへのアクセスを許可するために作成したロールを選択します。

  4. (オプション) [タグ][キー][値] のペアを入力して、ビルドにタグを追加します。

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

Amazon GameLift Serversは、ID を新しいビルドに割り当て、指定した zip ファイルをアップロードします。[ビルド] ページでは、ステータスを含めて新しいビルドを確認できます。

AWS CLI

新しいビルドを定義し、サーバービルドファイルをアップロードするには、create-build コマンドを使用します。

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

  2. 次の create-build コマンドを入力します。

    aws gamelift create-build \ --name user-defined name of build \ --server-sdk-version server SDK for Amazon GameLift Servers version \ --operating-system supported OS \ --build-version user-defined build number \ --storage-location "Bucket"=S3 bucket label,"Key"=Build .zip file name,"RoleArn"=Access role ARN} \ --region region name
    • name – 新しいビルドのわかりやすい名前。

    • server-sdk-version – ゲームサーバーを Amazon GameLift Servers と統合するために使用したサーバー SDK for Amazon GameLift Servers のバージョンです。Amazon GameLift Servers の値を指定しない場合、4.0.2 はデフォルト値を使用します。

    • operating-system – ゲームサーバービルドのランタイム環境。OS を指定する必要があります。これを後で更新することはできません。

    • build-version – ビルドファイルのバージョンの詳細。ゲームサーバーの新しいバージョンごとに新しいビルドリソースが必要になるため、この情報は役に立ちます。

    • storage-location

      • Bucket – ビルドを含む S3 バケットの名前。例:「my_build_files」。

      • Key – ビルドファイルを含む .zip ファイルの名前。例:「my_game_build_7.0.1, 7.0.2」。

      • RoleARN – 作成した IAM ロールに割り当てられた ARN。例:「arn:aws:iam::111122223333:role/GameLiftAccess」。ポリシーの例については「Amazon S3 でゲームビルドファイルにアクセスする」を参照してください。

    • region – フリートをデプロイする予定の AWS リージョンにビルドを作成します。ゲームを複数のリージョンにデプロイする場合、各リージョンにビルドを作成します。

      注記

      configure get コマンド を使用して現在のデフォルトリージョンを確認することをおすすめします。デフォルトのリージョンを変更するには、configure set コマンドを使用します。

    aws gamelift create-build \ --operating-system WINDOWS_2022 \ --storage-location "Bucket"="my_game_build_files","Key"="mygame_build_101.zip","RoleArn"="arn:aws:iam::111122223333:role/gamelift" \ --name "My Game Nightly Build" \ --build-version "build 101" \ --region us-west-2
  3. 新しいビルドを表示するには、describe-build コマンドを使用します。