Creating a Deployment

1 LangGraph Platform 部署概述

LangGraph Platform 是 LangChain 提供的用于将 LangGraph 应用部署为生产级服务的平台。它提供了 REST API 接口、持久化存储、流式输出支持，以及对话线程管理等能力。

本节以 Module 5 构建的 task_mAIstro 应用为例，展示如何将一个本地图代码打包并部署为可供外部访问的服务。

2 4 个必要文件详解

要创建一个 LangGraph Platform 部署，需要在 module-6/deployment/ 目录下准备以下 4 个文件：

langgraph.json 配置示例

// langgraph.json — 声明图的路径和 Python 版本
{
  "graphs": {
    "task_maistro": "./task_maistro.py:graph"
  },
  "python_version": "3.11",
  "dependencies": ["."]
}

格式为 "图名称": "文件路径:图变量名"。部署后，图名称成为 API 端点路径的一部分。

requirements.txt 示例

langgraph
langchain-deepseek
trustcall
langchain-core
python-dotenv

3 LangGraph CLI：构建 Docker 镜像

LangGraph CLI 是 LangChain 提供的命令行工具，用于将图代码打包为 Docker 镜像（即 LangGraph Server 容器）。

安装 CLI

pip install -U langgraph-cli

构建 Docker 镜像

# 进入部署目录
cd module-6/deployment

# 构建 Docker 镜像，-t 指定镜像名称
langgraph build -t my-image

langgraph build 会读取当前目录下的 langgraph.json，自动：

1. 下载适配 LangGraph Server 的基础镜像
2. 安装 requirements.txt 中的所有依赖
3. 将图代码复制进镜像
4. 构建最终的可运行 Docker 镜像

4 Redis 与 PostgreSQL：基础设施配置

LangGraph Server 依赖两个外部服务作为基础设施：

独立运行 LangGraph Server 容器（已有 Redis/PostgreSQL）

# 如果 Redis 和 PostgreSQL 已在别处运行，直接启动 API 容器
docker run \
    --env-file .env \
    -p 8123:8000 \
    -e REDIS_URI="redis://localhost:6379" \
    -e DATABASE_URI="postgresql://user:pass@localhost/langgraph" \
    -e LANGSMITH_API_KEY="lsv2_..." \
    my-image

启动后，LangGraph Server 默认监听容器内的 8000 端口，通过 -p 8123:8000 映射到主机 8123 端口。

5 docker-compose.yml：三服务编排

如果没有独立的 Redis/PostgreSQL，可以用 docker-compose.yml 一键启动全部三个服务：

# docker-compose.yml 中定义的三个服务

services:
  langgraph-redis:
    image: redis:6          # 使用官方 Redis 镜像
    ports: ["6379:6379"]

  langgraph-postgres:
    image: postgres:16      # 使用官方 PostgreSQL 镜像
    environment:
      POSTGRES_DB: langgraph
      POSTGRES_USER: langgraph
      POSTGRES_PASSWORD: langgraph
    ports: ["5433:5432"]

  langgraph-api:
    image: ${IMAGE_NAME}    # 使用 langgraph build 构建的镜像
    ports: ["8123:8000"]
    depends_on:
      langgraph-redis:    { condition: service_healthy }
      langgraph-postgres: { condition: service_healthy }
    env_file: .env          # 从 .env 文件读取 API 密钥等环境变量

启动步骤

1. 复制 docker-compose-example.yml 为 docker-compose.yml
2. 在 .env 文件中填入 IMAGE_NAME、LANGSMITH_API_KEY、DEEPSEEK_API_KEY
3. 运行以下命令启动全部服务：

cd module-6/deployment
docker compose up

6 自托管 vs LangGraph Cloud 对比