zeuz 工具

您可以使用 zeuz 命令行工具 (CLI) 对 游戏镜像 执行下列操作:

zeuz 工具包含在基于您操作系统下载的 zeuz SDK 中。

身份认证

在使用 zeuz 工具运行命令前,您必须先进行身份认证。

auth_login

如需登录 zeuz 工具,您可使用下列任一方式运行 auth_login 命令:

  • zeuz 开发人员用户名和密码:可对多个 zeuz 项目 执行命令。

    更多信息,请参见 开发人员

  • API 密钥和 API 密码:仅可对创建 API 密钥的项目执行命令。

    更多信息,请参见 API 密钥

    注意:如使用该认证方法,请使用 isapi=true 选项。

注意:如果您在 zeuz 控制面板 中创建了 API 密钥,请使用 zeuz 控制面板 API 密钥页面中显示的 API Key 进行登录。API 密码是您在创建该 API 密钥时设定的密码。更多信息,请参见 API 密钥

图像:zeuz 控制面板上的 API 密钥页面

命令示例如下:

zeuztool auth_login login="gl9xrFUAU..." password="my_password" isapi=true endpoint="https://zcp.zeuz.io/api/v1"
zeuztool auth_login login="example@email.com" password="my_password" endpoint="https://zcp.zeuz.io/api/v1"

注意:使用 zeuz 工具时,您可能需要对特殊字符进行“转义”,比如密码中的特殊字符。更多信息,请参见 维基百科:转义字符

命令

您可以使用下列命令对游戏镜像执行操作。

资讯:自动记忆参数

您在每个会话中仅需输入一次下列参数,zeuz 工具会在后续命令中自动记忆和填充这些参数:

  • endpoint
  • env
  • proj

push

zeuztool push proj="your_zeuz_project_ID" env="your_zeuz_environment_ID" directory="path/to/your_project"

运行该命令上传游戏镜像。请注意您项目的游戏镜像必须为目录。

您可在 zeuz 控制面板 左侧找到 your_zeuz_project_IDyour_zeuz_environment_ID

如需更新已上传的游戏镜像,运行 push 命令把新版游戏镜像文件上传到相同路径。

push_discard

zeuztool push_discard proj="your_zeuz_project_ID" env="your_zeuz_environment_ID"

运行该命令删除已上传的游戏镜像。如果您使用 push 命令上传了一个镜像,但您想在运行 push_publish 命令前更新该镜像,则必须先使用 push_discard 命令删除之前上传的镜像文件。

push_publish

zeuztool push_publish description="your-project-description" version="x.x.x" proj="your_zeuz_project_ID" env="your_zeuz_environment_ID"

使用 push 命令上传游戏镜像后,运行该命令为上传的游戏镜像创建容器。该命令的描述可为任意字母数字字符,版本可为任意数字。

zeuz 从您的游戏镜像中创建的容器即为游戏的 负载

注意:如果 zeuz 工具报错:文件大小不一致,请重新运行 push 命令和 push_publish 命令。

pull

zeuztool pull proj="your_zeuz_project_ID" env="your_zeuz_environment_ID" imageid="your_image_id" directory="path/to/downloaded_files"

运行该命令下载与指定镜像 ID 相关联的游戏镜像文件。您可使用 images 命令来查找您的镜像 ID。

images

zeuztool images proj="your_zeuz_project_ID" env="your_zeuz_environment_ID"

运行该命令列出与指定项目 ID 和环境 ID 相关联的游戏镜像。

输出示例如下:

Zeuz Tool 0.1.51 67d9a3d227215cbff0d731bb1cdb137046621be2
Load LocalConfig: /Users/Myuser/Library/zeuz.io/zeuzcmd.json

Listing images in project: gzbwHFtAwfcxeIDlvzprFczzeCG  
- environment: xZucKixUWdQwaUjdKSldwbZwvYz

Created: 2021-03-11 18:39:52.118374 +0000 UTC
Description: image_1
Version: 1.0.0
ID: 4dd3d07d5438982d1f549b5ac6b76d4894ba12768f
URL: 036048815063.dkr.ecr.eu-central-1.amazonaws.com/gameserver/gzbwhftawfcxeidlvzprfczzecg-xzuckixuwdqwaujdksldwbzwvyz:4dd3d07d5438982d3611f549b5ac6b76946d4894ba12768f

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

2021年6月11日 该文档已更新并通过审校:新增 auth_login 部分和 API 密钥图片

2021年3月16日 该文档已更新并通过审校

2020年11月19日 该文档已更新并通过审校:将负载修正为参考镜像


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