Managed Runtime Administration(托管运行时管理)

Managed Runtime 可以轻松管理与 PWA Kit 网店关联的组织、项目、环境和捆绑包。本指南描述在基于 Web 的 Runtime Admin 工具中可能执行的不断增长的管理任务列表。(本指南中描述的所有管理任务以及更多任务也可以使用 Managed Runtime API 完成。)

在继续之前,请确保您有权访问 Managed Runtime 和 Runtime Admin。如要配置 Managed Runtime,请联系 Success Manager。对于 Runtime Admin,请联系 Commerce Cloud 管理员并要求他们使用 Account Manager 将以下任一角色添加到您的帐户:Managed Runtime User(托管运行时用户)或 Managed Runtime Admin(托管运行时管理员)。

项目可帮助您管理组织内的多个环境。每个 PWA Kit 项目都需要 Managed Runtime 中的相应项目,用于在 Salesforce 的公共云基础架构上部署和托管网店代码。

创建项目

在 Runtime Admin 中创建项目:

  1. 登录 Runtime Admin
  2. 点击新建项目
  3. 输入项目的名称。
  4. 点击创建项目

首次创建项目时,在部署必要的云基础架构之前,您的网站无法在 Web 上访问。此部署过程最多可能需要 40 分钟。

在 Runtime Admin 中查找项目

本指南中其余管理任务的说明均假设您从 Runtime Admin 中的项目概览页面开始。

要查找现有项目并打开其概览页面:

  1. 登录 Runtime Admin
  2. 如有必要,从组织菜单(左上角)中选择一个组织。
  3. 点击项目名称。(要查看项目,您必须被分配前面描述的项目角色之一。)

相关截图

要在项目之间快速切换,请使用页面顶部的项目菜单。

查看和编辑项目设置

您可以在“项目设置”页面执行以下任务:

  • 查找项目 ID 并确保它与 PWA Kit 配置匹配。
  • 编辑项目 ID。
  • 查看和编辑项目的名称和 URL。
  • 删除项目。
  • 管理部署通知。(见下一节。)

要访问“项目设置”页面:

  1. 转到项目的“概述”页面。
  2. 点击左侧导航中的“项目设置”。

要编辑设置,请点击编辑,进行编辑,然后点击更新。要放弃您的编辑,请点击取消

要删除项目,请点击删除,输入项目名称进行确认,然后点击是,删除。要保留项目,请点击否,保留

您可以选择在发生以下任何部署事件时通过电子邮件收到通知:

  • 开始部署
  • 成功部署
  • 部署失败

添加通知

要添加通知:

  1. 转到项目的“概述”页面。
  2. 点击左侧导航中的项目设置
  3. 点击添加通知
  4. 选择要通知的一个或多个环境。
  5. 选择一个或多个部署事件。
  6. 输入所有通知收件人的电子邮件地址。
  7. 点击添加通知

相关截图

编辑通知

要编辑通知:

  1. 转到项目的“概述”页面。
  2. 点击左侧导航中的项目设置
  3. 点击通知旁边的**...**按钮。
  4. 点击编辑
  5. 更改任何通知设置。
  6. 点击更新通知

相关截图

移除通知

要移除通知:

  1. 转到项目的“概述”页面。
  2. 点击左侧导航中的项目设置
  3. 点击通知旁边的**...**按钮。
  4. 点击移除
  5. 点击是,移除

相关截图

环境用于将您的生产环境 (Production) 网店与为其他目的(例如开发或测试)部署的网店分开。要了解有关环境和其他相关概念的更多信息,请参阅 Managed Runtime 概述

创建环境

在 Runtime Admin 中创建环境:

  1. 转到项目的“概述”页面。
  2. 点击新建环境
  3. 输入环境的名称。
  4. 选择一个区域以部署到 Salesforce 的公共云基础架构。
  5. 如果环境是生产环境 (Production),则将其标记为生产。如果您已达到生产环境 (Production) 的限度,请联系支持部门。
  6. 点击创建环境

