以下页面描述网关的预期行为。开源版本与企业版本正在拆分中,首个正式版本发布后细节会同步更新。
命令行
二进制接受的少数命令。其余一切都在控制台里。
命令行是刻意做小的。它负责启动进程并报告状态,不负责配置任何东西。
命令
| 命令 | 用途 |
|---|---|
solidway run |
启动网关 |
solidway check |
校验启动配置后退出 |
solidway health |
查询正在运行的实例 |
solidway version |
打印版本与构建目标 |
没有用于列出路由或 provider 的命令 —— 那些内容在控制台里,且无需重启即可变更。
参数
| 参数 | 适用命令 | 说明 |
|---|---|---|
--config <path> |
全部 | 默认 /etc/solidway/solidway.toml |
--log-format <json|text> |
run |
text 便于在终端阅读 |
--log-level <level> |
run |
error、warn、info、debug、trace |
校验启动配置
solidway check --config ./solidway.toml
配置非法时以非零码退出,并打印出错的键路径。建议在 CI 中对将要部署的配置执行这一步。
退出码
| 码 | 含义 |
|---|---|
0 |
成功 |
1 |
配置非法 |
2 |
用法错误 |
3 |
状态目录不存在或不可写 |
信号
| 信号 | 效果 |
|---|---|
SIGTERM |
停止接受连接,排空在途请求后退出 |
SIGHUP |
重新读取启动配置 |
修改路由不需要发送任何信号 —— 那是一次控制台操作。