跳到主要内容

通过 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 版本节点注册模块版本
3.3.0v25
3.0.0v24
3.2.1v24
3.2.0v24
3.1.2v24
3.1.0v24
3.1.0-alpha.3v24
3.0.0v24
2.8.1v23
2.8.0v23
2.7.1v22
2.7.0v21
2.6.0v20
2.5.1v22
2.5.0v19
2.2.0 to 2.4.0v18
2.0.2 to 2.1.2v17
2.0.0 to 2.0.1v16
1.1.30 to latestv14
1.1.28 to 1.1.29v13
1.1.27v12
1.1.22 to 1.1.26v11
1.1.17 to 1.1.25v10
1.1.12 to 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