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

​
概述

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

​
先决条件

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

​
步骤 1. 本地测试

在部署之前，请在本地测试您的应用程序。您可以使用 LangGraph CLI 在开发模式下运行 Agent 服务器： 
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 图表的 values.yaml 文件中配置 imagePullSecrets。详细步骤请参阅启用 LangSmith 部署指南。
  • 混合部署：使用相同格式在您的 langgraph-dataplane-values.yaml 文件中配置 imagePullSecrets。
有关为不同注册表提供商创建镜像拉取密钥的详细步骤，请参阅 Kubernetes 关于从私有注册表拉取镜像的文档。

​
后续步骤

Edit this page on GitHub or file an issue.
Connect these docs to Claude, VSCode, and more via MCP for real-time answers.