本指南适用于部署应用程序，而非设置基础设施。在使用本指南之前，您必须已经完成基础设施设置：
- 混合设置：用于混合托管。
- 启用 LangSmith 部署：用于带有控制平面的自托管。
概览
部署到带有控制平面的混合或自托管 LangSmith 实例的应用程序使用 Docker 镜像。在本指南中，应用程序部署工作流程是：- 使用
langgraph dev或 Studio 在本地测试您的应用程序。 - 使用
langgraph build命令构建 Docker 镜像。 - 将镜像推送到您的基础设施可访问的容器注册表。
- 通过指定镜像 URL 从控制平面 UI 进行部署。
先决条件
在完成本指南之前，您需要以下内容：- 已完成基础设施设置，以使您的数据平面能够接收应用程序部署
- 混合设置：在您的 Kubernetes 集群中安装数据平面组件（监听器、操作员、CRD），这些组件连接到 LangChain 的托管控制平面。
- 启用 LangSmith 部署：在您的自托管 LangSmith 实例上启用 LangSmith 部署。
- 访问已启用 LangSmith 部署的 LangSmith UI。
- 您的 Kubernetes 集群可访问的容器注册表。
第 1 步：本地测试
在部署之前，请在本地测试您的应用程序。您可以使用LangGraph CLI 在开发模式下运行 LangGraph 服务器。第 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 集群可访问的容器注册表。具体命令取决于您的注册表提供商。使用版本信息标记您的镜像（例如，
my-registry.com/my-app:v1.0.0），以便于回滚。第 4 步：使用控制平面 UI 部署
控制平面 UI 允许您创建和管理部署、查看日志和指标以及更新配置。要在 LangSmith UI 中创建新部署：- 在左侧导航面板中，选择部署。
- 在右上角，选择+ 新建部署。
- 在部署配置面板中，提供：
- 镜像 URL：您在第 3 步中推送的完整镜像 URL。
- 监听器/计算 ID：选择为您的基础设施配置的监听器。
- 命名空间：要部署到的 Kubernetes 命名空间。
- 环境变量：任何必需的配置（API 密钥等）。
- 其他部署设置（如果需要）。
- 选择提交。
每个部署都会自动创建一个与部署同名的LangSmith 可观测性追踪项目。追踪环境变量由控制平面自动设置。
更新部署
要部署应用程序的新版本，请创建新修订版本： 从 LangSmith UI 开始：- 在左侧导航面板中，选择部署。
- 选择现有部署。
- 在部署视图中，选择右上角的+ 新建修订版本。
- 更新配置
- 将镜像 URL 更新为您的新镜像版本。
- 如果需要，更新环境变量。
- 根据需要调整其他设置。
- 选择提交。
后续步骤
- 控制平面：了解有关控制平面功能的更多信息。
- 数据平面：了解数据平面架构。
- 可观测性：通过自动追踪监控您的部署。
- Studio：测试和调试已部署的应用程序。
- LangGraph CLI：完整的 CLI 参考文档。
以编程方式连接这些文档到 Claude、VSCode 等，通过 MCP 获取实时答案。