本指南用于部署应用程序，而不是设置基础设施。在使用本指南之前，您必须已完成基础设施设置：
- 混合设置：用于混合托管。
- 启用 LangSmith Deployment：用于带控制平面的自托管。
概述
部署到带有控制平面的混合或自托管 LangSmith 实例的应用程序使用 Docker 镜像。在本指南中，应用程序部署工作流程如下：- 使用
langgraph dev或 Studio 在本地测试您的应用程序。 - 使用
langgraph build命令构建 Docker 镜像。 - 将镜像推送到您的基础设施可以访问的容器注册表。
- 通过指定镜像 URL 从控制平面 UI 进行部署。
前提条件
在完成本指南之前，您需要以下内容：- 完成基础设施设置以使您的数据平面能够接收应用程序部署：
- 混合设置：在连接到 LangChain 的托管控制平面的 Kubernetes 集群中安装数据平面组件（监听器、操作器、CRD）。
- 启用 LangSmith Deployment：在您的自托管 LangSmith 实例上启用 LangSmith Deployment。
- 访问已启用 LangSmith Deployment 的 LangSmith UI。
- Kubernetes 集群可以访问的容器注册表。
步骤 1. 本地测试
在部署之前，请在本地测试您的应用程序。您可以使用 LangGraph CLI 在开发模式下运行智能体服务器：步骤 2. 构建 Docker 镜像
使用langgraph build 命令构建应用程序的 Docker 镜像：
| 选项 | 默认值 | 描述 |
|---|---|---|
-t, --tag TEXT | 必需 | Docker 镜像的标签 |
--platform TEXT | 要构建的目标平台（例如，linux/amd64,linux/arm64） | |
--pull / --no-pull | --pull | 使用最新的远程 Docker 镜像构建 |
-c, --config FILE | langgraph.json | 配置文件的路径 |
步骤 3. 推送到容器注册表
将您的镜像推送到 Kubernetes 集群可以访问的容器注册表。具体命令取决于您的注册表提供商。步骤 4. 使用控制平面 UI 部署
控制平面 UI 允许您创建和管理部署、查看日志和指标以及更新配置。要在 LangSmith UI 中创建新部署：- 在左侧导航面板中，选择 Deployments。
- 在右上角，选择 + New Deployment。
- 在部署配置面板中，提供：
- Image URL：您在步骤 3 中推送的完整镜像 URL。
- Listener/Compute ID：选择为您的基础设施配置的监听器。
- Namespace：要部署到的 Kubernetes 命名空间。
- Environment variables：任何所需的配置（API 密钥等）。
- 根据需要的其他部署设置。
- 选择 Submit。
为每个部署自动创建与部署同名的 LangSmith 可观测性跟踪项目。跟踪环境变量由控制平面自动设置。
更新部署
要部署应用程序的新版本，请创建新修订版： 从 LangSmith UI 开始：- 在左侧导航面板中，选择 Deployments。
- 选择现有部署。
- 在 Deployment 视图中，在右上角选择 + New Revision。
- 更新配置：
- 将 Image URL 更新为您的新镜像版本。
- 如果需要，更新环境变量。
- 根据需要调整其他设置。
- 选择 Submit。
后续步骤
- 控制平面：了解有关控制平面功能的更多信息。
- 数据平面：了解数据平面架构。
- 可观测性：使用自动跟踪监控您的部署。
- Studio：测试和调试已部署的应用程序。
- LangGraph CLI：完整的 CLI 参考文档。