如何部署独立容器¶

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

先决条件¶

1. 使用 LangGraph CLI 在本地测试你的应用。
2. 使用 LangGraph CLI 构建一个 Docker 镜像（即 langgraph build）。

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

   1. REDIS_URI: 连接到 Redis 实例的连接信息。Redis 将作为发布-订阅代理，用于从后台运行中实时流式传输输出。REDIS_URI 的值必须是一个有效的 Redis 连接 URI。

      共享的 Redis 实例

      多个自托管部署可以共享同一个 Redis 实例。例如，对于 Deployment A，REDIS_URI 可以设置为 redis://<hostname_1>:<port>/1，而对于 Deployment B，REDIS_URI 可以设置为 redis://<hostname_1>:<port>/2。

      1 和 2 是同一实例中的不同数据库编号，但 <hostname_1> 是共享的。不能为不同的部署使用相同的数据库编号。

   2. DATABASE_URI: Postgres 连接信息。Postgres 将用于存储助手、线程、运行、持久化线程状态和长期记忆，并使用 'exactly once' 语义管理后台任务队列的状态。DATABASE_URI 的值必须是一个有效的 Postgres 连接 URI。

      共享的 Postgres 实例

      多个自托管部署可以共享同一个 Postgres 实例。例如，对于 Deployment A，DATABASE_URI 可以设置为 postgres://<user>:<password>@/<database_name_1>?host=<hostname_1>，而对于 Deployment 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 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

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}