新环境的默认区域是美国东部(弗吉尼亚北部),因为它最靠近通常与开发和测试环境相关联的 On-Demand Sandbox。

部署捆绑包

对于使用 PWA Kit 和 Managed Runtime 的任何站点,您一次只能指定一个捆绑包为每个环境部署。

  1. 转到项目的“概述”页面。
  2. 点击要部署到的环境名称。例如:生产环境 (Production)
  3. 在标题捆绑包下,点击要部署的捆绑包旁边的部署按钮。
  4. 点击确认部署
  5. 等待部署完成。

成功完成部署后,捆绑包出现在标题已部署捆绑包下方。(如果是第一次部署到新环境,完成该过程最多可能需要一个小时。)

编辑环境设置

通过环境设置页面可以在一个地方执行多项管理任务,包括:

  • 重命名环境或环境 ID。
  • 更改部署区域。
  • 允许特定 IP 地址访问环境。
  • 为环境配置代理。有关更多信息,请参阅代理请求
  • 将环境标记为生产。
  • 删除环境。

要访问环境设置页面:

  1. 转到项目的概述页面
  2. 点击要编辑其设置的环境的名称。
  3. 点击左侧导航中的环境设置

要进行编辑,请点击常规设置或高级设置旁边的编辑按钮。进行编辑后,点击更新以保存更改或点击取消以放弃更改。

重定向允许您将请求从请求的 URL 转发到不同的 URL。重定向有助于避免因网店更改而导致的用户体验中断。例如,考虑春季的季节性活动页面。当春季活动结束并替换为夏季活动时,您可以从春季 URL 重定向到夏季 URL。

创建重定向

在生产环境 (Production) 中创建重定向之前,我们建议您先在准备环境 (Staging) 中创建它。

要创建重定向:

  1. 转到项目的“概述”页面。
  2. 点击要在其中创建重定向的环境的名称。
  3. 点击左侧导航中的URL 重定向
  4. 点击创建重定向
  5. 重定向自字段中,输入相对 URL 路径。例如,要从 URL www.example.com/winter重定向访问者,请输入 /winter
  6. 重定向到字段中,输入相对 URL 路径。
  7. 如果需要,启用查询参数和通配符路径的转发。(稍后会详细介绍转发设置。)
  8. 重定向类型下拉菜单中,选择基于 HTTP 状态代码的重定向类型。(稍后会详细介绍状态码。)
  9. 点击创建重定向

让我们更详细地考察创建重定向的选项。

路径

您在重定向来源字段中输入的值必须始终是相对路径。重定向目标字段可以是相对路径或完整 URL。例如,假设我们要将访问者从 www.example.com/spring 重定向到 www.example.com/summer重定向来源字段必须是 /spring重定向目标字段可以是 /summerwww.example.com/summer

通配符

