メニュー
AWS CloudFormation
ユーザーガイド (API Version 2010-05-15)

AWS::GameLift::Fleet

AWS::GameLift::Fleet リソースはゲームサーバーをホストするための Amazon GameLift (GameLift) フリートを作成します。フリートは EC2 インスタンスのセットであり、各 EC2 インスタンスはフリート内のホストです。詳細については、Amazon GameLift API リファレンスの「CreateFleet」アクションを参照してください。

構文

AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。

JSON

Copy
{ "Type" : "AWS::GameLift::Fleet", "Properties" : { "BuildId" : String, "Description" : String, "DesiredEC2Instances" : Integer, "EC2InboundPermissions" : [ EC2InboundPermission, ... ], "EC2InstanceType" : String, "LogPaths" : [ String, ... ], "MaxSize" : Integer, "MinSize" : Integer, "Name" : String, "ServerLaunchParameters" : String, "ServerLaunchPath" : String } }

YAML

Copy
Type: "AWS::GameLift::Fleet" Properties: BuildId: String Description: String DesiredEC2Instances: Integer EC2InboundPermissions: - EC2InboundPermission EC2InstanceType: String LogPaths: [ String, ... ] MaxSize: Integer MinSize: Integer Name: String ServerLaunchParameters: String ServerLaunchPath: String

プロパティ

BuildId

このフリートで使用するビルドの固有の識別子。

Required: Yes

Type: String

更新に伴う要件: 置換

Description

このフリートの目的を識別するために役立つ情報。

Required: No

Type: String

更新に伴う要件: 中断はありません。

DesiredEC2Instances

このフリートで必要な EC2 インスタンスの数。

Required: Yes

Type: Integer

更新に伴う要件: 中断はありません。

EC2InboundPermissions

ゲームサーバーへのアクセスを許可される受信トラフィック (IP 範囲とポート番号で表される)。値を指定しないと、ゲーム サーバーに対して一切のトラフィックが許可されません。

Required: No

Amazon GameLift フリートの EC2InboundPermissionType: リスト

更新に伴う要件: 中断はありません。

EC2InstanceType

フリートで使用する EC2 インスタンスのタイプ。EC2 インスタンスタイプは、フリートのホストの CPU、メモリ、ストレージ、ネットワークキャパシティを定義します。GameLift でサポートされるインスタンスタイプの詳細については、Amazon GameLift API リファレンスの「EC2InstanceType」パラメーターを参照してください。

Required: Yes

Type: String

更新に伴う要件: 置換

LogPaths

ゲーム サーバーによって生成されるゲームセッションのログファイルへのパス (スラッシュ (\) はエスケープ)。ゲームセッションが終了すると、GameLift はログを取得して S3 バケットに保存します。

Required: No

Type: List of String values

更新に伴う要件: 置換

MaxSize

このフリートで許可する EC2 インスタンスの最大数。デフォルトでは、AWS CloudFormation はこのプロパティを 1 に設定します。

Required: No

Type: Integer

更新に伴う要件: 中断はありません。

MinSize

このフリートで許可する EC2 インスタンスの最小数。デフォルトでは、AWS CloudFormation はこのプロパティを 0 に設定します。

Required: No

Type: Integer

更新に伴う要件: 中断はありません。

Name

このフリートに関連付ける識別子。フリート名は一意である必要はありません。

Required: Yes

Type: String

更新に伴う要件: 中断はありません。

ServerLaunchParameters

ゲームサーバーを起動するために必要なパラメーター。これらのパラメーターをコマンドラインパラメーターの文字列 (+sv_port 33435 +start_lobby など) として指定します。

Required: No

Type: String

更新に伴う要件: 置換

ServerLaunchPath

GameLift が起動するゲームサーバーの場所。スラッシュ (\) をエスケープして次のパターンを使う必要があります: C:\\game\\launchpathたとえば、ゲームサーバーのファイルが MyGame フォルダにある場合、パスは C:\\game\\MyGame\\server.exe となります。

Required: Yes

Type: String

更新に伴う要件: 置換

戻り値

参照番号

このリソースの論理 ID が Ref 組み込み関数に提供されると、Ref により myfleet-a01234b56-7890-1de2-f345-g67h8i901j2k のようなフリート ID が返されます。

Ref 関数の使用方法の詳細については、「Ref」を参照してください。

次に示すのは、2 つのインバウンド許可を使用して MyGameFleet という GameLift フリートを作成する例です。このフリートは Ref 組み込み関数を使用して、同じテンプレート内の別の場所で宣言できるビルドを指定します。ログパスおよびサーバー起動パスの場合、この例ではエスケープ文字 (\) を使用してスラッシュ (\) をエスケープしています。

JSON

Copy
"FleetResource": { "Type": "AWS::GameLift::Fleet", "Properties": { "Name": "MyGameFleet", "Description": "A fleet for my game", "BuildId": { "Ref": "BuildResource" }, "ServerLaunchPath": "c:\\game\\TestApplicationServer.exe", "LogPaths": [ "c:\\game\\testlog.log", "c:\\game\\testlog2.log" ], "EC2InstanceType": "t2.small", "DesiredEC2Instances": "2", "EC2InboundPermissions": [ { "FromPort": "1234", "ToPort": "1324", "IpRange": "0.0.0.0/24", "Protocol": "TCP" }, { "FromPort": "1356", "ToPort": "1578", "IpRange": "192.168.0.0/24", "Protocol": "UDP" } ] } }

YAML

Copy
FleetResource: Type: "AWS::GameLift::Fleet" Properties: Name: "MyGameFleet" Description: "A fleet for my game" BuildId: Ref: "BuildResource" ServerLaunchPath: "c:\\game\\TestApplicationServer.exe" LogPaths: - "c:\\game\\testlog.log" - "c:\\game\\testlog2.log" EC2InstanceType: "t2.small" DesiredEC2Instances: "2" EC2InboundPermissions: - FromPort: "1234" ToPort: "1324" IpRange: "0.0.0.0/24" Protocol: "TCP" - FromPort: "1356" ToPort: "1578" IpRange: "192.168.0.0/24" Protocol: "UDP"

このページの内容: