Managed Runtime Administration（托管运行时管理）

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

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

在 Runtime Admin 中创建项目：

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

本指南中其余管理任务的说明均假设您从 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. 点击创建环境。

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

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

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

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

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

要访问环境设置页面：

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

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

环境变量能让您将变量添加到在环境中运行的应用程序进程中，而无需更改代码。环境变量被安全存储，使其非常适合以下用例：

• 第三方集成的 API 密钥
• 应用程序逻辑的功能标志
• 环境之间各异的配置

可以使用 Managed Runtime API 来管理环境变量，并使用 process.env 在 Node.js 中访问环境变量。

要设置、更新和取消设置环境变量，请使用projects_target_env_var_partial_update：

选择对您的应用程序有意义的环境变量名称。环境变量值可以是布尔值、整数或字符串。要设置复杂值，请将 JSON 编码为字符串。

要取消设置现有环境变量，请将其值设置为 null。

修改环境变量会导致重新部署环境的当前捆绑包。

要获取环境中设置的所有环境变量，请使用projects_target_env_var_list：

环境变量的使用受到以下约束条件限制：

• 每个环境的环境变量限制为 100 个。
• 为环境设置的环境变量值的最大大小为 32 KB。
• 环境变量名称不得超过 512 个字符，并且不能以如下保留前缀开头：AWS、MRT、X_MRT、MOBIFY、X_MOBIFY、SSR_PROXY
• 环境变量名不能使用任何保留名：BUNDLE_ID、DEPLOY_ID、DEPLOY_TARGET、EXTERNAL_DOMAIN_NAME、HANDLER、LAMBDA_RUNTIME_DIR、LAMBDA_TASK_ROOT、NODE_ENV、REDIRECT_BUCKET、REDIRECT_KEY、REDIRECT_UPDATE、REMOTE、X_AMZN_TRACE_ID

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

重定向是一项强大的功能，可能会对您的网店产生重大的安全后果，包括重定向到恶意 URL 或资产。在为用户分配角色以授予他们重定向访问权限时，请务必小心。

要创建重定向：

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。重定向目标字段可以是 /summer 或 www.example.com/summer。

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

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

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

大多数重定向使用永久 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。

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

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

复制重定向：

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. 点击是，移除用户。