Andrew NguonlyandGitHub
3878addbe0
### 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.
4.1 KiB
Deployment Options
!!! info "Prerequisites"
- [LangGraph Platform](./langgraph_platform.md)
- [LangGraph Server](./langgraph_server.md)
- [LangGraph Platform Plans](./plans.md)
Overview
There are 4 main options for deploying with the LangGraph Platform:
-
Cloud SaaS: Available for Plus and Enterprise plans.
-
Self-Hosted Data Plane: Available for the Enterprise plan.
-
Self-Hosted Control Plane: Available for the Enterprise plan.
-
Standalone Container: Available for all plans.
Please see the LangGraph Platform Plans for more information on the different plans.
The guide below will explain the differences between the deployment options.
Cloud SaaS
The Cloud SaaS deployment option is a fully managed model for deployment where we manage the control plane and data plane in our cloud. This option provides a simple way to deploy and manage your LangGraph Servers.
Connect your GitHub repositories to the platform and deploy your LangGraph Servers from the Control Plane UI. The build process (i.e. CI/CD) is managed internally by the platform.
For more information, please see:
Self-Hosted Data Plane
The Self-Hosted Data Plane deployment option is a "hybrid" model for deployemnt where we manage the control plane in our cloud and you manage the data plane in your cloud. This option provides a way to securely manage your data plane infrastructure, while offloading control plane management to us.
Build a Docker image using the LangGraph CLI and deploy your LangGraph Server from the Control Plane UI.
Supported Compute Platforms: Kubernetes, Amazon ECS (coming soon!)
For more information, please see:
Self-Hosted Control Plane
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 give you full control and responsibility of the control plane and data plane infrastructure.
Build a Docker image using the LangGraph CLI and deploy your LangGraph Server from the Control Plane UI.
Supported Compute Platforms: Kubernetes
For more information, please see:
Standalone Container
The Standalone Container deployment option is the least restrictive model for deployment. Deploy standalone instances of a LangGraph Server in your cloud.
Build a Docker image using the LangGraph CLI and deploy your LangGraph Server using the container deployment tooling of your choice. Images can be deployed to any compute platform.
For more information, please see:
Related
For more information, please see: