如何部署独立容器¶
在部署之前，请查阅独立容器部署选项的概念指南。
先决条件¶
- 使用LangGraph CLI在本地测试您的应用。
- 使用LangGraph CLI构建 Docker 镜像（例如
langgraph build）。 -
独立容器部署需要以下环境变量。
-
REDIS_URI: Redis 实例的连接详情。Redis 将用作发布/订阅代理，以实现从后台运行流式传输实时输出。REDIS_URI的值必须是有效的Redis 连接 URI。共享 Redis 实例
多个自托管部署可以共享同一个 Redis 实例。例如，对于
部署 A，REDIS_URI可以设置为redis://<hostname_1>:<port>/1；对于部署 B，REDIS_URI可以设置为redis://<hostname_1>:<port>/2。1和2是同一实例中不同的数据库编号，但<hostname_1>是共享的。不同的部署不能使用相同的数据库编号。 -
DATABASE_URI: Postgres 连接详情。Postgres 将用于存储助手、线程、运行、持久化线程状态和长期记忆，以及以“恰好一次”语义管理后台任务队列的状态。DATABASE_URI的值必须是有效的Postgres 连接 URI。共享 Postgres 实例
多个自托管部署可以共享同一个 Postgres 实例。例如，对于
部署 A，DATABASE_URI可以设置为postgres://<user>:<password>@/<database_name_1>?host=<hostname_1>；对于部署 B，DATABASE_URI可以设置为postgres://<user>:<password>@/<database_name_2>?host=<hostname_1>。<database_name_1>和database_name_2是同一实例中不同的数据库，但<hostname_1>是共享的。不同的部署不能使用相同的数据库。 -
LANGSMITH_API_KEY：（如果使用Lite）LangSmith API 密钥。这将在服务器启动时用于一次性认证。 LANGGRAPH_CLOUD_LICENSE_KEY：（如果使用Enterprise）LangGraph 平台许可证密钥。这将在服务器启动时用于一次性认证。LANGSMITH_ENDPOINT：要将跟踪发送到自托管的 LangSmith 实例，请将LANGSMITH_ENDPOINT设置为自托管 LangSmith 实例的主机名。
-
Kubernetes (Helm)¶
使用此Helm chart将 LangGraph Server 部署到 Kubernetes 集群。
Docker¶
运行以下 docker 命令
docker run \
--env-file .env \
-p 8123:8000 \
-e REDIS_URI="foo" \
-e DATABASE_URI="bar" \
-e LANGSMITH_API_KEY="baz" \
my-image
注意
- 您需要将
my-image替换为您在先决条件步骤中构建的镜像名称（通过langgraph build），并且应为REDIS_URI、DATABASE_URI和LANGSMITH_API_KEY提供适当的值。 - 如果您的应用程序需要其他环境变量，您可以用类似的方式传递它们。
Docker Compose¶
Docker Compose YAML 文件
volumes:
langgraph-data:
driver: local
services:
langgraph-redis:
image: redis:6
healthcheck:
test: redis-cli ping
interval: 5s
timeout: 1s
retries: 5
langgraph-postgres:
image: postgres:16
ports:
- "5433:5432"
environment:
POSTGRES_DB: postgres
POSTGRES_USER: postgres
POSTGRES_PASSWORD: postgres
volumes:
- langgraph-data:/var/lib/postgresql/data
healthcheck:
test: pg_isready -U postgres
start_period: 10s
timeout: 1s
retries: 5
interval: 5s
langgraph-api:
image: ${IMAGE_NAME}
ports:
- "8123:8000"
depends_on:
langgraph-redis:
condition: service_healthy
langgraph-postgres:
condition: service_healthy
env_file:
- .env
environment:
REDIS_URI: redis://langgraph-redis:6379
LANGSMITH_API_KEY: ${LANGSMITH_API_KEY}
POSTGRES_URI: postgres://postgres:postgres@langgraph-postgres:5432/postgres?sslmode=disable
您可以在同一文件夹中，使用此 Docker Compose 文件运行命令 docker compose up。
这将在端口 8123 上启动 LangGraph Server（如果您想更改，可以通过更改 langgraph-api 卷中的端口来更改）。您可以通过运行以下命令来测试应用程序是否健康：