Skip to content

如何部署到LangGraph云端

LangGraph云端可在LangSmith中使用。要部署LangGraph云端API，请导航到LangSmith用户界面。

先决条件

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

创建新部署

从LangSmith UI开始...

  1. 在左侧导航面板中，选择LangGraph 平台。LangGraph 平台视图包含现有 LangGraph Cloud 部署的列表。
  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. 如果选中，部署将通过 LangGraph Studio 向任何 LangSmith 用户开放。将为部署提供直接链接到 LangGraph Studio，以便与其他 LangSmith 用户共享。
    4. 指定环境变量和机密。参见环境变量参考以配置部署的其他变量。
      1. 敏感值，如 API 密钥（例如OPENAI_API_KEY）应作为机密指定。
      2. 还可以指定其他非机密环境变量。
  4. 在右上角，选择提交。几秒钟后，部署视图将出现，并且新部署将排队以进行配置。

创建新修订

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

从LangSmith UI开始...

  1. 在左侧导航面板中，选择LangGraph 平台。LangGraph 平台视图包含现有 LangGraph Cloud 部署的列表。
  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 UI开始...

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

部署设置

从 LangGraph 平台 视图开始...

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

白名单IP地址

2025年1月6日之后创建的所有LangGraph Platform部署的流量都将通过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