Skip to content

如何部署到云 SaaS

在部署之前，请查看 云 SaaS 概念指南 部署选项。

前提条件

  1. LangGraph Cloud 应用程序从 GitHub 仓库部署。若要将 LangGraph Cloud 应用程序部署到 LangGraph Cloud，需对其进行配置并上传到 GitHub 仓库。
  2. 验证 LangGraph API 是否能在本地运行。如果 API 无法成功运行（即 langgraph dev 命令执行失败），那么部署到 LangGraph Cloud 也会失败。

创建新部署

从 LangSmith 用户界面 开始……

  1. 在左侧导航面板中，选择 LangGraph 平台。LangGraph 平台 视图包含现有 LangGraph 云部署的列表。
  2. 在右上角，选择 + 新建部署 以创建新的部署。
  3. 在 创建新部署 面板中，填写所需字段。
    1. 部署详情
      1. 选择 从 GitHub 导入，并按照 GitHub OAuth 工作流程安装并授权 LangChain 的 hosted-langserve GitHub 应用访问所选仓库。安装完成后，返回 创建新部署 面板，从下拉菜单中选择要部署的 GitHub 仓库。注意：安装 LangChain 的 hosted-langserve GitHub 应用的 GitHub 用户必须是组织或账户的 所有者。
      2. 为部署指定一个名称。
      3. 指定所需的 Git 分支。一个部署与一个分支相关联。当创建新的修订版本时，将部署关联分支的代码。该分支可以在 部署设置 中稍后更新。
      4. 指定 LangGraph API 配置文件 的完整路径，包括文件名。例如，如果 langgraph.json 文件位于仓库的根目录中，只需指定 langgraph.json。
      5. 勾选/取消勾选 推送到分支时自动更新部署 复选框。如果勾选，当更改推送到指定的 Git 分支 时，部署将自动更新。此设置可以在 部署设置 中稍后启用/禁用。
    2. 选择所需的 部署类型。
      1. 开发 部署适用于非生产用例，并使用最少的资源进行配置。
      2. 生产 部署每秒最多可处理 500 个请求，并使用具有自动备份功能的高可用存储进行配置。
    3. 确定部署是否应 可通过 LangGraph Studio 共享。
      1. 如果未勾选，只有使用工作区的有效 LangSmith API 密钥才能访问该部署。
      2. 如果勾选，任何 LangSmith 用户都可以通过 LangGraph Studio 访问该部署。将提供一个指向该部署的 LangGraph Studio 的直接 URL，以便与其他 LangSmith 用户共享。
    4. 指定 环境变量 和机密信息。请参阅 环境变量参考 以配置部署的其他变量。
      1. 敏感值（如 API 密钥，例如 OPENAI_API_KEY）应指定为机密信息。
      2. 也可以指定其他非机密环境变量。
    5. 会自动创建一个与部署同名的新 LangSmith 跟踪项目。
  4. 在右上角，选择 提交。几秒钟后，将显示 部署 视图，新部署将排队等待配置。

创建新修订版本

在创建新部署时，默认会创建一个新的修订版本。后续可以创建新的修订版本来部署新的代码更改。

从 LangSmith 用户界面 开始操作……

  1. 在左侧导航面板中，选择 LangGraph 平台。LangGraph 平台 视图包含现有 LangGraph 云部署的列表。
  2. 选择一个现有的部署以创建新的修订版本。
  3. 在 部署 视图的右上角，选择 + 新修订版本。
  4. 在 新修订版本 模态框中，填写必填字段。
    1. 指定 LangGraph API 配置文件 的完整路径，包括文件名。例如，如果 langgraph.json 文件位于仓库的根目录中，只需指定 langgraph.json。
    2. 确定该部署是否应 可通过 LangGraph Studio 共享。
      1. 如果未勾选，该部署仅可使用工作区的有效 LangSmith API 密钥进行访问。
      2. 如果勾选，任何 LangSmith 用户都可以通过 LangGraph Studio 访问该部署。将提供该部署的 LangGraph Studio 直接 URL，以便与其他 LangSmith 用户共享。
    3. 指定 环境变量 和机密信息。现有的机密信息和环境变量会预先填充。请参阅 环境变量参考 为修订版本配置其他变量。
      1. 添加新的机密信息或环境变量。
      2. 删除现有的机密信息或环境变量。
      3. 更新现有的机密信息或环境变量的值。
  5. 选择 提交。几秒钟后，新修订版本 模态框将关闭，新的修订版本将排队等待部署。

查看构建和服务器日志

每个版本都提供构建和服务器日志。

从 LangGraph 平台 视图开始……

  1. 从 版本 表中选择所需的版本。一个面板会从右侧滑出，默认会选中 构建 选项卡，该选项卡会显示该版本的构建日志。
  2. 在面板中，选择 服务器 选项卡以查看该版本的服务器日志。服务器日志仅在版本部署后可用。
  3. 在 服务器 选项卡内，根据需要调整日期/时间范围选择器。默认情况下，日期/时间范围选择器设置为 最近 7 天。

中断版本部署

中断某个版本的部署将停止该版本的部署进程。

未定义行为

被中断的版本具有未定义行为。仅当你需要部署新版本，且已有一个版本的部署“卡住”时，此功能才有用。未来，此功能可能会被移除。

从 LangGraph 平台 视图开始……

  1. 在 版本 表中，选择所需版本所在行右侧的菜单图标（三个点）。
  2. 从菜单中选择 中断。
  3. 会弹出一个模态框。查看确认消息，然后选择 中断版本部署。

删除部署

从 LangSmith 用户界面 开始……

  1. 在左侧导航面板中，选择 LangGraph 平台。LangGraph 平台 视图包含现有 LangGraph 云部署的列表。
  2. 选择所需部署所在行右侧的菜单图标（三个点），然后选择 删除。
  3. 会出现一个 确认 模态框。选择 删除。

部署设置

从 LangGraph 平台 视图开始……

  1. 在右上角，选择齿轮图标（部署设置）。
  2. 将 Git 分支 更新为所需的分支。
  3. 勾选/取消勾选 推送到分支时自动更新部署 复选框。
    1. 分支创建/删除和标签创建/删除事件不会触发更新。只有推送到现有分支才会触发更新。
    2. 快速连续推送到一个分支不会触发后续更新。未来，此功能可能会更改/改进。

添加或移除 GitHub 仓库

安装并授权 LangChain 的 hosted-langserve GitHub 应用后，可以修改该应用的仓库访问权限，以添加新仓库或移除现有仓库。如果创建了新仓库，可能需要显式添加。

  1. 从 GitHub 个人资料页面，导航至 设置 > 应用程序 > hosted-langserve > 点击 配置。
  2. 在 仓库访问权限 下，选择 所有仓库 或 仅选定的仓库。如果选择了 仅选定的仓库，则必须显式添加新仓库。
  3. 点击 保存。
  4. 创建新部署时，下拉菜单中的 GitHub 仓库列表将更新，以反映仓库访问权限的更改。

对 IP 地址进行白名单设置

2025 年 1 月 6 日之后创建的所有 LangGraph 平台 部署的流量都将通过 NAT 网关传输。 此 NAT 网关将有多个静态 IP 地址，具体取决于你部署所在的区域。请参考下表列出的需要加入白名单的 IP 地址：

美国 欧盟
35.197.29.146 34.13.192.67
34.145.102.123 34.147.105.64
34.169.45.153 34.90.22.166
34.82.222.17 34.147.36.213
35.227.171.135 34.32.137.113
34.169.88.30 34.91.238.184
34.19.93.202 35.204.101.241
34.19.34.50 35.204.48.32

Comments