您可以将星号字符 (*) 添加到重定向来源的末尾以指示通配符。通配符匹配 URL 中的任何(0 个或多个)字符。例如,来自 /a/* 的重定向将匹配 /a//a/b/a/b/c

只能在重定向来源 URL 的末尾使用通配符。

标准重定向首先由 Managed Runtime 处理,然后是带有通配符的重定向。

HTTP 状态码

大多数重定向使用永久 301 状态代码,但也可以选择临时 302。如果不确定要使用哪个 HTTP 状态码,请通过 MOZ.com 咨询此 状态码解释器

转发查询参数

有些请求包含您也希望包含在重定向请求中的查询字符串参数。例如,相对路径 /spring-landing-page 可以附加用于分析跟踪的查询字符串,如 /spring-landing-page?gclid=123

要启用查询参数转发,请转到表单的转发部分并选择查询参数。否则,来自源 URL 的查询字符串参数不会包含在重定向 URL 中。

重定向来源重定向目标都具有查询字符串并且启用了转发时会发生什么情况?在这种情况下,重定向 URL 包括两个查询字符串的组合。来自重定向目标 URL 的查询参数附加到请求中的查询字符串。例如,假设您的应用程序接收到相对路径 /spring?year=2019 的请求。如果您选择重定向 /spring/summer?year=2020,则启用转发时,重定向 URL 是 /summer?year=2019&year=2020

转发通配符路径

您可以在重定向目标 URL 中自动包含重定向来源 URL 的通配符部分之后的任何路径。例如:如果 /a/* 匹配 重定向来源 URL 中的 /a/b/c,并且重定向目标 URL 是 /z/,则重定向 URL 是/z/b/c

要启用通配符路径转发,请转到表单的转发部分并选择通配符路径

复制重定向

我们建议您始终在准备环境 (Staging) 中创建重定向,并在测试后将其复制到生产环境 (Production) 中。

您可以使用复制重定向功能将所有重定向从一个环境复制到另一个环境。

复制重定向:

  1. 转到项目的“概述”页面。
  2. 点击包含要复制的重定向的环境名称。
  3. 点击左侧导航中的URL 重定向
  4. 点击复制重定向。将出现复制重定向表单。当前环境列在源环境(源)下。
  5. 目标环境下,选择要将重定向复制到的环境(目标)。
  6. 点击复制 n 重定向。(其中 n 是要复制的重定向数。)

复制重定向时,您将目标环境中的所有重定向替换为源环境中的所有重定向。

编辑重定向

要编辑现有重定向的设置:

  1. 转到项目的“概述”页面。
  2. 点击包含要编辑的重定向的环境名称。
  3. 点击左侧导航中的 URL 重定向
  4. 点击重定向旁边的省略号按钮 (...)。
  5. 点击编辑
  6. 更新设置。
  7. 点击更新重定向

删除重定向

要删除重定向:

  1. 转到项目的“概述”页面。
  2. 点击包含要删除的重定向的环境名称。
  3. 点击左侧导航中的URL 重定向
  4. 点击重定向旁边的省略号按钮 (...)。
  5. 点击删除
  6. 点击是,删除重定向

故障排除重定向

如果重定向未按预期工作,请尝试以下故障排除步骤:

  • 清除浏览器缓存 ,因为重定向已缓存。
  • 确认您正在查看正确环境的设置。
  • 编辑重定向并验证在重定向来源重定向目标字段中输入了正确的值。

重定向的技术限制

重定向具有以下技术限制:

  • 每个环境最多可以有 10,000 个重定向。
  • 每个环境都有自己的重定向组。您有责任使用复制使它们保持同步。
  • 重定向功能支持从一条路径到另一条路径的简单重定向。对于带有条件的复杂重定向,请使用 ssr.js 中的 Express.js' redirects support
  • 使用 Runtime Admin 工具或 Managed Runtime API 创建的重定向不在本地开发环境中运行。
  • PWA Kit 应用程序中的页面转换不会触发重定向;它们只能由 HTTP 请求触发。

添加用户

要将用户添加到项目:

  1. 转到项目的“概述”页面。
  2. 点击左侧导航中的用户和权限
  3. 点击新建用户
  4. 输入用户的电子邮件地址。(确保用户是您组织的一部分,并且在 Account Manager 中具有以下任一角色:Managed Runtime User(托管运行时用户)或 Managed Runtime Admin(托管运行时管理员)。
  5. 选择角色。
  6. 点击添加用户

相关截图

更改用户角色

更改用户角色:

  1. 转到项目的“概述”页面。
  2. 点击左侧导航中的用户和权限
  3. 点击用户名旁边的**...**按钮。
  4. 点击编辑
  5. 选择角色。
  6. 点击出现的弹出菜单。
  7. 选择新角色。
  8. 点击保存

相关截图

有关与每个角色关联的用户能力列表,请参阅 Managed Runtime 概述

移除用户

从项目中移除用户:

  1. 转到项目的“概述”页面。
  2. 点击用户和权限
  3. 点击用户名旁边的**...**按钮。
  4. 点击删除
  5. 点击是,移除用户

相关截图