Skip to content
LangSmith 文档版本 跟随上游 源快照 92972973 更新于 2026-10-18

升级安装

WARNING

官方不支持降级。LangSmith 升级可能包含数据库迁移和其他非向后兼容的变更。如果你需要回滚到之前的版本,请通过 Support Portal 联系技术支持以获取指导。

如果你还没有添加该仓库,请运行以下命令添加:

bash
helm repo add langchain https://langchain-ai.github.io/helm/

更新你的本地 helm 仓库

bash
helm repo update

用新版本所需的更新更新你的 helm chart 配置文件。这些更新会在新版本的 release notes 中详细说明。

运行以下命令升级 chart(将 version 替换为你要升级到的版本):

NOTE

如果你使用的不是默认 namespace,需要在 helm 和 kubectl 命令中通过 -n <namespace 标志指定 namespace。

查找 chart 的最新版本。你可以在 LangSmith Helm Chart GitHub 仓库中找到,或运行以下命令:

bash
helm search repo langchain/langsmith --versions

你应该会看到类似这样的输出:

bash
NAME                             	CHART VERSION	APP VERSION	DESCRIPTION
langchain/langsmith              	0.15.13      	0.15.18    	Helm chart to deploy the langsmith application ...
langchain/langsmith              	0.15.12      	0.15.17    	Helm chart to deploy the langsmith application ...
langchain/langsmith              	0.15.11      	0.15.16    	Helm chart to deploy the langsmith application ...
langchain/langsmith              	0.15.10      	0.15.15    	Helm chart to deploy the langsmith application ...
langchain/langsmith              	0.15.9       	0.15.13    	Helm chart to deploy the langsmith application ...

选择你要升级到的版本(一般建议选择最新版本),并记下版本号:

NOTE

如果你的安装落后于最新 chart 超过一个大版本,请每次升级一个大版本,不要跳过大版本。对每个中间大版本重复此升级流程,然后再升级到最新受支持版本。

例如,要从 0.13.43 升级到 0.15.13,请先升级到 0.14.5,再升级到 0.15.13。

bash
helm upgrade <release-name> langchain/langsmith --version <version> --values <path-to-values-file> --wait --debug

验证升级是否成功:

bash
helm status <release-name>

所有 pod 都应处于 Running 状态。验证 ClickHouse 正在运行,并且两个 migrations 作业都已完成。

bash
kubectl get pods
NAME                                     READY   STATUS      RESTARTS   AGE
langsmith-backend-95b6d54f5-gz48b        1/1     Running     0          15h
langsmith-pg-migrations-d2z6k            0/1     Completed   0          5h48m
langsmith-ch-migrations-gasvk            0/1     Completed   0          5h48m
langsmith-clickhouse-0                   1/1     Running     0          26h
langsmith-frontend-84687d9d45-6cg4r      1/1     Running     0          15h
langsmith-hub-backend-66ffb75fb4-qg6kl   1/1     Running     0          15h
langsmith-playground-85b444d8f7-pl589    1/1     Running     0          15h
langsmith-queue-d58cb64f7-87d68          1/1     Running     0          15h

验证你的部署

  1. 运行 kubectl get services

    输出将类似于:

    bash
    NAME                         TYPE           CLUSTER-IP       EXTERNAL-IP     PORT(S)                      AGE
    kubernetes                   ClusterIP      172.20.0.1       <none>          443/TCP                      27d
    langsmith-backend            ClusterIP      172.20.22.34     <none>          1984/TCP                     21d
    langsmith-clickhouse         ClusterIP      172.20.117.62    <none>          8123/TCP,9000/TCP            21d
    langsmith-frontend           LoadBalancer   172.20.218.30    <external ip>   80:30093/TCP,443:31130/TCP   21d
    langsmith-platform-backend   ClusterIP      172.20.232.183   <none>          1986/TCP                     21d
    langsmith-playground         ClusterIP      172.20.167.132   <none>          3001/TCP                     21d
    langsmith-postgres           ClusterIP      172.20.59.63     <none>          5432/TCP                     21d
    langsmith-redis              ClusterIP      172.20.229.98    <none>          6379/TCP                     20d
  2. 对 langsmith-frontend 服务的外部 IP 执行 curl:

    bash
    curl <external ip>/api/info
    {"version":"0.5.7","license_expiration_time":"2033-05-20T20:08:06","batch_ingest_config":{"scale_up_qsize_trigger":1000,"scale_up_nthreads_limit":16,"scale_down_nempty_trigger":4,"size_limit":100,"size_limit_bytes":20971520}}

    检查版本是否与你升级到的版本一致。

  3. 在浏览器中访问 langsmith-frontend 服务的外部 IP。LangSmith UI 应当可见并可正常使用。

    LangSmith UI

BytesRouter 是社区翻译站点,所有译文仅供参考,一切以官方英文原文为准。