跳转至

如何部署到 Cloud SaaS

在部署之前,请查看 Cloud SaaS 部署选项的概念指南。

先决条件

  1. LangGraph Platform 应用程序从 GitHub 存储库部署。配置 LangGraph Platform 应用程序并将其上传到 GitHub 存储库,以便将其部署到 LangGraph Platform。
  2. 验证 LangGraph API 在本地运行。如果 API 未成功运行(即 langgraph dev),部署到 LangGraph Platform 也将失败。

创建新部署

从 LangSmith UI 开始...

  1. 在左侧导航面板中,选择 LangGraph Platform。LangGraph Platform 视图包含现有 LangGraph Platform 部署的列表。
  2. 在右上角,选择 + New Deployment 以创建新部署。
  3. 在 Create New Deployment 面板中,填写必填字段。
    1. Deployment details
      1. 选择 Import from GitHub 并按照 GitHub OAuth 工作流安装并授权 LangChain 的 hosted-langserve GitHub 应用程序访问所选存储库。安装完成后,返回 Create New Deployment 面板,然后从下拉菜单中选择要部署的 GitHub 存储库。注意:安装 LangChain 的 hosted-langserve GitHub 应用程序的 GitHub 用户必须是组织或帐户的所有者。
      2. 为部署指定名称。
      3. 指定所需的 Git Branch。部署链接到分支。创建新修订版本时,将部署链接分支的代码。可以稍后在部署设置中更新分支。
      4. 指定 LangGraph API 配置文件的完整路径,包括文件名。例如,如果文件 langgraph.json 位于存储库的根目录中,只需指定 langgraph.json。
      5. 选中/取消选中复选框以 Automatically update deployment on push to branch。如果选中,当更改推送到指定的 Git Branch 时,部署将自动更新。可以稍后在部署设置中启用/禁用此设置。
    2. 选择所需的 Deployment Type。
      1. Development 部署用于非生产用例,并配置了最少的资源。
      2. Production 部署每秒最多可以处理 500 个请求,并配置了具有自动备份的高可用性存储。
    3. 确定部署是否应 Shareable through LangGraph Studio。
      1. 如果未选中,则部署只能通过工作区的有效 LangSmith API 密钥访问。
      2. 如果选中,则任何 LangSmith 用户都可以通过 LangGraph Studio 访问该部署。将提供指向该部署的 LangGraph Studio 的直接 URL,以便与其他 LangSmith 用户共享。
    4. 指定 Environment Variables 和密钥。请参阅环境变量参考以配置部署的其他变量。
      1. 敏感值(例如 API 密钥,如 OPENAI_API_KEY)应指定为密钥。
      2. 也可以指定其他非密钥环境变量。
    5. 将自动创建一个与部署同名的新 LangSmith Tracing Project。
  4. 在右上角,选择 Submit。几秒钟后,将出现 Deployment 视图,新部署将排队等待配置。

创建新修订版本

在创建新部署时,默认情况下会创建新修订版本。可以创建后续修订版本以部署新的代码更改。

从 LangSmith UI 开始...

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

查看构建和服务器日志

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

从 LangGraph Platform 视图开始...

  1. 从 Revisions 表中选择所需的修订版本。面板从右侧滑出,默认选择 Build 选项卡,显示修订版本的构建日志。
  2. 在面板中,选择 Server 选项卡以查看修订版本的服务器日志。服务器日志仅在部署修订版本后可用。
  3. 在 Server 选项卡中,根据需要调整日期/时间范围选择器。默认情况下,日期/时间范围选择器设置为 Last 7 days。

查看部署指标

从 LangSmith UI 开始...

  1. 在左侧导航面板中,选择 LangGraph Platform。LangGraph Platform 视图包含现有 LangGraph Platform 部署的列表。
  2. 选择要监控的现有部署。
  3. 选择 Monitoring 选项卡以查看部署指标。请参阅所有可用指标的列表。
  4. 在 Monitoring 选项卡中,根据需要使用日期/时间范围选择器。默认情况下,日期/时间范围选择器设置为 Last 15 minutes。

中断修订版本

中断修订版本将停止部署修订版本。

未定义的行为

中断的修订版本具有未定义的行为。这仅在你需要部署新修订版本并且已经有一个修订版本"卡住"正在进行时才有用。将来,此功能可能会被删除。

从 LangGraph Platform 视图开始...

  1. 从 Revisions 表中所需修订版本的行右侧选择菜单图标(三个点)。
  2. 从菜单中选择 Interrupt。
  3. 将出现一个模态框。查看确认消息。选择 Interrupt revision。

删除部署

从 LangSmith UI 开始...

  1. 在左侧导航面板中,选择 LangGraph Platform。LangGraph Platform 视图包含现有 LangGraph Platform 部署的列表。
  2. 选择所需部署的行右侧的菜单图标(三个点)并选择 Delete。
  3. 将出现 Confirmation 模态框。选择 Delete。

部署设置

从 LangGraph Platform 视图开始...

  1. 在右上角,选择齿轮图标(Deployment Settings)。
  2. 将 Git Branch 更新为所需的分支。
  3. 选中/取消选中复选框以 Automatically update deployment on push to branch。
  4. 分支创建/删除和标签创建/删除事件不会触发更新。只有对现有分支的推送才会触发更新。
  5. 快速连续推送到分支将排队后续更新。一旦构建完成,最新提交将开始构建,其他排队的构建将被跳过。

添加或删除 GitHub 存储库

安装并授权 LangChain 的 hosted-langserve GitHub 应用程序后,可以修改应用程序的存储库访问权限以添加新存储库或删除现有存储库。如果创建了新存储库,可能需要显式添加它。

  1. 从 GitHub 个人资料,导航到 Settings > Applications > hosted-langserve > 点击 Configure。
  2. 在 Repository access 下,选择 All repositories 或 Only select repositories。如果选择 Only select repositories,则必须显式添加新存储库。
  3. 点击 Save。
  4. 创建新部署时,下拉菜单中的 GitHub 存储库列表将更新以反映存储库访问权限更改。

IP 地址白名单

从 2025 年 1 月 6 日之后创建的 LangGraph Platform 部署的所有流量都将通过 NAT 网关。 此 NAT 网关将根据你部署的区域拥有多个静态 IP 地址。请参阅下表以获取要加入白名单的 IP 地址列表:

US EU
35.197.29.146 34.90.213.236
34.145.102.123 34.13.244.114
34.169.45.153 34.32.180.189
34.82.222.17 34.34.69.108
35.227.171.135 34.32.145.240
34.169.88.30 34.90.157.44
34.19.93.202 34.141.242.180
34.19.34.50 34.32.141.108