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

​

요구사항

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

​

매개변수

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

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

• Labels (선택사항): Ingress에 추가할 추가 레이블입니다.
• TLS (선택사항): HTTPS를 통해 LangSmith를 제공하려면 여기에 TLS 구성을 추가할 수 있습니다 (많은 Ingress 컨트롤러가 TLS를 제어하는 다른 방법을 가지고 있어 이것이 필요하지 않을 수 있습니다). 이는 TLS 구성의 배열이어야 합니다. 각 TLS 구성에는 다음 필드가 있어야 합니다:
  • hosts: 인증서가 유효해야 하는 호스트의 배열입니다. 예: [“langsmith.example.com”]
  • secretName: 인증서와 개인 키를 포함하는 Kubernetes 시크릿의 이름입니다. 이 시크릿에는 다음 키가 있어야 합니다:
    • tls.crt: 인증서
    • tls.key: 개인 키
  • TLS 시크릿 생성에 대한 자세한 내용은 여기에서 확인할 수 있습니다.

​

구성

​

옵션 1: 표준 Ingress

config:
  hostname: "" # LangSmith의 주요 도메인
  basePath: "" # URL base path 아래에서 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 (선택사항): base path 아래에서 LangSmith를 제공하려면 여기에 지정할 수 있습니다. 예: “example.com/langsmith”
• sectionName (선택사항): 사용할 Gateway의 특정 리스너 섹션 이름
• annotations (선택사항): HTTPRoute 리소스에 추가할 추가 어노테이션
• labels (선택사항): HTTPRoute 리소스에 추가할 추가 레이블

​

구성

config:
  hostname: "" # LangSmith의 주요 도메인
  basePath: "" # base path 아래에서 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 (선택사항): base path 아래에서 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