如何部署到云 SaaS¶

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

先决条件¶

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

创建新部署¶

从LangSmith UI 开始...

1. 在左侧导航面板中，选择 LangGraph Platform。LangGraph Platform 视图包含现有 LangGraph 平台部署的列表。
2. 在右上角，选择 + New Deployment 以创建新部署。
3. 在 Create New Deployment 面板中，填写必填字段。
   1. 部署详情
      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（可通过 LangGraph Studio 共享）。
      1. 如果未勾选，则部署只能通过工作区的有效 LangSmith API 密钥访问。
      2. 如果勾选，部署将可通过 LangGraph Studio 供任何 LangSmith 用户访问。将提供部署的 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 平台部署的列表。
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（环境变量）和密钥。现有密钥和环境变量将预填充。请参阅环境变量参考以配置版本的其他变量。
      1. 添加新的密钥或环境变量。
      2. 移除现有密钥或环境变量。
      3. 更新现有密钥或环境变量的值。
5. 选择 Submit。几秒钟后，New Revision 模态框将关闭，新版本将排队等待部署。

查看构建和服务器日志¶

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

从 LangGraph Platform 视图开始...

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

中断版本¶

中断版本将停止该版本的部署。

从 LangGraph Platform 视图开始...

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

删除部署¶

从LangSmith UI 开始...

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

部署设置¶

从 LangGraph Platform 视图开始...

1. 在右上角，选择齿轮图标 (Deployment Settings)。
2. 将 Git Branch 更新为所需分支。
3. 勾选/取消勾选 Automatically update deployment on push to branch 复选框。
   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 地址列表。