跳到主要内容

Builds

Build 是一个 zip 包,其中包含运行您的游戏服务器所需的所有文件,包括游戏服务器可执行文件、依赖包和安装脚本。最终它将被部署在机器实例上。我们为游戏开发者提供了 PgosSDK,您可以将其与 Unreal 或 Unity 配合使用,生成二进制文件并输出Build包。

1. 添加Build安装脚本(可选)

如果您想在Build解压后进行一些自定义安装工作,您可以向Build包中添加安装脚本。这是一个可选操作,如果不需要,您可以跳过它。 为您的游戏Build的操作系统创建安装脚本:

  • Windows:创建一个名为“install.ps1”的 PowerShell 脚本文件。
  • Linux:创建一个名为“install.sh”的 bash 脚本文件。

创建安装脚本时,请记住以下几点:

  • 脚本不能接受任何用户输入。

  • Build安装在以下位置的托管服务器上。 Build包中的文件目录已重新创建。

    • 对于 Windows fleet:C:/local/game
    • 对于 Linux fleet:/local/game
  • 安装脚本必须位于Build包的根目录。

    • 对于 Windows fleet:C:/local/game/install.ps1
    • 对于 Linux fleet:/local/game/install.sh

1.1 示例脚本

以下示例展示了一些适用于 Windows 和 Linux 的常用脚本。 Windows 此示例 install.bat 文件安装游戏服务器所需的 Visual C++ 运行时组件。组件文件包含在根目录的Build包中。

C:\\local\\game\\vc_redist.x64.exe /install /quiet

Linux 此示例 install.sh 文件演示了如何在安装脚本中使用 bash 并将结果写入日志文件。

#!/bin/bash
echo 'Hello World' > install.log

2. 添加 Build

当您的 DS 程序准备就绪后,需要将其压缩为 ZIP 文件,然后您可以按照以下步骤将 build 包上传至 PGOS 平台: 步骤 1:登录网页门户,进入控制台,然后选择您要上传 build 的游戏区服。

image-20220907173641982

步骤2: 选择 DS 托管 > Builds,点击 添加 Build 按钮:

image-20220907174525406

请填写以下字段:

  • Build 名称: Build 的描述性名称,必须唯一且提交后无法修改。
  • Build 版本: 用于区分不同 Build 版本的字符串。
  • 操作系统类型: DS 实例运行的操作系统。创建后无法更改。
  • 安装包: 在本地选择 Build 安装包并上传至云端。目前仅支持 zip 格式的安装包。

步骤3:点击 提交 按钮,即可创建一个新的 Build。

您也可以使用 PGOS CLI 工具添加 Build,该工具可以集成到自动化开发和运维流程中。

3. 修改 Build

步骤 1: 选择要编辑的 build,点击其 ID 或编辑图标。

image-20220907195545804

步骤 2: 您将看到如下所示的 Edit Build 对话框:

image-20220907195638779

步骤 3: 进行修改后点击提交按钮以保存您的更改。

4. 删除 Build

步骤 1: 选择要编辑的 build,点击其删除图标。 image-20220907200220610

步骤2: 删除前请仔细检查并确认操作。

image-20220907200354265

❗ 注意:

  • 每个游戏区服上传游戏 Build 的最大容量为 100G。
  • 建议您根据需要定期删除未使用的 Build,以便为新增或更大的 Build 腾出空间。
  • 当 Build 与 Fleet 关联时,可能无法成功执行"删除 Build"操作。
  • 请确认删除操作,因为删除后将无法恢复。