설치를 위한 Ingress 생성하기 (Kubernetes)

​

Requirements

• 기존 Kubernetes 클러스터
• Kubernetes 클러스터에 다음 중 하나가 설치되어 있어야 합니다:
  • Ingress Controller (표준 Ingress용)
  • Gateway API CRD 및 Gateway 리소스 (Gateway API용)
  • Istio (Istio Gateway용)

​

Parameters

• Hostname (선택사항): LangSmith 설치에 사용할 hostname입니다. 예: "langsmith.example.com". 이 값을 비워두면 ingress가 LangSmith 설치로의 모든 트래픽을 처리합니다.
• BasePath (선택사항): LangSmith를 URL basePath 아래에서 제공하려면 여기에 지정할 수 있습니다. 예를 들어 "langsmith"를 추가하면 애플리케이션이 "example.hostname.com/langsmith"에서 제공됩니다. 이는 UI 경로와 API endpoint에 모두 적용됩니다.
• IngressClassName (선택사항): 사용할 Ingress class의 이름입니다. 설정하지 않으면 기본 Ingress class가 사용됩니다.
• Annotations (선택사항): Ingress에 추가할 추가 annotation입니다. AWS와 같은 특정 제공업체는 annotation을 사용하여 TLS 종료와 같은 것을 제어할 수 있습니다. 예를 들어, AWS ALB Ingress Controller를 사용하여 Ingress에 ACM 인증서를 연결하려면 다음 annotation을 추가할 수 있습니다:
  Copy

  annotations:
    alb.ingress.kubernetes.io/certificate-arn: "<your-certificate-arn>"
  

• Labels (선택사항): Ingress에 추가할 추가 label입니다.
• TLS (선택사항): HTTPS를 통해 LangSmith를 제공하려면 여기에 TLS 구성을 추가할 수 있습니다(많은 Ingress controller가 TLS를 제어하는 다른 방법을 가지고 있을 수 있으므로 이는 종종 필요하지 않습니다). 이는 TLS 구성의 배열이어야 합니다. 각 TLS 구성에는 다음 필드가 있어야 합니다:
  • hosts: 인증서가 유효해야 하는 host의 배열입니다. 예: [“langsmith.example.com”]
  • secretName: 인증서와 private key를 포함하는 Kubernetes secret의 이름입니다. 이 secret에는 다음 key가 있어야 합니다:
    • tls.crt: 인증서
    • tls.key: private key
  • TLS secret 생성에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

​

Configuration

​

Option 1: Standard Ingress

config:
  hostname: "" # Main domain for LangSmith
  basePath: "" # If you want to serve langsmith under a URL base path (e.g., /langsmith)
ingress:
  enabled: true
  hostname: "" # Deprecated: Use config.hostname instead after v0.12.0
  subdomain: "" # Deprecated: Use config.hostname instead after v0.12.0
  ingressClassName: "" # If not set, the default ingress class will be used
  annotations: {} # Add annotations here if needed
  labels: {} # Add labels here if needed
  tls: [] # Add TLS configuration here if needed
frontend:
  service:
    type: ClusterIP

kubectl get ingress

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

​

Option 2: Gateway API

​

Parameters

• name (필수): 참조할 Gateway 리소스의 이름
• namespace (필수): Gateway 리소스가 위치한 namespace
• hostname (선택사항): LangSmith 설치에 사용할 hostname입니다. 예: "langsmith.example.com"
• basePath (선택사항): LangSmith를 base path 아래에서 제공하려면 여기에 지정할 수 있습니다. 예: “example.com/langsmith”
• sectionName (선택사항): 사용할 Gateway의 특정 listener section 이름
• annotations (선택사항): HTTPRoute 리소스에 추가할 추가 annotation
• labels (선택사항): HTTPRoute 리소스에 추가할 추가 label

​

Configuration

config:
  hostname: "" # Main domain for LangSmith
  basePath: "" # If you want to serve langsmith under a base path. E.g "example.com/langsmith"
gateway:
  enabled: true
  name: "my-gateway" # Name of your Gateway resource
  namespace: "gateway-system" # Namespace of your Gateway resource
  sectionName: "" # Optional: specific listener section name
  annotations: {} # Add annotations here if needed
  labels: {} # Add labels here if needed
frontend:
  service:
    type: ClusterIP

kubectl get httproute

​

Option 3: Istio Gateway

​

Parameters

• name (선택사항): 참조할 Istio Gateway 리소스의 이름입니다. 기본값은 "istio-gateway"입니다
• namespace (선택사항): Istio Gateway 리소스가 위치한 namespace입니다. 기본값은 "istio-system"입니다
• hostname (선택사항): LangSmith 설치에 사용할 hostname입니다. 예: "langsmith.example.com"
• basePath (선택사항): LangSmith를 base path 아래에서 제공하려면 여기에 지정할 수 있습니다. 예: “example.com/langsmith”
• annotations (선택사항): VirtualService 리소스에 추가할 추가 annotation
• labels (선택사항): VirtualService 리소스에 추가할 추가 label

​

Configuration

config:
  hostname: "" # Main domain for LangSmith
  basePath: "" # If you want to serve langsmith on a separate basePath. E.g "example.com/langsmith"
istioGateway:
  enabled: true
  name: "istio-gateway" # Name of your Istio Gateway resource
  namespace: "istio-system" # Namespace of your Istio Gateway resource
  annotations: {} # Add annotations here if needed
  labels: {} # Add labels here if needed
frontend:
  service:
    type: ClusterIP

kubectl get virtualservice