Yao 命令
Yao 命令用于启动服务、运行处理器、查看配置信息等操作。
约定
- 示例中约定应用根目录为
/data/app, 实际编写时需替换为应用根目录。 - 使用
<>标识自行替换的内容。 例如:icon-<图标名称>, 实际编写时应替换为:icon-foo,icon-bar... - 文件
.yao的后缀和格式和.json结构是一样的，不影响使用都可以兼容。
手册
yao <command> [options] [args...]
| 命令 | 说明 |
|---|---|
| version | 显示当前版本号 |
| inspect | 显示应用配置信息 |
| get | 下载应用代码 |
| migrate | 更新模型数据表结构 |
| run | 运行处理器 |
| start | 启动服务 |
| socket | 建立 Socket 连接 |
| websocket | 建立 WebSocket 连接 |
| dump | 导出应用数据 |
| restore | 导入应用数据 |
| studio | Studio CLI |
全局选项:
| 参数 | 简写 | 说明 |
|---|---|---|
| --app | -a | 指定应用路径 |
| --env | -e | 指定环境变量文件 |
| --help | -h | 命令帮助 |
yao version
显示 Yao 版本号
yao version
yao inspect
显示应用配置信息
cd /data/appyao inspect
yao get
下载应用代码。从 INFRA 应用库中下载代码。
注意: 当前应用目录必须为空目录
cd /data/appyao get yaoapp/demo-app
yao migrate
更新数据库结构，创建应用引擎和 models 文件夹下定义的数据表。默认更新 models 下所数据模型关联的数据表。
注意：`migrate --reset` 命令会清空当前数据表， 不推荐在 `production` 模式下使用。
选项:
| 参数 | 简写 | 说明 |
|---|---|---|
| --name | -n | 指定模型名称 |
| --reset | 强制删除数据表后重建 | |
| --force | 在 production 模式下, 强制使用 migrate |
cd /data/appyao migrate
cd /data/appyao migrate -n pet
yao run
运行处理器, 第一个参数为处理器名称，其余参数为处理器参数表。
如果需要输入复杂数据结构可以使用 :: 前缀，声明参数为 JSON 格式， 例如: '::{"foo":"bar"}'
cd /data/appyao run scripts.day.NextDay 2020-01-02
cd /data/appyao run xiang.flow.Return hello '::{"foo":"bar"}'
yao start
启动服务
注意: 如果未检测到应用配置信息, 将启动应用安装服务，根据提示完成安装配置。
选项:
| 参数 | 简写 | 说明 |
|---|---|---|
| --alpha | 启用内测功能 | |
| --debug | 使用开发模式启动 |
cd /data/appyao start
cd /data/appyao start --debug
管理后台默认用户名: `xiang@iqka.com`， 密码: `A123456p+`
如果网络结构较为复杂，命令行提示的IP地址无法访问，可根据实际网络结构，更换为相应IP地址。
yao socket
建立 socket 连接。 使用 Socket Widget DSL 建立 Socket 连接
cd /data/appyao socket gate.g02
yao websocket
建立 WebSocket 连接。 使用 Socket Widget DSL 建立 WebSocket 连接
cd /data/appyao websocket message
yao dump
导出应用数据
cd /data/appyao dump
yao restore
导入应用数据, 参数为使用 yao dump 命令导出的应用数据包文件。
cd /data/appyao restore /backup/data/app/edge-20220827151641.zip
yao studio
命令:
| 命令 | 说明 |
|---|---|
| run | 运行 Stuido 脚本 ( /data/app/studio 目录下脚本) |
cd /data/appyao studio run hello.Foo world '::{"foo":"bar"}'
环境变量
| 变量 | 说明 | 默认值 | 示例 |
|---|---|---|---|
| YAO_LANG | 命令行语言 en-US 英语 zh-CN 简体中文 | en-US | zh-CN |
| YAO_ENV | 运行模式 development 开发环境 production 生产环境 | production | production |
| YAO_ROOT | 应用目录 | 当前目录 . | /data/app |
| YAO_HOST | WEB 服务 HOST | 0.0.0.0 | 127.0.0.1 |
| YAO_PORT | WEB 服务端口 | 5099 | 5099 |
| YAO_LOG | 应用日志文件位置 | 系统标准输出 | /data/app/logs/application.log |
| YAO_LOG_MODE | 日志格式 TEXT | JSON | TEXT | JSON |
| YAO_JWT_SECRET | JWT 密钥 | 默认为空 | bLp@bi!oqo-2U+hoTRUG |
| YAO_DB_DRIVER | 数据库驱动 mysql | sqlite3 | sqlite3 | mysql |
| YAO_DB_PRIMARY | 主库连接 | ./db/yao.db | root:123456@tcp(db-server:3306)/yao?charset=utf8mb4&parseTime=True&loc=Local |
| YAO_DB_PRIMARY | 从库连接 | 空 | root:123456@tcp(db-server:3306)/yao?charset=utf8mb4&parseTime=True&loc=Local |
| YAO_DB_AESKEY | 加密字段密钥 (MySQL Only) | 空 | ZLX=T&f6refeCh-ro*r@ |
| YAO_SESSION_STORE | 会话数据存储方式 memory | redis | memory | redis |
| YAO_SESSION_HOST | Redis 服务器 HOST (会话存储方式为 redis 有效) | 127.0.0.1 | 127.0.0.1 |
| YAO_SESSION_PORT | Redis 服务器端口 (会话存储方式为 redis 有效) | 6379 | 6379 |
| YAO_SESSION_PASSWORD | Redis 密码 (会话存储方式为 redis 有效) | 空 | 123456 |
| YAO_STUDIO_PORT | YAO STUDIO 服务端口(仅开发模式下有效) | 5077 | 5077 |
| YAO_STUDIO_SECRET | YAO STUDIO 密钥 | 空, 自动生成 | 8A9932B141E16AE1FB58409C493E93471EA24D43BF31130FE3E5A600598D9FED |
Tips: 可以为应用单独设置环境变量。在应用根目录下添加 .env，服务启动时将优先使用 .env 声明的环境变量。
Yao 命令
Yao 命令用于启动服务、运行处理器、查看配置信息等操作。
约定
- 示例中约定应用根目录为
/data/app, 实际编写时需替换为应用根目录。 - 使用
<>标识自行替换的内容。 例如:icon-<图标名称>, 实际编写时应替换为:icon-foo,icon-bar... - 文件
.yao的后缀和格式和.json结构是一样的，不影响使用都可以兼容。
手册
yao <command> [options] [args...]
| 命令 | 说明 |
|---|---|
| version | 显示当前版本号 |
| inspect | 显示应用配置信息 |
| get | 下载应用代码 |
| migrate | 更新模型数据表结构 |
| run | 运行处理器 |
| start | 启动服务 |
| socket | 建立 Socket 连接 |
| websocket | 建立 WebSocket 连接 |
| dump | 导出应用数据 |
| restore | 导入应用数据 |
| studio | Studio CLI |
全局选项:
| 参数 | 简写 | 说明 |
|---|---|---|
| --app | -a | 指定应用路径 |
| --env | -e | 指定环境变量文件 |
| --help | -h | 命令帮助 |
yao version
显示 Yao 版本号
yao version
yao inspect
显示应用配置信息
cd /data/appyao inspect
yao get
下载应用代码。从 INFRA 应用库中下载代码。
注意: 当前应用目录必须为空目录
cd /data/appyao get yaoapp/demo-app
yao migrate
更新数据库结构，创建应用引擎和 models 文件夹下定义的数据表。默认更新 models 下所数据模型关联的数据表。
注意：`migrate --reset` 命令会清空当前数据表， 不推荐在 `production` 模式下使用。
选项:
| 参数 | 简写 | 说明 |
|---|---|---|
| --name | -n | 指定模型名称 |
| --reset | 强制删除数据表后重建 | |
| --force | 在 production 模式下, 强制使用 migrate |
cd /data/appyao migrate
cd /data/appyao migrate -n pet
yao run
运行处理器, 第一个参数为处理器名称，其余参数为处理器参数表。
如果需要输入复杂数据结构可以使用 :: 前缀，声明参数为 JSON 格式， 例如: '::{"foo":"bar"}'
cd /data/appyao run scripts.day.NextDay 2020-01-02
cd /data/appyao run xiang.flow.Return hello '::{"foo":"bar"}'
yao start
启动服务
注意: 如果未检测到应用配置信息, 将启动应用安装服务，根据提示完成安装配置。
选项:
| 参数 | 简写 | 说明 |
|---|---|---|
| --alpha | 启用内测功能 | |
| --debug | 使用开发模式启动 |
cd /data/appyao start
cd /data/appyao start --debug
管理后台默认用户名: `xiang@iqka.com`， 密码: `A123456p+`
如果网络结构较为复杂，命令行提示的IP地址无法访问，可根据实际网络结构，更换为相应IP地址。
yao socket
建立 socket 连接。 使用 Socket Widget DSL 建立 Socket 连接
cd /data/appyao socket gate.g02
yao websocket
建立 WebSocket 连接。 使用 Socket Widget DSL 建立 WebSocket 连接
cd /data/appyao websocket message
yao dump
导出应用数据
cd /data/appyao dump
yao restore
导入应用数据, 参数为使用 yao dump 命令导出的应用数据包文件。
cd /data/appyao restore /backup/data/app/edge-20220827151641.zip
yao studio
命令:
| 命令 | 说明 |
|---|---|
| run | 运行 Stuido 脚本 ( /data/app/studio 目录下脚本) |
cd /data/appyao studio run hello.Foo world '::{"foo":"bar"}'
环境变量
| 变量 | 说明 | 默认值 | 示例 |
|---|---|---|---|
| YAO_LANG | 命令行语言 en-US 英语 zh-CN 简体中文 | en-US | zh-CN |
| YAO_ENV | 运行模式 development 开发环境 production 生产环境 | production | production |
| YAO_ROOT | 应用目录 | 当前目录 . | /data/app |
| YAO_HOST | WEB 服务 HOST | 0.0.0.0 | 127.0.0.1 |
| YAO_PORT | WEB 服务端口 | 5099 | 5099 |
| YAO_LOG | 应用日志文件位置 | 系统标准输出 | /data/app/logs/application.log |
| YAO_LOG_MODE | 日志格式 TEXT | JSON | TEXT | JSON |
| YAO_JWT_SECRET | JWT 密钥 | 默认为空 | bLp@bi!oqo-2U+hoTRUG |
| YAO_DB_DRIVER | 数据库驱动 mysql | sqlite3 | sqlite3 | mysql |
| YAO_DB_PRIMARY | 主库连接 | ./db/yao.db | root:123456@tcp(db-server:3306)/yao?charset=utf8mb4&parseTime=True&loc=Local |
| YAO_DB_PRIMARY | 从库连接 | 空 | root:123456@tcp(db-server:3306)/yao?charset=utf8mb4&parseTime=True&loc=Local |
| YAO_DB_AESKEY | 加密字段密钥 (MySQL Only) | 空 | ZLX=T&f6refeCh-ro*r@ |
| YAO_SESSION_STORE | 会话数据存储方式 memory | redis | memory | redis |
| YAO_SESSION_HOST | Redis 服务器 HOST (会话存储方式为 redis 有效) | 127.0.0.1 | 127.0.0.1 |
| YAO_SESSION_PORT | Redis 服务器端口 (会话存储方式为 redis 有效) | 6379 | 6379 |
| YAO_SESSION_PASSWORD | Redis 密码 (会话存储方式为 redis 有效) | 空 | 123456 |
| YAO_STUDIO_PORT | YAO STUDIO 服务端口(仅开发模式下有效) | 5077 | 5077 |
| YAO_STUDIO_SECRET | YAO STUDIO 密钥 | 空, 自动生成 | 8A9932B141E16AE1FB58409C493E93471EA24D43BF31130FE3E5A600598D9FED |
Tips: 可以为应用单独设置环境变量。在应用根目录下添加 .env，服务启动时将优先使用 .env 声明的环境变量。