为您的 LangSmith 安装创建镜像

默认情况下，LangSmith 将从我们的公共 Docker 注册表拉取镜像。但是，如果您在无法访问互联网的环境中运行 LangSmith，或者您希望使用私有 Docker 注册表，您可以将镜像镜像到您自己的注册表，然后配置您的 LangSmith 安装以使用这些镜像。

要求

您的 Kubernetes 集群/机器可以访问的 Docker 注册表的认证访问权限。
您的本地机器或可以访问 Docker 注册表的机器上安装了 Docker。
您可以在其中运行 LangSmith 的 Kubernetes 集群。

镜像镜像

为了方便起见，我们提供了一个脚本来为您镜像镜像。您可以在 LangSmith Helm Chart 仓库中找到该脚本。要使用该脚本，您需要使用以下命令运行脚本，指定您的注册表和平台：

bash mirror_images.sh <your-registry> [<platform>]

其中 <your-registry> 是您的 Docker 注册表的 URL（例如 myregistry.com），<platform> 是您使用的平台（例如 linux/amd64、linux/arm64 等）。如果您未指定平台，它将默认为 linux/amd64。例如，如果您的注册表是 myregistry.com，您的平台是 linux/arm64，并且您想使用最新版本的镜像，您将运行：

bash mirror_langsmith_images.sh --registry myregistry --platform linux/arm64 --version 0.10.66

请注意，此脚本将假设您已安装 Docker 并且已对您的注册表进行了身份验证。它还将使用与原始镜像相同的仓库/标签将镜像推送到指定的注册表。或者，您可以手动拉取、镜像和推送镜像。您需要镜像的镜像可以在 LangSmith Helm Chart 的 values.yaml 文件中找到。可以在这里找到：LangSmith Helm Chart values.yaml 以下是使用 Docker 镜像镜像的示例：

# 从公共注册表拉取镜像
docker pull langchain/langsmith-backend:latest
docker tag langchain/langsmith-backend:latest <your-registry>/langsmith-backend:latest
docker push <your-registry>/langsmith-backend:latest

您需要为要镜像的每个镜像重复此操作。

配置

镜像镜像后，您需要配置您的 LangSmith 安装以使用镜像镜像。您可以通过修改 LangSmith Helm Chart 安装的 values.yaml 文件来完成此操作。将标签替换为您要使用的版本，例如 0.10.66（撰写本文时的最新版本）。

images:
  imagePullSecrets: [] # 如果需要，在此处添加您的镜像拉取密钥
  registry: "" # 如果您使用我们的脚本将所有镜像镜像到同一个注册表，请将此设置为您的注册表 URL。然后您可以从下面的镜像中删除仓库前缀。
  aceBackendImage:
    repository: "(your-registry)/langchain/langsmith-ace-backend"
    pullPolicy: IfNotPresent
    tag: "0.10.66"
  backendImage:
    repository: "(your-registry)/langchain/langsmith-backend"
    pullPolicy: IfNotPresent
    tag: "0.10.66"
  frontendImage:
    repository: "(your-registry)/langchain/langsmith-frontend"
    pullPolicy: IfNotPresent
    tag: "0.10.66"
  hostBackendImage:
    repository: "(your-registry)/langchain/hosted-langserve-backend"
    pullPolicy: IfNotPresent
    tag: "0.10.66"
  operatorImage:
    repository: "(your-registry)/langchain/langgraph-operator"
    pullPolicy: IfNotPresent
    tag: "6cc83a8"
  platformBackendImage:
    repository: "(your-registry)/langchain/langsmith-go-backend"
    pullPolicy: IfNotPresent
    tag: "0.10.66"
  playgroundImage:
    repository: "(your-registry)/langchain/langsmith-playground"
    pullPolicy: IfNotPresent
    tag: "0.10.66"
  postgresImage:
    repository: "(your-registry)/postgres"
    pullPolicy: IfNotPresent
    tag: "14.7"
  redisImage:
    repository: "(your-registry)/redis"
    pullPolicy: IfNotPresent
    tag: "7"
  clickhouseImage:
    repository: "(your-registry)/clickhouse/clickhouse-server"
    pullPolicy: Always
    tag: "24.8"

Fleet 和 Insights 的附加镜像

如果您使用 Fleet 或 Insights，LangGraph 操作符会为每个部署动态创建 Redis 和 PostgreSQL (pgvector) Pod。这些 Pod 使用操作符模板中定义的镜像，这些模板需要单独配置。您必须镜像这些附加镜像：

docker.io/redis:7
docker.io/pgvector/pgvector:pg15

然后，在您的 values.yaml 中覆盖操作符模板以使用您的镜像镜像：

operator:
  templates:
    redis: |
      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: ${service_name}
        namespace: ${namespace}
      spec:
        replicas: 1
        selector:
          matchLabels:
            app: ${service_name}
        template:
          metadata:
            labels:
              app: ${service_name}
          spec:
            enableServiceLinks: false
            containers:
            - name: redis
              image: (your-registry)/redis:7
              ports:
              - containerPort: 6379
                name: redis
              livenessProbe:
                exec:
                  command:
                  - redis-cli
                  - ping
                initialDelaySeconds: 30
                periodSeconds: 10
              readinessProbe:
                tcpSocket:
                  port: 6379
                initialDelaySeconds: 10
                periodSeconds: 5
    db: |
      apiVersion: apps/v1
      kind: StatefulSet
      metadata:
        name: ${service_name}
      spec:
        serviceName: ${service_name}
        selector:
          matchLabels:
            app: ${service_name}
        persistentVolumeClaimRetentionPolicy:
          whenDeleted: Delete
          whenScaled: Retain
        template:
          metadata:
            labels:
              app: ${service_name}
          spec:
            containers:
            - name: postgres
              image: (your-registry)/pgvector/pgvector:pg15
              ports:
              - containerPort: 5432
              command: ["docker-entrypoint.sh"]
              args:
                - postgres
                - -c
                - max_connections=${max_connections}
              env:
              - name: PGDATA
                value: /var/lib/postgresql/data/pgdata
              volumeMounts:
              - name: postgres-data
                mountPath: /var/lib/postgresql/data
            enableServiceLinks: false
        volumeClaimTemplates:
        - metadata:
            name: postgres-data
          spec:
            accessModes: ["ReadWriteOnce"]
            resources:
              requests:
                storage: "${storage_gi}Gi"

将 (your-registry) 替换为您的注册表 URL。模板变量（${service_name}、${namespace}、${max_connections}、${storage_gi}）由操作符在运行时替换，必须保持原样。配置完成后，您需要更新您的 LangSmith 安装。您可以按照我们的升级指南进行操作：升级 LangSmith。如果您的升级成功，您的 LangSmith 实例现在应该使用来自您的 Docker 注册表的镜像镜像。

将这些文档通过 MCP 连接到 Claude、VSCode 等，以获取实时答案。

在 GitHub 上编辑此页面或提交问题。

Overview

Hybrid

Self-hosted

为您的 LangSmith 安装创建镜像

要求

镜像镜像

配置

Fleet 和 Insights 的附加镜像

​要求

​镜像镜像

​配置

​Fleet 和 Insights 的附加镜像

要求

镜像镜像

配置

Fleet 和 Insights 的附加镜像