如何部署到云 SaaS¶

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

先决条件¶

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

创建新部署¶

从 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。部署与某个分支相关联。当创建新的修订版本时，将部署该分支的代码。以后可以在 Deployment Settings 中更新该分支。
      4. 指定 LangGraph API config file 的完整路径，包括文件名。例如，如果文件 langgraph.json 位于仓库的根目录中，只需指定 langgraph.json。
      5. 勾选或取消勾选 Automatically update deployment on push to branch 复选框。如果已勾选，当更改推送到指定的 Git Branch 时，部署将自动更新。此设置之后可以在 Deployment Settings 中启用或禁用。
   2. 选择所需的 Deployment Type。
      1. Development 部署适用于非生产用途，并使用最少资源进行配置。
      2. Production 部署可处理高达每秒 500 个请求，并使用高可用存储和自动备份进行配置。
   3. 确定部署是否应通过 LangGraph Studio 共享。
      1. 如果未勾选，部署将仅可通过工作区的有效 LangSmith API 密钥访问。
      2. 如果勾选，部署将通过 LangGraph Studio 提供给任何 LangSmith 用户。将提供一个直接链接到 LangGraph Studio 的 URL 以与其他 LangSmith 用户共享。
   4. 指定 Environment Variables 和密钥。请参阅 Environment Variables reference 以配置部署的其他变量。
      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（通过 LangGraph Studio 共享）。
      1. 如果未勾选，部署将仅能通过有效的工作区 LangSmith API 密钥访问。
      2. 如果已勾选，部署将可通过 LangGraph Studio 供任何 LangSmith 用户访问。将会提供一个直接链接到 LangGraph Studio 的 URL，以便与其他 LangSmith 用户共享。
   3. 指定 Environment Variables 和密钥。现有的密钥和环境变量已经预填充。请参阅 Environment Variables 参考文档，为该版本配置额外的变量。
      1. 添加新的密钥或环境变量。
      2. 删除现有的密钥或环境变量。
      3. 更新现有密钥或环境变量的值。
5. 选择 Submit。几秒钟后，New Revision 模态框将关闭，并且新版本将排队等待部署。

查看构建和服务器日志¶

每个修订版本都可以查看构建和服务器日志。

从 LangGraph Platform 视图开始...

1. 从 Revisions 表中选择所需的修订版本。右侧会滑出一个面板，并默认选择 Build 标签页，显示该修订版本的构建日志。
2. 在面板中，选择 Server 标签页以查看该修订版本的服务器日志。只有在部署了修订版本后，服务器日志才可用。
3. 在 Server 标签页中，根据需要调整日期/时间范围选择器。默认情况下，日期/时间范围选择器设置为 最近7天。

中断修订¶

中断一个修订将停止该修订的部署。

从 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. 勾选或取消勾选复选框以启用/禁用 在将代码推送到分支时自动更新部署。
   1. 分支的创建/删除和标签的创建/删除事件不会触发更新。只有对现有分支的推送才会触发更新。
   2. 对同一分支进行连续快速的推送不会触发后续更新。未来此功能可能会被更改或改进。

添加或移除 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地址列表：