使用 Amazon S3 中的文件创建构建
您可以将构建文件存储在 Amazon S3 中,然后从那里将其上传到 Amazon GameLift。在创建构建时,指定 S3 存储桶的位置,然后 Amazon GameLift 会从 Amazon S3 直接检索构建文件。
创建构建资源
-
将构建文件存储在 Amazon S3 中。创建一个 .zip 文件,其中包含打包的构建文件,并将其上传到您 AWS 账户中的 S3 存储桶。记下存储桶标签和文件名;您在创建 Amazon GameLift 构建时需要这些内容。
-
向 Amazon GameLift 提供对您构建文件的访问权限。按照在 Amazon S3 中访问游戏构建文件中的说明创建 IAM 角色。创建角色后,记录新角色的 Amazon 资源名称(ARN),您在创建构建时需要该名称。
-
创建构建 使用 Amazon GameLift 控制台或 AWS CLI 创建新的构建记录。您必须拥有
PassRole
权限,如Amazon GameLift 的 IAM 权限示例中所述。
- Console
-
-
在 Amazon GameLift 控制台
的导航窗格中,选择托管、构建。 -
在构建页面上,选择创建构建。
-
在创建构建页面的构建设置下,执行以下操作:
-
对于名称,输入脚本名称。
-
对于版本,输入版本。由于构建内容可以更新,版本数据则有助于跟踪更新。
-
对于操作系统(OS),选择您的游戏服务器构建的操作系统。您稍后无法更新此值。
-
对于游戏服务器构建,输入您上传到 Amazon S3 的构建目标的 S3 URI,然后选择目标版本。如果您忘记了 Amazon S3 URI 和对象版本,选择浏览 S3,然后搜索构建对象。
-
对于 IAM 角色,选择您创建的允许 Amazon GameLift 访问您的 S3 存储桶和构建对象的角色。
-
-
(可选)在标签下,通过输入键和值对向构建添加标签。
-
选择创建。
Amazon GameLift 为新构建分配一个 ID 并上传指定的.zip 文件。您可以在构建页面上查看新构建,包括状态。
-
- AWS CLI
-
使用
create-build
命令定义新构建并上传您的服务器构建文件。-
打开命令行窗口,然后切换到您可以使用 AWS CLI 的目录。
-
输入以下 create-build 命令:
aws gamelift create-build \ --name
user-defined name of build
\ --server-sdk-versionAmazon GameLift server SDK version
\ --operating-systemsupported OS
\ --build-versionuser-defined build number
\ --storage-location "Bucket"=S3 bucket label
,"Key"=Build .zip file name
,"RoleArn"=Access role ARN
} \ --regionregion name
-
name – 新构建的描述性名称。
-
server-sdk-version – 您用于集成游戏服务器和 Amazon GameLift 的 Amazon GameLift 服务器软件开发工具包版本。如果您没有提供值,则 Amazon GameLift 会使用默认值
4.0.2
。 -
operating-system – 游戏服务器构建的运行时环境。您必须指定操作系统值。您稍后无法更新。
-
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_2016 \ --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
-
-
要查看新构建,请使用
describe-build
命令。
-