翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# マネージドホスティング用のAmazon GameLift Serversビルドリソースを作成する
<a name="gamelift-build-cli-uploading-builds"></a>

ビルドを作成してファイルをアップロードするときは、いくつかのオプションがあります。
+ [ファイルディレクトリから構築を作成する](gamelift-build-cli-uploading-upload-build.md)。これは、最もシンプルで一般的に使用されるオプションです。
+ [Amazon Simple Storage Service (Amazon S3) 内のファイルを使用してビルドを作成します](gamelift-build-cli-uploading-create-build.md)。このオプションを使用すると、Amazon S3 でビルドバージョンを管理できます。

どちらの方法でも、Amazon GameLift Servers は一意のビルド ID とその他のメタデータを持つ新しいビルドリソースを作成します。ビルドは **[初期化済み]** ステータスで開始されます。Amazon GameLift Servers によって正常にゲームサーバーファイルが取得されると、ビルドは **[準備完了] **ステータスに移行されます。

ビルドの準備ができたら、新しい Amazon GameLift Servers フリートにデプロイできます。詳細については、[Amazon GameLift Servers マネージド EC2 フリートを作成する](fleets-creating.md) を参照してください。Amazon GameLift Servers によって新しいフリートが設定されると、ビルドファイルが各フリートインスタンスにダウンロードされ、ビルドファイルがインストールされます。

# ファイルディレクトリから構築を作成する
<a name="gamelift-build-cli-uploading-upload-build"></a>

ローカルディレクトリを含む任意の場所に保存されたゲームビルドを作成するには、 [https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/upload-build.html) AWS CLI コマンドを使用します。このコマンドで Amazon GameLift Servers に新しいビルドレコードを作成し、指定した場所からファイルをアップロードします。

**アップロードリクエストを送信します。**コマンドラインウィンドウで、**upload-build** コマンドとパラメータを入力します。

```
aws gamelift upload-build \
    --name user-defined name of build \
    --operating-system supported OS \
    --server-sdk-version server SDK for Amazon GameLift Servers version \
    --build-root build path \
    --build-version user-defined build number \
    --region region name
```
+ **operating-system** – ゲームサーバービルドのランタイム環境。OS を指定する必要があります。これを後で更新することはできません。
+ **server-sdk-version** – ゲームサーバーが統合されている Amazon GameLift Serversサーバー SDK のバージョン。Amazon GameLift Servers の値を指定しない場合、`4.0.2` はデフォルト値を使用します。正しくないサーバー SDK バージョンを指定すると、Amazon GameLift Servers サービスへの接続を確立するために `InitSdk` を呼び出した際に、ゲームサーバービルドが失敗する可能性があります。
+ **build-root** – ビルドファイルのディレクトリパス。
+ **name** – 新しいビルドのわかりやすい名前。
+ **build-version** – ビルドファイルのバージョンの詳細。
+ **region** – ビルドを作成する AWS リージョン。フリートをデプロイする予定のリージョンにビルドを作成します。ゲームを複数のリージョンにデプロイする場合、各リージョンにビルドを作成します。
**注記**  
[https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html) を使用して現在のデフォルトのリージョンを表示します。デフォルトのリージョンを変更するには、[https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html) コマンドを使用します。

*例*

```
aws gamelift upload-build \
    --operating-system AMAZON_LINUX_2023 \
    --server-sdk-version "5.0.0" \
    --build-root "~/mygame" \
    --name "My Game Nightly Build" \
    --build-version "build 255" \
    --region us-west-2
```

```
aws gamelift upload-build \
    --operating-system WINDOWS_2022 \
    --server-sdk-version "5.0.0" \
    --build-root "C:\mygame" \
    --name "My Game Nightly Build" \
    --build-version "build 255" \
    --region us-west-2
```

アップロードリクエストに応じて、Amazon GameLift Servers はアップロードの進行状況を表示します。アップロードが成功すると、Amazon GameLift Servers は新しいビルドレコード ID を返します。アップロードの時間はゲームファイルのサイズおよび接続速度によって異なります。

# Amazon S3 内のファイルを使用して構築を作成する
<a name="gamelift-build-cli-uploading-create-build"></a>

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

**ビルドリソースを作成するには**

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

1. **Amazon GameLift Servers にビルドファイルへのアクセスを許可します。**「[Amazon S3 でゲームビルドファイルにアクセスする](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc)」の指示に従って IAM ロールを作成します。ロールを作成したら、新しいロールの Amazon リソースネーム (ARN) をメモしておきます。ビルドを作成するときにこれが必要になります。

1. **ビルドを作成します。**Amazon GameLift Servers コンソールまたは AWS CLI を使用して、新しいビルドレコードを作成します。「[Amazon GameLift Servers 向け IAM アクセス許可の例](gamelift-iam-policy-examples.md)」の説明の通り、`PassRole` アクセス許可が必要です。

------
#### [ Console ]

1. [[Amazon GameLift Servers コンソール]](https://console.aws.amazon.com/gamelift/) のナビゲーションペインで、**[ホスティング]**、**[ビルド]** を選択します。

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

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

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

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

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

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

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

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

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

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

------
#### [ AWS CLI ]

新しいビルドを定義し、サーバービルドファイルをアップロードするには、[https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/create-build.html) コマンドを使用します。

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

1. 次の **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\$1build\$1files」。
     + **Key** – ビルドファイルを含む .zip ファイルの名前。例:「my\$1game\$1build\$17.0.1, 7.0.2」。
     + **RoleARN** – 作成した IAM ロールに割り当てられた ARN。例:「arn:aws:iam::111122223333:role/GameLiftAccess」。ポリシーの例については「[Amazon S3 でゲームビルドファイルにアクセスする](security_iam_id-based-policy-examples.md#security_iam_id-based-policy-examples-access-storage-loc)」を参照してください。
   + **region** – フリートをデプロイする予定の AWS リージョンにビルドを作成します。ゲームを複数のリージョンにデプロイする場合、各リージョンにビルドを作成します。
**注記**  
[https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html) コマンド [https://docs.aws.amazon.com/cli/latest/reference/configure/get.html](https://docs.aws.amazon.com/cli/latest/reference/configure/get.html) を使用して現在のデフォルトリージョンを確認することをおすすめします。デフォルトのリージョンを変更するには、[https://docs.aws.amazon.com/cli/latest/reference/configure/set.html](https://docs.aws.amazon.com/cli/latest/reference/configure/set.html) コマンドを使用します。

   *例*

   ```
   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
   ```

1. 新しいビルドを表示するには、[https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html](https://docs.aws.amazon.com/cli/latest/reference/gamelift/describe-build.html) コマンドを使用します。

------