跳到主要内容
Documentation Hub

通过 SAR 升级

通过 SAR 升级 RainMaker 后端​

RainMaker 团队会定期推出新的 RainMaker 前端与后端版本。

前端服务和后端服务需要分别进行升级。

RainMaker 后端升级​

你可以在无服务器应用程序库 (Serverless Application Repository, SAR) 中查看是否有新的 RainMaker 后端服务版本可用。

你只能升级以下仓库：

  • serverlessrepo-ESP-RainMaker-Base
  • serverlessrepo-ESP-RainMaker-Core

注意：请勿升级以下仓库：
ESP-RainMaker-Base-API

升级过程与首次部署 RainMaker 后端类似，不同之处在于你需要选择最新版本的 SAR 仓库。

登录 AWS 控制台，搜索 SAR 服务。

upgrade1

  • 点击 Available applications 并选择 Private applications。勾选复选框 Show apps that create custom IAM roles or resource policies。

  • 在 SAR 仓库菜单中，搜索 "ESP-Rainmaker-" 库。

  • 点击 ESP-RainMaker-Base，你将看到最新版本的仓库。

    upgrade2

  • 如果你现有的 ESP-RainMaker-Base 版本落后于最新版本，请升级仓库。

  • 升级过程与部署 ESP-RainMaker-Base 仓库的过程类似。

  • 向下滚动并勾选复选框 I acknowledge that this app deploys nested applications。

  • 点击 Deploy。

    upgrade3

  • 部署过程将启动。部署 SAR 仓库大约需要 10～15 分钟。

  • 可以从 CloudFormation 查看此 SAR 仓库的部署状态。

  • 前往 AWS Console > Services > CloudFormation，查看已部署的堆栈列表。

  • 你将在列表中看到 serverlessrepo-ESP-RainMaker-Base 栈的条目，其中 CREATE_COMPLETE 状态表示此仓库已经成功部署，如下图所示：

    upgrade4

升级完 ESP-RainMaker-Base 仓库后，需要继续升级 ESP-RainMaker-Core 仓库。

  • 在 SAR 仓库菜单中，搜索 "ESP-Rainmaker-" 仓库。

  • 点击 ESP-RainMaker-Core，你将看到最新版本的仓库。

    upgrade5

  • 如果你现有的 ESP-RainMaker-Core 版本落后于最新版本，请对其进行升级。

  • 升级过程与部署 ESP-RainMaker-Base 仓库的过程类似。

  • 向下滚动翻页并输入相应参数值。

    upgrade6

  • Email：此电子邮件地址用于向用户发送通知。新用户在注册时将收到来自此电子邮件地址的验证码。请注意，此邮件地址应由 AWS Simple Email Service (SES) 验证，详情请参阅配置简单电子邮件服务章节。

  • Username：此参数用于创建超级管理员用户的电子邮件地址。部署成功后，系统将为使用此电子邮件的用户自动创建超级管理员账号，登录凭证和部署细节都将发送至此邮箱。

注意：在部署过程中创建的用户将拥有超级管理员权限，仅此用户可以使用 RainMaker Admin CLI 等服务。

  • 勾选复选框 I acknowledge that this app creates custom IAM roles, resource policies and deploys nested applications。

  • 点击 Deploy，开始部署 RainMaker 后端。

    upgrade7

  • 此仓库的部署将持续 20～30 分钟。

  • 可以从 CloudFormation 查看此 SAR 仓库的部署状态。

  • 前往 AWS Console > Services > CloudFormation，即可查看已部署的堆栈列表。

  • 你将在列表中看到 serverlessrepo-ESP-RainMaker-Core 栈的条目，其中 CREATE_COMPLETE 状态表示此仓库已经成功部署，如下图所示：

    upgrade8

RainMaker 前端升级​

RainMaker 前端需要单独升级。

升级管理面板有两个步骤。

第一步：在 SAR 控制台中升级。

这一步骤与升级 RainMaker 后端组件或首次部署 RainMaker 前端组件类似。

  • 进入 SAR 仓库管理面板，选择 espdashboard 以启动 RainMaker 前端部署的升级。

    ui1

  • 向下滚动并勾选复选框 I acknowledge that this app creates custom IAM roles and resource policies。

    ui2

  • 管理面板将开始升级，升级状态可以在 AWS 控制台查看。

    ui3

  • 所有模块升级完毕后，模块状态将变为 CREATE_COMPLETE，你将看到如下信息：

    ui4

第二步：在 RainMaker 管理面板中升级。

管理员用户需要在管理面板上查看是否有新版本，如果有可用的新版本，管理员用户可以进行升级。

以下是升级 RainMaker 前端的步骤：

登录 RainMaker 管理面板。

左侧菜单底部会显示当前版本。

upgrade9

点击 Check Updates 按钮，查看是否有可用的新版本。如果没有新版本可用，会弹出下图中的提示窗口。

upgrade10

如果有可用的新版本，会弹出下图中的提示窗口。

upgrade11

点击 Update Dashboard，开始升级管理面板。

升级过程通常需要大约五分钟。升级成功后，请刷新屏幕或退出账号并重新登录。

upgrade12

升级 RainMaker 节点注册模块​

RainMaker 节点注册模块 (rainmaker-node-registration) 用于为节点批量生成证书，各 RainMaker 版本对应的节点注册模块版本请参见下表。

