tcb cloudrun run
在本地运行和调试函数型云托管服务。容器型服务不支持本地运行。
语法
tcb cloudrun run -e <envId> [options]
# Agent 模式
tcb cloudrun run --runMode agent --agentId <agentId> -e <envId>
参数
| 参数 | 必填 | 说明 | 默认值 |
|---|---|---|---|
-e, --env-id <envId> | 是 | 环境 ID | — |
--runMode <mode> | 否 | 运行模式：normal（普通函数）/ agent（函数式 Agent） | normal |
--agentId <agentId> | 条件必填 | Agent ID，agent 模式下必填 | — |
--port <port> | 否 | 监听端口 | 3000 |
-w, --watch | 否 | 热重启，文件变更时自动重启服务 | false |
--dry-run | 否 | 仅验证代码可正常加载，不启动服务 | false |
--logDirname <dir> | 否 | 日志文件目录，相对当前目录解析 | ./logs |
--functionsConfigFile <file> | 否 | 多函数定义配置文件路径，相对当前目录解析 | ./cloudbase-functions.json |
--loadAllFunctions | 否 | 加载 functionsRoot 目录中的所有函数 | false |
--extendedContext <json> | 否 | 用于解析 context.extendedContext 的 JSON 字符串，如 '{"a":1,"b":2}' | — |
--open-debug-panel | 否 | 是否打开调试面板 | true |
示例
# 普通模式运行，默认端口 3000
tcb cloudrun run -e env-123456
# 指定端口
tcb cloudrun run -e env-123456 --port 8080
# 热重启模式
tcb cloudrun run -e env-123456 -w
# 仅验证代码可正常加载
tcb cloudrun run -e env-123456 --dry-run
# 加载指定目录下的所有函数
tcb cloudrun run -e env-123456 --loadAllFunctions
Agent 模式：
# 运行 Agent 模式进行调试
tcb cloudrun run --runMode agent --agentId ibot-agent-xxx -e env-123456
# Agent 模式带热重启
tcb cloudrun run --runMode agent --agentId ibot-agent-xxx -e env-123456 -w
# Agent 模式指定端口
tcb cloudrun run --runMode agent --agentId ibot-agent-xxx -e env-123456 --port 8080
环境变量
在项目目录下创建 .env.local（未指定 --cwd 时即当前目录），按 KEY=VALUE 格式配置：
# .env.local
API_KEY=your_api_key123
DATABASE_URL=mysql://localhost:3306/db
环境变量只在本地运行时生效，部署后需在控制台配置。
注意事项
- 仅支持函数型云托管服务，容器型服务不支持
- Agent 模式需要先创建 Agent 并获取 Agent ID
- 命令先切换到项目目录再启动服务，命令行传入的路径仍相对当前目录解析
- 函数写法与示例见函数示例