mirror of https://github.com/langchain-ai/langgraph.git synced 2026-08-30 03:39:38 +02:00

Files

T

Andrew NguonlyandGitHub 3878addbe0 docs: Refactor content for new LangGraph Platform deployment options (#4118 )

### Summary
This is a large refactor of the content for the LangGraph Platform
deployment options. Although there are a lot of changes, I do feel
fairly confident that this is safe to merge and won't have any negative
impact related to confusion around deployment options. However, please
review thoroughly (i.e. run the docs locally).

### Goals and Non-Goals
Just wanted to explicitly state goals and non-goals so that we're clear
about what needs to be done now versus what can be done in a smaller
follow-up PR.

Goals
1. Add new content for the new deployment options (Self-Hosted Data
Plane, Self-Hosted Control Plane).
1. Hide old content for deprecated deployment options (BYOC).
1. Create a pair of "conceptual" and "how-to" pages for each deployment
option. As much as possible, the pages should have consistent headings.
1. Introduce the terms "control plane" and "data plane" and define them
plainly without hiding/abstracting information.

Non-Goals
1. Do not change the navigation of the existing deployment options. As
much as possible, update content in-place or add new pages. Changing the
navigation is a bigger task that can be done later.
1. Do not remove old content for deprecated deployment options. We may
need to refer to this later. There are only ~2 pages (I think).

### Next Steps
1. Update the architecture diagrams for each deployment option. Commit
Excalidraw file to source control.
1. Create a "how-to" page for the Control Plane UI. This page pertains
to 3/4 deployment options. Most of the content lives in the "how-to"
page for Cloud SaaS deployment.
1. Document required RBAC permissions for K8s for Self-Hosted Data Plane
and Self-Hosted Control Plane (and update links).
1. Figure out how to consolidate plan information.
1. Figure out where to document licensing, telemetry, custom
Postgres/Redis.
1. Update autoscaling content.

2025-04-02 06:51:14 -07:00

1.4 KiB

Raw Blame History

Self-Hosted Control Plane

To deploy a LangGraph Server, follow the how-to guide for how to deploy the Self-Hosted Control Plane.

Overview

The Self-Hosted Control Plane deployment option is a fully self-hosted model for deployment where you manage the control plane and data plane in your cloud (this option implies that the data plane is self-hosted).

	Control Plane	Data Plane
What is it?	Control Plane UI for creating deployments and revisions Control Plane APIs for creating deployments and revisions	Data plane "listener" for reconciling deployments with control plane state LangGraph Servers Postgres, Redis, etc
Where is it hosted?	Your cloud	Your cloud
Who provisions and manages it?	You	You

Architecture

Compute Platforms

Kubernetes

The Self-Hosted Control Plane deployment option supports deploying control plane and data plane infrastructure to any Kubernetes cluster.

1.4 KiB Raw Blame History