deploy 命令用于构建并将项目部署到 AgentKit,依次执行配置、构建与应用的完整流程。同时,该流程的各个阶段也以独立子命令的形式提供。
deploy
执行完整的部署流程(config → build → apply)。顶层选项将在配置阶段生效。agentkit.yaml 的 im 块中配置(飞书、企业微信与钉钉),详见 agentkit.yaml。--im-feishu* 这几个标志只是无需改文件、直接部署飞书代理的便捷方式。
deploy config
脚手架生成.agentkit/ 目录,其中包含 agentkit.yaml 与 Dockerfile。
agentkit.yaml 是部署配置的唯一来源,deploy build 与 deploy apply 都从中读取。完整的文件结构与逐字段说明见 agentkit.yaml。
容器入口与端口
deploy 不涉及入口点配置——运行时如何启动,完全由构建镜像所用的 Dockerfile 决定。模板 Dockerfile 以 CMD 指定启动命令:
0.0.0.0:8000,运行时会探测该端口以判断实例是否就绪。要更换启动方式,请修改 Dockerfile 的 CMD(或通过 dockerfile 字段指向其他文件),而不是向 deploy 传参。
环境变量
运行时环境变量在agentkit.yaml 的 envs 中声明,值用 ${VAR} 从部署环境引用(语法与字段详解见 agentkit.yaml · 环境变量)。CLI 在部署时解析这些引用并注入运行时。
本地部署时,把变量导出(或放进本机 .env,不提交)后再部署:
VOLCENGINE_* 不会注入运行时。