컨트롤 플레인 UI
컨트롤 플레인 UI에서 다음을 수행할 수 있습니다:- 대기 중인 배포 목록을 조회합니다.
- 개별 배포의 세부 정보를 조회합니다.
- 새 배포를 생성합니다.
- 배포를 업데이트합니다.
- 배포의 환경 변수를 업데이트합니다.
- 배포의 빌드 및 서버 로그를 조회합니다.
- CPU 및 메모리 사용량과 같은 배포 메트릭을 조회합니다.
- 배포를 삭제합니다.
컨트롤 플레인 API
이 섹션에서는 컨트롤 플레인 API의 데이터 모델을 설명합니다. 이 API는 배포를 생성, 업데이트 및 삭제하는 데 사용됩니다. 자세한 내용은 컨트롤 플레인 API 레퍼런스를 참조하세요.통합
통합은git 저장소 프로바이더(예: GitHub)에 대한 추상화입니다. git 저장소에 연결하고 배포하는 데 필요한 모든 메타데이터를 포함합니다.
배포
배포는 LangGraph Server의 인스턴스입니다. 하나의 배포는 여러 개의 리비전을 가질 수 있습니다.리비전
리비전은 배포의 반복입니다. 새 배포가 생성되면 초기 리비전이 자동으로 생성됩니다. 배포의 코드 변경 사항을 배포하거나 시크릿을 업데이트하려면 새 리비전을 생성해야 합니다.리스너
리스너는 “리스너” 애플리케이션의 인스턴스입니다. 리스너는 애플리케이션에 대한 메타데이터(예: 버전)와 배포할 수 있는 컴퓨팅 인프라에 대한 메타데이터(예: Kubernetes 네임스페이스)를 포함합니다. 리스너 데이터 모델은 Hybrid 및 Self-Hosted 배포에만 적용됩니다.컨트롤 플레인 기능
이 섹션에서는 컨트롤 플레인의 다양한 기능을 설명합니다.배포 타입
컨트롤 플레인은 간편성을 위해 서로 다른 리소스 할당을 가진 두 가지 배포 타입Development와 Production을 제공합니다.
| 배포 타입 | CPU/메모리 | 스케일링 | 데이터베이스 |
|---|---|---|---|
| Development | 1 CPU, 1 GB RAM | 최대 1개의 복제본 | 10 GB 디스크, 백업 없음 |
| Production | 2 CPU, 2 GB RAM | 최대 10개의 복제본 | 자동 스케일링 디스크, 자동 백업, 고가용성(다중 영역 구성) |
변경 불가능한 배포 타입
배포가 생성되면 배포 타입을 변경할 수 없습니다.
Self-Hosted 배포
Hybrid 및 Self-Hosted 배포의 리소스는 완전히 사용자 정의할 수 있습니다. 배포 타입은 Cloud 배포에만 적용됩니다.
Production
Production 타입 배포는 “프로덕션” 워크로드에 적합합니다. 예를 들어, 중요한 경로에 있는 고객 대면 애플리케이션에는 Production을 선택하세요.
Production 타입 배포의 리소스는 사용 사례와 용량 제약에 따라 개별적으로 수동 증가할 수 있습니다. 리소스 증가를 요청하려면 [email protected]에 문의하세요.
Development
Development 타입 배포는 개발 및 테스트에 적합합니다. 예를 들어, 내부 테스트 환경에는 Development를 선택하세요. Development 타입 배포는 “프로덕션” 워크로드에 적합하지 않습니다.
선점형 컴퓨팅 인프라
Development 타입 배포(API 서버, 큐 서버, 데이터베이스)는 선점형 컴퓨팅 인프라에 프로비저닝됩니다. 즉, 컴퓨팅 인프라가 사전 통지 없이 언제든지 종료될 수 있습니다. 이로 인해 다음과 같은 간헐적 문제가 발생할 수 있습니다:- Redis 연결 타임아웃/오류
- Postgres 연결 타임아웃/오류
- 실패하거나 재시도 중인 백그라운드 실행
Development 타입 배포를 프로비저닝하는 비용을 크게 절감합니다. LangGraph Server는 설계상 장애 허용 방식입니다. 구현은 Redis/Postgres 연결 오류로부터 자동으로 복구를 시도하고 실패한 백그라운드 실행을 재시도합니다.Production 타입 배포는 선점형 컴퓨팅 인프라가 아닌 영구 컴퓨팅 인프라에 프로비저닝됩니다.Development 타입 배포의 데이터베이스 디스크 크기는 사용 사례와 용량 제약에 따라 개별적으로 수동 증가할 수 있습니다. 대부분의 사용 사례에서는 디스크 사용량을 관리하기 위해 TTL을 구성해야 합니다. 리소스 증가를 요청하려면 [email protected]에 문의하세요.
데이터베이스 프로비저닝
컨트롤 플레인과 데이터 플레인 “리스너” 애플리케이션이 협력하여 각 배포에 대한 Postgres 데이터베이스를 자동으로 생성합니다. 데이터베이스는 배포의 영속성 계층으로 작동합니다. LangGraph 애플리케이션을 구현할 때 개발자가 체크포인터를 구성할 필요가 없습니다. 대신, 그래프에 대해 체크포인터가 자동으로 구성됩니다. 그래프에 구성된 모든 체크포인터는 자동으로 구성되는 체크포인터로 대체됩니다. 데이터베이스에 대한 직접 액세스는 없습니다. 데이터베이스에 대한 모든 액세스는 LangGraph Server를 통해 이루어집니다. 데이터베이스는 배포 자체가 삭제될 때까지 절대 삭제되지 않습니다.Hybrid 및 Self-Hosted 배포에서는 사용자 정의 Postgres 인스턴스를 구성할 수 있습니다.
비동기 배포
배포와 리비전을 위한 인프라는 비동기적으로 프로비저닝되고 배포됩니다. 제출 직후에는 즉시 배포되지 않습니다. 현재 배포는 최대 몇 분 정도 걸릴 수 있습니다.- 새 배포가 생성되면 배포를 위한 새 데이터베이스가 생성됩니다. 데이터베이스 생성은 일회성 단계입니다. 이 단계로 인해 배포의 초기 리비전은 더 긴 배포 시간이 소요됩니다.
- 배포에 대한 후속 리비전이 생성되면 데이터베이스 생성 단계가 없습니다. 후속 리비전의 배포 시간은 초기 리비전의 배포 시간에 비해 훨씬 빠릅니다.
- 각 리비전의 배포 프로세스에는 빌드 단계가 포함되며, 이는 최대 몇 분 정도 걸릴 수 있습니다.
모니터링
배포가 준비되면 컨트롤 플레인은 배포를 모니터링하고 다음과 같은 다양한 메트릭을 기록합니다:- 배포의 CPU 및 메모리 사용량.
- 컨테이너 재시작 횟수.
- 복제본 수(자동 스케일링으로 증가함).
- PostgreSQL CPU, 메모리 사용량 및 디스크 사용량.
- LangGraph Server 큐 대기 중/활성 실행 수.
- LangGraph Server API 성공 응답 수, 오류 응답 수 및 지연 시간.
LangSmith 통합
각 배포에 대해 LangSmith 추적 프로젝트가 자동으로 생성됩니다. 추적 프로젝트는 배포와 동일한 이름을 갖습니다. 배포를 생성할 때LANGCHAIN_TRACING 및 LANGSMITH_API_KEY/LANGCHAIN_API_KEY 환경 변수를 지정할 필요가 없으며, 컨트롤 플레인에 의해 자동으로 설정됩니다.
배포가 삭제되어도 추적과 추적 프로젝트는 삭제되지 않습니다.
Connect these docs programmatically to Claude, VSCode, and more via MCP for real-time answers.