RainMaker 版本对应的节点注册模块版本​

RainMaker 版本节点注册模块版本
2.5.0v19
2.2.0～2.4.0v18
2.0.2～2.1.2v17
2.0.0～2.0.1v16
1.1.30～最新v14
1.1.28～1.1.29v13
1.1.27v12
1.1.22～1.1.26v11
1.1.17～1.1.25v10
1.1.12～1.1.16v9

  • 在 AWS 控制台确认 RainMaker 节点注册模块版本。
    前往 Cloudformation > Stacks > rainmaker-node-registration > Tags > Version。

    node_registration_version

注意：如果上述版本低于上表中对应的版本，需首先将 rainmaker-node-registration 升级至所需版本。

可参照以下步骤，升级节点注册模块。

第一步：打开 AWS 控制台，在 Services 中搜索 CloudFormation。如下图所示：

node_registration_1

第二步：选择 rainmaker-node-registration 堆栈。

node_registration_2

第三步：点击 Update 并点击 Replace current template。

输入以下 Amazon S3 链接：

https://esp-bulknode-batchjob.s3.amazonaws.com/<module_version>/espnoderegistration.yml

例如，若版本为 v19，请输入 https://esp-bulknode-batchjob.s3.amazonaws.com/v19/espnoderegistration.yml。

node_registration_3

点击 Next。

第四步：所有参数保持默认值，点击 Next。

node_registration_4

第五步：选择所需版本（例如 v19），点击 Next。

node_registration_5

第六步：保持默认设置并勾选以下选项：

  • I acknowledge that AWS CloudFormation might create IAM resources.
  • I acknowledge that AWS CloudFormation might create IAM resources with custom names.
  • I acknowledge that AWS CloudFormation might require the following capability: CAPABILITY_AUTO_EXPAND

点击 Update stack。

node_registration_6

如下图所示，rainmaker-node-registration 堆栈将完成升级。

node_registration_7

升级语音助手集成仓库​

参考下列步骤，将用于语音助手集成的 SAR 仓库升级到最新版本。

升级 ESP-RainMaker-3p-CognitoClients 仓库​

  1. 登录 AWS 开发者控制台

    • 打开 AWS 开发者控制台。
    • 确保选择的区域为 RainMaker 的部署区域。

  2. 打开 SAR 服务

    • 前往 Serverless Application Repository 服务。
    • 在 SAR 中，点击 Available applications，然后选择 Private applications。

  3. 选择仓库

    • 找到并点击 ESP-RainMaker-3p-CognitoClients 仓库。

    ESP-RainMaker-3P-Integrations

  4. 在新标签页中打开 CloudFormation

    • 打开新的浏览器标签页并转到 CloudFormation 服务。
    • 确保选择的区域为 RainMaker 的部署区域。

  5. 定位堆栈名称

    • 搜索堆栈名称 "serverlessrepo-ESP-RainMaker-3P-Integrations"。

  6. 查看 CloudFormation 参数

    • 在 CloudFormation 堆栈中，打开 Parameters 标签页。

    CloudFormation stack parameters

  7. 填写 SAR 参数

    • 回到 SAR 服务标签页，确认需要填写的参数。
    • 将所有需要的参数值从 CloudFormation 参数页面复制到 SAR 参数页面。

  8. 部署升级

    • 填写所有参数值后，勾选知悉复选框并点击 Deploy。

升级 ESP-RainMaker-3P-Integrations 仓库​

  1. 登录 AWS 开发者控制台

    • 打开 AWS 开发者控制台。
    • 选择 us-east-1 区域。

  2. 打开 SAR 服务

    • 前往 Serverless Application Repository 服务。
    • 在 SAR 中，点击 Available applications，然后选择 Private applications。

  3. 选择仓库

    • 找到并点击 ESP-RainMaker-3P-Integrations 仓库。

    ESP-RainMaker-3P-Integrations

  4. 在新标签页中打开 CloudFormation

    • 打开一个新的浏览器标签页并转到 CloudFormation 服务。
    • 确保区域为 us-east-1。

  5. 查看嵌套堆栈

    • 打开 View Nested 按钮，查看嵌套堆栈。

  6. 定位堆栈名称

    • 搜索堆栈名称 "serverlessrepo-ESP-RainMaker-3P-Integrations"。

  7. 查看 CloudFormation 参数

    • 在 CloudFormation 堆栈中，打开 Parameters 标签页。

    CloudFormation stack parameters

  8. 填写 SAR 参数

    • 回到 SAR 服务标签页，确认需要填写的参数。
    • 将所有需要的参数值从 CloudFormation 参数页面复制到 SAR 参数页面。

  9. 部署升级

    • 填写所有参数值后，勾选知悉复选框并点击 Deploy。

  10. 针对其他区域进行相同的操作

    • 在以下两个部署区域重复上述步骤以完成升级：
      • us-west-2
      • eu-west-1

升级 ESP-RainMaker-3P-Integration-Addons 仓库​

参考上述 ESP-RainMaker-3P-Integrations 仓库升级步骤，升级 ESP-RainMaker-3P-Integration-Addons 仓库。但要注意以下几点：

  • ESP-RainMaker-3P-Integration-Addons 仓库只部署在一个区域，即 RainMaker 的部署区域。
  • 在执行上述升级步骤前，请确保选择了正确的部署区域。

On this page