start

start#

启动 openYuanrong 集群，支持 master 和 agent 两种模式。

用法#

yr start [OPTIONS]

参数#

--master：以主节点模式启动（默认不带该参数时为 agent 模式）。
-s, --set KEY=VALUE：命令行覆盖配置，可重复指定；VALUE 必须是合法 TOML 字面量。
--master_address http(s)://host:port：仅 agent 模式可用。启动前从指定 function_master 拉取服务发现信息并自动转换为 -s 覆盖项。
--log-dir-prefix <path>：指定会话与日志输出的前缀目录（默认 /tmp/yr_sessions）。会话目录 <prefix>/<timestamp>/、latest 软链、session.json、yr_current_master_info 以及组件日志 <deploy_path>/logs/ 均创建在该前缀下，整体迁移、不会分裂。

备注

-s/--set 常见示例：

字符串：-s 'values.fs.log.level="DEBUG"'
数值：-s 'values.ds_master.port=12123'
数组表：-s 'values.etcd.address=[{ip="10.88.0.9",peer_port="32380",port="32379"}]'

--master_address 使用限制：

仅 yr start（agent 模式）支持。
与 --master 同时使用会报错并退出。
服务发现失败会直接退出。
参数值必须包含协议头，即 http:// 或 https://。
当使用 https:// 时，需通过 --config 或 -s 提供 values.fs.tls.ca_file、values.fs.tls.cert_file、values.fs.tls.key_file（可配合 values.fs.tls.base_path）。

配置合并规则#

yr start 启动时，最终配置按以下优先级合并（高到低）：

命令行覆盖：-s/--set
用户配置文件：默认 /etc/yuanrong/config.toml（可通过 -c 指定）
内置默认值：api/python/yr/cli/values.toml + api/python/yr/cli/config.toml.jinja

启动行为#

执行 yr start 后，CLI 会：

创建部署目录 <prefix>/<timestamp>/（<prefix> 默认为 /tmp/yr_sessions，可通过 --log-dir-prefix 指定）
更新符号链接 <prefix>/latest -> <prefix>/<timestamp>/
启动模式对应组件并执行健康检查
写入会话文件 <prefix>/latest/session.json

其中：

master 默认启动：etcd、ds_master、ds_worker、function_master、function_proxy、function_agent
agent 默认启动：ds_worker、function_proxy、function_agent

样例#

启动主节点：

yr start --master

启动成功后，终端会打印用于 worker 节点加入集群的推荐命令（包含 -s 'values.*=...' 覆盖项）。

在 worker 节点可直接执行该命令加入集群，例如：

yr start -s 'values.etcd.address=[{ip="10.88.0.4",peer_port="32380",port="32379"}]' \
  -s 'values.ds_master.ip="10.88.0.4"' \
  -s 'values.ds_master.port="12123"' \
  -s 'values.function_master.ip="10.88.0.4"' \
  -s 'values.function_master.global_scheduler_port="22770"'

或使用自动发现模式（agent）：

yr start --master_address http://10.88.0.4:22770

指定日志输出前缀（将所有会话与日志迁到 /data/yr_logs 下）：

yr start --master --log-dir-prefix /data/yr_logs

备注

--log-dir-prefix 仅替换前缀部分，其下的 <timestamp>/ 子目录、logs/、session.json 等结构保持不变。多次启动会在同一前缀下累积多个时间戳目录，latest 软链始终指向最近一次。