如何部署独立容器¶

在部署之前，请查阅独立容器部署选项的概念指南。

先决条件¶

1. 使用 LangGraph CLI 在本地测试您的应用程序。
2. 使用 LangGraph CLI 构建 Docker 镜像（例如 langgraph build）。

3. 独立容器部署需要以下环境变量。

   1. 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> 是共享的。不同的部署不能使用相同的数据库编号。

   2. 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> 是共享的。不同的部署不能使用相同的数据库。

   3. LANGSMITH_API_KEY：（如果使用 Lite）LangSmith API 密钥。此密钥将在服务器启动时进行一次身份验证。

   4. LANGGRAPH_CLOUD_LICENSE_KEY：（如果使用 Enterprise）LangGraph 平台许可证密钥。此密钥将在服务器启动时进行一次身份验证。
   5. LANGSMITH_ENDPOINT：要将跟踪发送到 自托管的 LangSmith 实例，请将 LANGSMITH_ENDPOINT 设置为该自托管 LangSmith 实例的主机名。

Kubernetes (Helm)¶

使用此 Helm Chart 将 LangGraph 服务器部署到 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

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 服务器（如果您想更改此端口，可以通过更改 langgraph-api 卷中的端口来实现）。您可以通过运行以下命令来测试应用程序是否健康：

curl --request GET --url 0.0.0.0:8123/ok

{"ok":true}