为安装创建 Ingress（Kubernetes）

​

要求

• 一个现有的 Kubernetes 集群
• 在您的 Kubernetes 集群中安装了以下任一组件：
  • 一个 Ingress 控制器（用于标准 Ingress）
  • Gateway API CRD 和一个 Gateway 资源（用于 Gateway API）
  • Istio（用于 Istio Gateway）

​

参数

• 主机名（可选）：您希望用于 LangSmith 安装的主机名。例如 "langsmith.example.com"。如果留空，Ingress 将为 LangSmith 安装的所有流量提供服务。
• 基础路径（可选）：如果您希望在 URL 基础路径下提供 LangSmith 服务，可以在此处指定。例如，添加 "langsmith" 将在 "example.hostname.com/langsmith" 下提供应用程序服务。这将适用于 UI 路径以及 API 端点。
• IngressClassName（可选）：您希望使用的 Ingress 类的名称。如果未设置，将使用默认的 Ingress 类。
• 注解（可选）：要添加到 Ingress 的附加注解。某些提供商（如 AWS）可能使用注解来控制诸如 TLS 终止之类的事情。 例如，您可以使用 AWS ALB Ingress 控制器添加以下注解，将 ACM 证书附加到 Ingress：
  annotations:
    alb.ingress.kubernetes.io/certificate-arn: "<your-certificate-arn>"
  
• 标签（可选）：要添加到 Ingress 的附加标签。
• TLS（可选）：如果您希望通过 HTTPS 提供 LangSmith 服务，可以在此处添加 TLS 配置（许多 Ingress 控制器可能有其他控制 TLS 的方式，因此通常不需要）。这应该是一个 TLS 配置数组。每个 TLS 配置应包含以下字段：
  • hosts：证书应对其有效的主机名数组。例如 [“langsmith.example.com”]
  • secretName：包含证书和私钥的 Kubernetes Secret 的名称。此 Secret 应具有以下键：
    • tls.crt：证书
    • tls.key：私钥
  • 有关更多信息，请参阅创建 TLS Secret。

​

配置

​

选项 1：标准 Ingress

config:
  hostname: "" # LangSmith 的主域名
  basePath: "" # 如果您希望在 URL 基础路径下提供 langsmith 服务（例如 /langsmith）
ingress:
  enabled: true
  hostname: "" # 已弃用：v0.12.0 后请改用 config.hostname
  subdomain: "" # 已弃用：v0.12.0 后请改用 config.hostname
  ingressClassName: "" # 如果未设置，将使用默认的 ingress 类
  annotations: {} # 如果需要，在此添加注解
  labels: {} # 如果需要，在此添加标签
  tls: [] # 如果需要，在此添加 TLS 配置
frontend:
  service:
    type: ClusterIP

kubectl get ingress

NAME                         CLASS   HOSTS    ADDRESS          PORTS     AGE
langsmith-ingress            nginx   <host>   35.227.243.203   80, 443   95d

​

选项 2：Gateway API

​

参数

• name（必需）：要引用的 Gateway 资源的名称
• namespace（必需）：Gateway 资源所在的命名空间
• hostname（可选）：您希望用于 LangSmith 安装的主机名。例如 "langsmith.example.com"
• basePath（可选）：如果您希望在基础路径下提供 LangSmith 服务，可以在此处指定。例如 “example.com/langsmith”
• sectionName（可选）：要使用的 Gateway 中特定监听器部分的名称
• annotations（可选）：要添加到 HTTPRoute 资源的附加注解
• labels（可选）：要添加到 HTTPRoute 资源的附加标签

​

配置

config:
  hostname: "" # LangSmith 的主域名
  basePath: "" # 如果您希望在基础路径下提供 langsmith 服务。例如 "example.com/langsmith"
gateway:
  enabled: true
  name: "my-gateway" # 您的 Gateway 资源的名称
  namespace: "gateway-system" # 您的 Gateway 资源的命名空间
  sectionName: "" # 可选：特定的监听器部分名称
  annotations: {} # 如果需要，在此添加注解
  labels: {} # 如果需要，在此添加标签
frontend:
  service:
    type: ClusterIP

kubectl get httproute

​

选项 3：Istio Gateway

​

参数

• name（可选）：要引用的 Istio Gateway 资源的名称。默认为 "istio-gateway"
• namespace（可选）：Istio Gateway 资源所在的命名空间。默认为 "istio-system"
• hostname（可选）：您希望用于 LangSmith 安装的主机名。例如 "langsmith.example.com"
• basePath（可选）：如果您希望在基础路径下提供 LangSmith 服务，可以在此处指定。例如 “example.com/langsmith”
• annotations（可选）：要添加到 VirtualService 资源的附加注解
• labels（可选）：要添加到 VirtualService 资源的附加标签

​

配置

config:
  hostname: "" # LangSmith 的主域名
  basePath: "" # 如果您希望在单独的 basePath 上提供 langsmith 服务。例如 "example.com/langsmith"
istioGateway:
  enabled: true
  name: "istio-gateway" # 您的 Istio Gateway 资源的名称
  namespace: "istio-system" # 您的 Istio Gateway 资源的命名空间
  annotations: {} # 如果需要，在此添加注解
  labels: {} # 如果需要，在此添加标签
frontend:
  service:
    type: ClusterIP

kubectl get virtualservice