如何部署到云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（Git分支）。一个部署链接到一个分支。当创建新版本时，将部署链接分支的代码。该分支稍后可以在部署设置中更新。
      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天）。

查看部署指标¶

从LangSmith UI开始...

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

中断版本¶

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

从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地址列表。