AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

AWS::GameLift::Fleet

AWS::GameLift::Fleet 资源可创建用于托管游戏服务器的 Amazon GameLift (GameLift) 队列。队列是一组 EC2 实例,每个 EC2 实例是队列中的一个主机。有关更多信息,请参阅 Amazon GameLift API 参考 中的 CreateFleet 操作。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "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

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

Type: Amazon GameLift Fleet EC2InboundPermission 列表

更新要求无需中断

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

更新要求替换

返回值

Ref

如果向 Ref 内部函数提供此资源的逻辑 ID,Ref 将返回队列 ID,如 myfleet-a01234b56-7890-1de2-f345-g67h8i901j2k

有关使用 Ref 功能的更多信息,请参阅参考

示例

下面的示例创建具有两条入站权限、名为 MyGameFleet 的 GameLift 队列。该队列使用 Ref 内部函数指定生成包,它可在同一模板中的其他位置声明。对于日志路径和服务器启动路径,此示例使用转义字符 (\) 转义斜杠 (\)。

JSON

"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

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"

本页内容: