文档

支持

Cloud Code

Unity Gaming Services(Unity 游戏服务)CLI

Create and manage schedule configurations from the command line using the Unity Gaming Services command-line interface.
阅读时间2 分钟最后更新于 1 个月前

您可以使用 Unity Gaming Services(Unity 游戏服务)CLI 来处理计划。通过 CLI 可以从命令行管理计划配置。

先决条件

如需了解 CLI 更全面的信息,请按照 Unity Gaming Services(Unity 游戏服务)CLI 入门指南中的步骤操作。 为了按照该指南操作,首先需要完成以下操作:
  1. 安装 UGS CLI
  2. 使用以下命令配置您的 Project ID 和环境:
    ugs config set project-id <your-project-id>

    ugs config set environment-name <your-environment-name>
  3. 为服务帐户配置 Scheduler环境管理所需的角色。如需了解更多信息,请参阅接受身份验证

使用 CLI

如需了解所有命令和选项的完整参考,请参阅 Scheduler 命令行文档

部署计划

运行
new-file
命令在本地创建计划配置:
ugs scheduler new-file <file-name>
配置文件内容可能如下所示:
{ "$schema": "https://ugs-config-schemas.unity3d.com/v1/schedules.schema.json", "Configs": { "Schedule1": { "EventName": "EventType1", "Type": "recurring", "Schedule": "0 * * * *", "PayloadVersion": 1, "Payload": "{}" }, "Schedule2": { "EventName": "EventType2", "Type": "one-time", "Schedule": "2024-03-08T13:06:32.311+00:00", "PayloadVersion": 1, "Payload": "{ \"message\": \"Hello, world!\"}" } }}
如果需要,还可以将计划配置分到多个文件中。
{ "$schema": "https://ugs-config-schemas.unity3d.com/v1/schedules.schema.json", "Configs": { "Schedule1": { "EventName": "EventType1", "Type": "recurring", "Schedule": "0 * * * *", "PayloadVersion": 1, "Payload": "{}" } }}
{ "$schema": "https://ugs-config-schemas.unity3d.com/v1/schedules.schema.json", "Configs": { "Schedule2": { "EventName": "EventType2", "Type": "one-time", "Schedule": "2024-03-08T13:06:32.311+00:00", "PayloadVersion": 1, "Payload": "{ \"message\": \"Hello, world!\"}" } }}
您可以使用
Deploy
命令将本地计划配置文件推送到远程环境。
您需要部署配置文件后才能激活计划。
ugs deploy <path-to-schedules-file> <path-to-schedules-file>
ugs deploy <path-to-directory>

获取计划

要列出所有当前激活的计划,请运行以下命令:
ugs scheduler list
您可以使用
Fetch
命令一次性从远程获取多个计划。
提供的路径是保存计划的目录:
ugs fetch <path>

删除计划

您可以运行带有
--reconcile
标志的
deploy
命令来删除计划。
ugs deploy --services scheduler <path-to-config-file> --reconcile