为您的安装使用现有密钥（Kubernetes）

默认情况下，LangSmith 会配置多个 Kubernetes 密钥来存储敏感信息，例如许可证密钥、盐值和其他配置参数。但是，您可能希望使用已在 Kubernetes 集群中创建（或通过某种密钥操作器配置）的现有密钥。如果您希望以集中方式管理敏感信息，或者有特定的安全要求，这会很有用。默认情况下，我们将配置以下与 LangSmith 不同组件对应的密钥：

langsmith-secrets：此密钥包含许可证密钥和其他一些基本配置参数。要开始使用，请参考密钥模板。
langsmith-redis：此密钥包含 Redis 连接字符串（如果使用 Redis 集群，则为节点 URI）和密码。要开始使用，请参考 Redis 密钥模板。
langsmith-postgres：此密钥包含 Postgres 连接字符串和密码。要开始使用，请参考 Postgres 密钥模板。
langsmith-clickhouse：此密钥包含 ClickHouse 连接字符串和密码。要开始使用，请参考 ClickHouse 密钥模板。

要求

一个现有的 Kubernetes 集群
一种在集群中创建 Kubernetes 密钥的方法。可以使用 kubectl、Helm chart 或像 Sealed Secrets 这样的密钥操作器来完成。

参数

您需要创建自己的 Kubernetes 密钥，其结构需与 LangSmith Helm Chart 配置的密钥结构一致。

密钥必须与 LangSmith Helm Chart 配置的密钥具有相同的结构（请参考上面的链接查看具体的密钥）。如果您缺少任何必需的键，您的 LangSmith 实例可能无法正常工作。

一个示例密钥可能如下所示：

apiVersion: v1
kind: Secret
metadata:
  name: langsmith-secrets
  namespace: langsmith
stringData:
  oauth_client_id: foo
  oauth_client_secret: foo
  oauth_issuer_url: foo
  langsmith_license_key: foo
  langgraph_cloud_license_key: foo
  api_key_salt: foo
  jwt_secret: foo
  initial_org_admin_password: foo
  blob_storage_access_key: foo
  blob_storage_access_key_secret: foo
  azure_storage_account_key: foo
  azure_storage_connection_string: foo
  agent_builder_encryption_key: foo
  insights_encryption_key: foo
  polly_encryption_key: foo

配置

配置好这些密钥后，您可以配置 LangSmith 实例直接使用这些密钥，以避免通过明文传递密钥值。您可以通过修改 LangSmith Helm Chart 安装的 langsmith_config.yaml 文件来完成此操作。

config:
  existingSecretName: "langsmith-secrets" # 包含许可证密钥和其他基本配置参数的密钥名称
redis:
  external:
    enabled: true # 设置为 true 以使用外部 Redis 实例。仅当您使用外部 Redis 实例时才需要此密钥
    existingSecretName: "langsmith-redis" # 包含 Redis 连接字符串和密码的密钥名称
postgres:
  external:
    enabled: true # 设置为 true 以使用外部 Postgres 实例。仅当您使用外部 Postgres 实例时才需要此密钥
    existingSecretName: "langsmith-postgres" # 包含 Postgres 连接字符串和密码的密钥名称
clickhouse:
  external:
    enabled: true # 设置为 true 以使用外部 ClickHouse 实例。仅当您使用外部 ClickHouse 实例时才需要此密钥
    existingSecretName: "langsmith-clickhouse" # 包含 ClickHouse 连接字符串和密码的密钥名称

配置完成后，您需要更新 LangSmith 安装。您可以按照升级指南进行操作。如果一切配置正确，您的 LangSmith 实例现在应该可以通过入口访问。您可以运行以下命令来检查密钥是否被正确使用：

kubectl describe deployment langsmith-backend | grep -i <secret-name>

您应该在输出中看到类似以下内容：

POSTGRES_DATABASE_URI:                    <set to the key 'connection_url' in secret <your-secret-name>  Optional: false
CLICKHOUSE_DB:                            <set to the key 'clickhouse_db' in secret <your-secret-name>   Optional: false

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

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

Overview

Hybrid

Self-hosted

为您的安装使用现有密钥（Kubernetes）

要求

参数

配置

​要求

​参数

​配置

要求

参数

配置