使用 Amazon S3 中的文件创建构建 - Amazon GameLift

使用 Amazon S3 中的文件创建构建

您可以将构建文件存储在 Amazon S3 中,然后从那里将其上传到 Amazon GameLift。在创建构建时,指定 S3 存储桶的位置,然后 Amazon GameLift 会从 Amazon S3 直接检索构建文件。

创建构建资源
  1. 将构建文件存储在 Amazon S3 中。创建一个 .zip 文件,其中包含打包的构建文件,并将其上传到您 AWS 账户中的 S3 存储桶。记下存储桶标签和文件名;您在创建 Amazon GameLift 构建时需要这些内容。

  2. 向 Amazon GameLift 提供对您构建文件的访问权限。按照在 Amazon S3 中访问游戏构建文件中的说明创建 IAM 角色。创建角色后,记录新角色的 Amazon 资源名称(ARN),您在创建构建时需要该名称。

  3. 创建构建 使用 Amazon GameLift 控制台或 AWS CLI 创建新的构建记录。您必须拥有 PassRole 权限,如Amazon GameLift 的 IAM 权限示例中所述。

Console
  1. Amazon GameLift 控制台的导航窗格中,选择托管构建

  2. 构建页面上,选择创建构建

  3. 创建构建页面的构建设置下,执行以下操作:

    1. 对于名称,输入脚本名称。

    2. 对于版本,输入版本。由于构建内容可以更新,版本数据则有助于跟踪更新。

    3. 对于操作系统(OS),选择您的游戏服务器构建的操作系统。您稍后无法更新此值。

    4. 对于游戏服务器构建,输入您上传到 Amazon S3 的构建目标的 S3 URI,然后选择目标版本。如果您忘记了 Amazon S3 URI 和对象版本,选择浏览 S3,然后搜索构建对象。

    5. 对于 IAM 角色,选择您创建的允许 Amazon GameLift 访问您的 S3 存储桶和构建对象的角色。

  4. (可选)在标签下,通过输入对向构建添加标签。

  5. 选择创建

Amazon GameLift 为新构建分配一个 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 Amazon GameLift server SDK 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 的 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
  3. 要查看新构建,请使用 describe-build 命令。