控制平面 UI
从控制平面 UI,您可以- 查看未完成部署的列表。
- 查看单个部署的详细信息。
- 创建新部署。
- 更新部署。
- 更新部署的环境变量。
- 查看部署的构建和服务器日志。
- 查看部署指标,例如 CPU 和内存使用情况。
- 删除部署。
控制平面 API
本节描述了控制平面 API 的数据模型。API 用于创建、更新和删除部署。有关更多详细信息,请参阅控制平面 API 参考。集成
集成是git 仓库提供商(例如 GitHub)的抽象。它包含连接和从 git 仓库部署所需的所有元数据。
部署
部署是 LangGraph 服务器的实例。单个部署可以有许多修订版本。修订版本
修订版本是部署的迭代。当创建新部署时,会自动创建初始修订版本。要部署代码更改或更新部署的秘密,必须创建新修订版本。监听器
监听器是 “监听器”应用程序的实例。监听器包含有关应用程序的元数据(例如版本)以及有关它可以部署到的计算基础设施的元数据(例如 Kubernetes 命名空间)。 监听器数据模型仅适用于混合和自托管部署。控制平面功能
本节描述了控制平面的各种功能。部署类型
为简单起见,控制平面提供了两种具有不同资源分配的部署类型:Development(开发)和 Production(生产)。
| 部署类型 | CPU/内存 | 扩展 | 数据库 |
|---|---|---|---|
| 开发 | 1 个 CPU,1 GB 内存 | 最多 1 个副本 | 10 GB 磁盘,无备份 |
| 生产 | 2 个 CPU,2 GB 内存 | 最多 10 个副本 | 自动扩展磁盘,自动备份,高可用性(多区域配置) |
不可变部署类型 部署创建后,部署类型无法更改。
生产
Production 类型部署适用于“生产”工作负载。例如,对于关键路径中的面向客户的应用程序,请选择 Production。 Production 类型部署的资源可以根据用例和容量限制,在个案基础上手动增加。请联系 support@langchain.dev 请求增加资源。开发
Development 类型部署适用于开发和测试。例如,为内部测试环境选择 Development。Development 类型部署不适用于“生产”工作负载。
可抢占计算基础设施
Development 类型部署(API 服务器、队列服务器和数据库)配置在可抢占计算基础设施上。这意味着计算基础设施可能随时终止而无需通知。这可能导致间歇性……- Redis 连接超时/错误
- Postgres 连接超时/错误
- 失败或重试的后台运行
Development 类型部署的成本。根据设计,LangGraph Server 具有容错性。该实现将自动尝试从 Redis/Postgres 连接错误中恢复并重试失败的后台运行。Production 类型部署配置在持久计算基础设施上,而不是可抢占计算基础设施。Development 类型部署的数据库磁盘大小可以根据用例和容量限制,在个案基础上手动增加。对于大多数用例,应配置 TTL 以管理磁盘使用。请联系 support@langchain.dev 请求增加资源。
数据库配置
控制平面和 数据平面“监听器”应用程序协同工作,为每个部署自动创建 Postgres 数据库。该数据库充当部署的持久层。 在实现 LangGraph 应用程序时,开发人员无需配置检查点。相反,检查点会自动为图配置。为图配置的任何检查点都将被自动配置的检查点替换。 无法直接访问数据库。所有数据库访问都通过LangGraph Server进行。 数据库在部署本身被删除之前不会被删除。异步部署
部署和修订版本的基础设施是异步配置和部署的。它们不会在提交后立即部署。目前,部署可能需要几分钟。- 当创建新部署时,会为该部署创建一个新数据库。数据库创建是一次性步骤。此步骤导致部署的初始修订版本的部署时间较长。
- 当为部署创建后续修订版本时,没有数据库创建步骤。后续修订版本的部署时间比初始修订版本的部署时间显著更快。
- 每个修订版本的部署过程都包含一个构建步骤,可能需要几分钟。
监控
部署准备就绪后,控制平面会监控部署并记录各种指标,例如- 部署的 CPU 和内存使用情况。
- 容器重启次数。
- 副本数量(这将随着自动扩展而增加)。
- PostgreSQL CPU、内存使用情况和磁盘使用情况。
- LangGraph Server 队列待处理/活动运行计数。
- LangGraph Server API 成功响应计数、错误响应计数和延迟。
LangSmith 集成
会自动为每个部署创建一个 LangSmith 追踪项目。追踪项目与部署同名。创建部署时,不需要指定LANGCHAIN_TRACING 和 LANGSMITH_API_KEY/LANGCHAIN_API_KEY 环境变量;它们由控制平面自动设置。 删除部署时,追踪和追踪项目不会被删除。以编程方式连接这些文档到 Claude、VSCode 等,通过 MCP 获取实时答案。