2 - 上传游戏

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

步骤 1：创建 API 密钥

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

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

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

2. 点击 CREATE 创建 API 密钥。

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

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

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

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

步骤 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/zeuztool 或 bin_linux_amd64/zeuztool

2. 如果您正在使用 macOS 或 Linux，请确保 zeuz 工具文件是可执行文件。

步骤 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_key 和 your_API_key_password 替换为您项目的 API 密钥和 API 密码。

完成

当终端窗口中出现类似下列示例的输出时 (其中 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_ID 和 your_zeuz_ENVIRONMENT_ID 替换为 zeuz 控制面板左侧的项目和环境 ID。

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

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

注意：

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

完成

当终端窗口中出现类似下方示例的输出时 (列出游戏镜像中的全部项目文件)，代表上传已成功。示例如下 (其中 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日 该文档已创建并通过审校