Skip to main content
本指南将向您展示如何使用控制平面将您的应用程序部署到混合或自托管实例。通过控制平面，您可以在本地构建 Docker 镜像，将其推送到您的 Kubernetes 集群可以访问的注册表，然后使用 LangSmith UI 进行部署。
本指南适用于部署应用程序，而非设置基础设施。在使用本指南之前，您必须已完成基础设施设置：如果您尚未设置基础设施，请从平台设置部分开始。

​
概述

使用控制平面部署到混合或自托管 LangSmith 实例的应用程序使用 Docker 镜像。在本指南中，应用程序部署工作流程如下：
  1. 使用 langgraph dev 或 Studio 在本地测试您的应用程序。
  2. 使用 langgraph build 命令构建 Docker 镜像。
  3. 将镜像推送到您的基础设施可以访问的容器注册表。
  4. 通过指定镜像 URL，从控制平面 UI 进行部署。

​
先决条件

在完成本指南之前，您需要满足以下条件：
  • 已完成基础设施设置，以使您的数据平面能够接收应用程序部署：
    • 混合设置：在您的 Kubernetes 集群中安装数据平面组件（监听器、操作器、CRD），这些组件连接到 LangChain 托管的控制平面。
    • 启用 LangSmith 部署：在您的自托管 LangSmith 实例上启用 LangSmith 部署。
  • 可以访问已启用 LangSmith 部署的 LangSmith UI。
  • 一个您的 Kubernetes 集群可以访问的容器注册表。如果使用需要身份验证的私有注册表，您必须在基础设施设置中配置镜像拉取密钥。请参阅私有注册表身份验证。

​
步骤 1. 本地测试

在部署之前，请在本地测试您的应用程序。您可以使用 LangGraph CLI 在开发模式下运行代理服务器： 
langgraph dev
有关本地测试的完整指南，请参阅本地服务器快速入门。

​
步骤 2. 构建 Docker 镜像

使用 langgraph build 命令构建应用程序的 Docker 镜像： 
langgraph build -t my-image
构建命令选项包括：
选项默认值描述
-t, --tag TEXT必需Docker 镜像的标签
--platform TEXT构建的目标平台（例如，linux/amd64,linux/arm64）
--pull / --no-pull--pull使用最新的远程 Docker 镜像进行构建
-c, --config FILElanggraph.json配置文件的路径
指定平台的示例： 
langgraph build --platform linux/amd64 -t my-image:v1.0.0
有关完整详情，请参阅 CLI 参考。

​
步骤 3. 推送到容器注册表

将您的镜像推送到您的 Kubernetes 集群可以访问的容器注册表。具体命令取决于您的注册表提供商。
为您的镜像添加版本信息标签（例如，my-registry.com/my-app:v1.0.0），以便于回滚。

​
步骤 4. 使用控制平面 UI 部署

控制平面 UI 允许您创建和管理部署、查看日志和指标以及更新配置。要在 LangSmith UI 中创建新部署：
  1. 在左侧导航面板中，选择 Deployments。
  2. 在右上角，选择 + New Deployment。
  3. 在部署配置面板中，提供：
    • Image URL：您在步骤 3 中推送的完整镜像 URL。
    • Listener/Compute ID：选择为您的基础设施配置的监听器。
    • Namespace：要部署到的 Kubernetes 命名空间。
    • Environment variables：任何必需的配置（API 密钥等）。
    • 其他部署设置（根据需要）。
  4. 选择 Submit。
控制平面将与您的数据平面监听器协调以部署您的应用程序。 创建部署后，基础设施将异步配置。部署可能需要几分钟时间，由于数据库创建，初始部署可能需要更长时间。 从控制平面 UI，您可以查看构建日志、服务器日志和部署指标，包括 CPU/内存使用情况、副本数和 API 性能。有关更多详情，请参阅控制平面监控文档。
每个部署都会自动创建一个 LangSmith 可观测性追踪项目，其名称与部署相同。追踪环境变量由控制平面自动设置。

​
更新部署

要部署应用程序的新版本，请创建一个新修订版： 从 LangSmith UI 开始：
  1. 在左侧导航面板中，选择 Deployments。
  2. 选择一个现有部署。
  3. 在部署视图中，在右上角选择 + New Revision。
  4. 更新配置：
    • 将 Image URL 更新为您的新镜像版本。
    • 根据需要更新环境变量。
    • 根据需要调整其他设置。
  5. 选择 Submit。

​
私有注册表身份验证

如果您的容器注册表需要身份验证（例如，AWS ECR、Azure ACR、GCP Artifact Registry、私有 Docker 注册表），您必须在部署应用程序之前配置 Kubernetes 镜像拉取密钥。这是一次性的基础设施配置。
此配置在基础设施级别完成，而非每次部署。 一旦配置，所有部署将自动继承注册表凭据。
配置步骤取决于您的部署类型：
  • 带控制平面的自托管：在您的 LangSmith Helm chart 的 values.yaml 文件中配置 imagePullSecrets。有关详细步骤，请参阅启用 LangSmith 部署指南。
  • 混合：在您的 langgraph-dataplane-values.yaml 文件中使用相同格式配置 imagePullSecrets。
有关为不同注册表提供商创建镜像拉取密钥的详细步骤，请参阅 Kubernetes 关于从私有注册表拉取镜像的文档。

​
后续步骤

将这些文档通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。
在 GitHub 上编辑此页面 或 提交问题。