Skip to main content
이 가이드에서는 자체 호스팅된 LangSmith 인스턴스에서 배포 관리 기능을 활성화하는 방법을 안내합니다. 이를 통해 컨트롤 플레인과 데이터 플레인이 추가되어 LangSmith UI를 통해 에이전트와 애플리케이션을 직접 배포, 확장 및 관리할 수 있습니다.
중요
배포 기능을 포함한 LangSmith 자체 호스팅은 Enterprise 플랜이 필요합니다.
이 설정 페이지는 기존 LangSmith 인스턴스에 배포 기능을 추가하기 위한 것입니다.자체 호스팅 옵션을 검토하여 다음 내용을 이해하시기 바랍니다:

​
개요

이 가이드는 Kubernetes 설치 가이드를 기반으로 합니다. 계속 진행하기 전에 먼저 해당 가이드를 완료해야 합니다. 이 페이지에서는 배포 기능을 활성화하는 데 필요한 추가 설정 단계를 다룹니다:
  • LangGraph 운영자 설치
  • 인그레스 구성
  • 컨트롤 플레인 연결

​
사전 요구사항

  1. Kubernetes를 사용하고 있어야 합니다.
  2. 자체 호스팅 LangSmith 인스턴스가 실행 중이어야 합니다.
  3. LangGraph CLI를 사용하여 애플리케이션을 로컬에서 테스트합니다.
  4. LangGraph CLI를 사용하여 Docker 이미지를 빌드(예: langgraph build)하고 Kubernetes 클러스터가 액세스할 수 있는 레지스트리에 푸시합니다.
  5. 클러스터에 KEDA가 설치되어 있어야 합니다.
  helm repo add kedacore https://kedacore.github.io/charts
  helm install keda kedacore/keda --namespace keda --create-namespace
  1. 인그레스 구성
    1. LangSmith 인스턴스에 대해 인그레스, 게이트웨이를 설정하거나 Istio를 사용해야 합니다. 모든 에이전트는 이 인그레스 뒤의 Kubernetes 서비스로 배포됩니다. 인스턴스에 대한 인그레스 설정 가이드를 참조하세요.
  2. 여러 배포를 위한 충분한 여유 공간이 클러스터에 있어야 합니다. 새 노드를 자동으로 프로비저닝하기 위해 Cluster-Autoscaler를 사용하는 것이 권장됩니다.
  3. 클러스터에서 유효한 동적 PV 프로비저너 또는 사용 가능한 PV가 있어야 합니다. 다음 명령으로 확인할 수 있습니다:
  kubectl get storageclass
  1. 네트워크에서 https://beacon.langchain.com으로의 이그레스가 필요합니다. 에어갭 모드로 실행하지 않는 경우 라이선스 검증 및 사용량 보고를 위해 필요합니다. 자세한 내용은 이그레스 문서를 참조하세요.

​
설정

  1. 자체 호스팅 LangSmith 인스턴스 구성의 일부로 deployment 옵션을 활성화합니다. 이렇게 하면 몇 가지 주요 리소스가 프로비저닝됩니다.
    1. listener: 컨트롤 플레인에서 배포 변경 사항을 수신하고 다운스트림 CRD를 생성/업데이트하는 서비스입니다.
    2. LangGraphPlatform CRD: LangSmith 배포를 위한 CRD입니다. LangSmith 배포 인스턴스 관리를 위한 사양이 포함되어 있습니다.
    3. operator: LangSmith CRD에 대한 변경 사항을 처리하는 운영자입니다.
    4. host-backend: 컨트롤 플레인입니다.
v0.12.0부터 langgraphPlatform 옵션은 더 이상 사용되지 않습니다. v0.12.0 이후 버전에서는 config.deployment를 사용하세요.
  1. 차트에서 두 개의 추가 이미지가 사용됩니다. 최신 릴리스에 지정된 이미지를 사용하세요.
  hostBackendImage:
    repository: "docker.io/langchain/hosted-langserve-backend"
    pullPolicy: IfNotPresent
  operatorImage:
    repository: "docker.io/langchain/langgraph-operator"
    pullPolicy: IfNotPresent
  1. langsmith 구성 파일(보통 langsmith_config.yaml)에서 deployment 옵션을 활성화합니다. 유효한 인그레스 설정도 있어야 합니다:
  config:
    deployment:
      enabled: true
    # v0.12.0부터 이 섹션은 더 이상 사용되지 않습니다. v0.12.0 이후 버전에서는 config.deployment를 사용하세요.
    langgraphPlatform:
      enabled: true
      langgraphPlatformLicenseKey: "YOUR_LANGGRAPH_PLATFORM_LICENSE_KEY"
  1. values.yaml 파일에서 hostBackendImage 및 operatorImage 옵션을 구성합니다(이미지를 미러링해야 하는 경우).
  2. 여기에서 기본 템플릿을 재정의하여 에이전트에 대한 기본 템플릿을 구성할 수도 있습니다.
  3. 컨트롤 플레인 UI에서 배포를 생성합니다.
Edit the source of this page on GitHub.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.
⌘I