2 - 上传游戏

如需上传游戏程序集,并使用程序集创建容器化的游戏镜像,请完成下列步骤:

步骤 1:创建 API 密钥

zeuz 控制面板 中创建并记录 API 密钥。

警告:即使已有 API 密钥,也请另行创建新的 API 密钥。
如果您曾在 zeuz 中设置过项目,则该页面上已有 API 密钥,但请勿重复使用现有的 API 密钥,确保为本项目创建一个新的 API 密钥。

请按照下列步骤创建 API 密钥:

  1. zeuz 控制面板 中,点击页面右上角的登录名 (或者三点标识,视具体页面而定),打开下拉菜单并点击 API Keys (API 密钥),进入 API 密钥页面。

  2. 点击 CREATE 创建 API 密钥。

  3. 输入字母数字设置 API 密钥的名称,您可自行决定 API 密钥的名称。

  4. 输入字母数字或特殊字符设置 API 密码,您可自行决定 API 密码。该密码可以与您的账号密码不同。

    出于安全考虑,我们建议您使用不同的密码。

  5. 编辑完成后,点击 SAVE 保存设置。

小贴士
建议您为 API 密钥设置一个易辨识的名称,方便在多个 API 密钥中轻松找到它。

步骤 2:查找项目 ID 和环境 ID

在 zeuz 控制面板左侧找到 zeuz PROJECT ID (项目 ID) 和 ENVIRONMENT ID (环境 ID)。 记录这两个 ID,以便后续在 zeuz 工具中使用。

步骤 3:查找并准备 zeuz 工具

  1. 在您的本地开发机上找到 zeuz 工具:

    • Windows:bin/windows_amd64/zeuztool.exe
    • MacOS:bin/darwin_amd64/zeuztool
    • Linux:bin/linux_arm64/zeuztoolbin_linux_amd64/zeuztool
  2. 如果您正在使用 macOS 或 Linux,请确保 zeuz 工具文件是可执行文件。

资讯:如何确保 zeuz 工具文件是可执行文件?
  • Windows:zeuz 工具是可执行文件,无需其他操作。
  • macOS:请参阅 support.apple.com
  • Linux:在终端窗口中,输入 sudo chmod +x /path/to/zeuztool (请将 path/to 替换为正确的文件路径)。

问题排查
  • macOS 无法确认开发者的身份

    允许该应用程序 (文件) 运行。请参阅 support.apple.com

步骤 4:身份认证

使用 zeuz 工具进行身份认证。

如需进行身份认证,请使用您的 API 密钥和 API 密码来执行 auth_login 命令。示例如下:

  • Windows

    zeuztool.exe auth_login login="your_API_key" password="your_API_key_password" isapi=true endpoint="https://zcp.zeuz.io/api/v1"

  • macOS 和 Linux

    ./zeuztool auth_login login="your_API_key" password="your_API_key_password" isapi=true endpoint="https://zcp.zeuz.io/api/v1"

请将 your_API_keyyour_API_key_password 替换为您项目的 API 密钥和 API 密码。

问题排查
  • 返回 400 错误

    您可能使用了定向 (弯曲) 引号,请将定向引号替换为非定向 (直) 引号,即 ( " ) (ASCII 34)。

    您的 API 密码中可能包含特殊字符 (非字母或数字的字符),请在所有特殊字符前添加转义字符 ( \ ) (反斜杠)。

  • macOS 无法确认开发者的身份

    允许该应用程序 (文件) 运行。请参阅 support.apple.com

完成

当终端窗口中出现类似下列示例的输出时 (其中 xxxhashxxx 为哈希字符串),代表运行成功。示例如下:

Zeuz Tool development version login: https://zcp.zeuz.io/api/x xxxhashxxx
Login Session: xxxhashxxx
Load LocalConfig: /Users/l<yourusername>/Library/ApplicationSupport/zeuz.io/zeuzcmd.json

步骤 5:上传游戏程序集 (push 命令)

使用 zeuz 工具运行 push 命令上传您项目的游戏程序集,请注意游戏程序集必须为一个目录。

在终端窗口中,从 zeuz 工具所在的目录里运行下列命令:

  • Windows

    zeuztool.exe push proj="your_zeuz_PROJECT_ID" env="your_zeuz_ENVIRONMENT_ID" directory="path/to/your_project"

  • MacOS 和 Linux:

    ./zeuztool push proj="your_zeuz_PROJECT_ID_hash" env="your_zeuz_ENVIRONMENT_ID_hash" directory="path/to/your_project"

请将 your_zeuz_PROJECT_IDyour_zeuz_ENVIRONMENT_ID 替换为 zeuz 控制面板左侧的项目和环境 ID。

请将 path/to/your_project 替换为您项目的相对路径。请保留前后的双引号 ( " )。

在该命令中必须使用非定向 (直) 引号 ( " ) (ASCII 34),请勿使用定向 (弯曲) 双引号。

注意

  • 镜像上传需要一定的时间,具体取决于您的游戏程序集大小和网络连接速度。
  • zeuz 工具可能会输出一些文本,将每个文件的哈希值与已上传文件的文件哈希数据库进行比较,然后上传数据库中尚不存在的文件。
问题排查
  • 返回错误

    请确保您指定的是 get_started_test_project 目录,而不是其中的 server.sh 可执行文件。

    如果您重新命名了 get_started_test_project 目录且新名称中包含空格,请用非定向 (直) 引号 ( " ) (ASCII 34) 将名称括起来。例如:"test project"

    请确保命令尾部没有多余空格 (空格或回车空行)。

完成

当终端窗口中出现类似下方示例的输出时 (列出游戏镜像中的全部项目文件),代表上传已成功。示例如下 (其中 xxxhashxxx 是一个哈希字符串):

Finished uploading my_project_file.* (xxxhashxxx)

步骤 6:创建容器化的游戏镜像 (push_publish 命令)

使用 zeuz 工具运行 push_publish 命令为您在上一步上传的游戏程序集创建容器化的游戏镜像。

zeuz 使用您的游戏程序集创建的容器化游戏镜像实例,即为您游戏的 负载

在终端窗口中,从 zeuz 工具所在的目录里运行下列命令:

  • Windows

    zeuztool.exe push_publish description="your-project-description" version="x.x.x"

  • MacOS 和 Linux

    ./zeuztool push_publish description="your-project-description" version="x.x.x"

您可以为项目描述输入任意字母数字字符,为镜像版本输入任意数字。我们建议您使用语义化版本的版本格式 (如需指导,请参阅 semver.org)。

注意

  • 您无需重复输入之前步骤中的 proj ID 和 env ID。 zeuz 工具会在后续命令中自动添加它们。

  • 容器的创建需要一定的时间,具体取决于您的游戏大小。当终端窗口中输出类似下方示例的字符串时,代表容器已成功创建。示例如下:

    YYYY/MM/DD HH:MM:SS State: running

问题排查
  • 返回错误

    确保命令尾部没有多余空格。

完成

当终端窗口中出现类似下列示例的输出时 (其中 xxxhashxxx 为哈希字符串),代表运行成功。示例如下:

YYYY/MM/DD HH:MM:SS Image published: xxxhashxxx


下一步3 - 创建并配置配载


2021年6月30日 该文档已更新并通过审校:更新 zeuz 控制面板的 URL

2021年5月5日 该文档已更新并通过审校:阐明并更新术语

2021年3月10日 该文档已更新并通过审校:更新命令句法

2021年2月5日 该文档已创建并通过审校


最近更新时间: October 20, 2021 (06e140c7)