跳到主要内容
Documentation Hub

通过 SAM 升级

通过 SAM 升级 RainMaker 后端​

请按照以下步骤，使用无服务器应用程序模型 (Serverless Application Model, SAM) 升级 RainMaker 后端组件：

支持的代码库​

  • ESP-Rainmaker-Base
  • ESP-Rainmaker-Core
  • ESP-Rainmaker-AddOns
  • ESP-Rainmaker-Timeseries

上述所有主堆栈都可以通过下列步骤升级到最新版本，升级过程与部署过程类似。

升级 SAM 代码库的步骤​

  1. 登录 AWS 控制台

    • 从 AWS 控制台，进入 Services，搜索 CloudFormation。

    node_registration_1

  2. 选择主堆栈

    • 进入 Stacks，找到你要升级的主堆栈（例如，ESP-Rainmaker-Base）。

    SAMUPGRADE2

  3. 开始升级

    • 点击选定的堆栈。
    • 选择 Update。
    • 选择 Replace existing template。
    • 按照文档中提供链接的版本，输入更新后的 URL 链接。

    SAMUPGRADE3

  4. 按照堆栈创建过程进行升级

    • 按照创建堆栈时的步骤继续升级。详情请参考后端部署中创建堆栈过程的截图。

  5. 审核并提交

    • 审核堆栈详细信息，确认无误后点击 Submit。

    SAMCFCOMPLETE

  6. 观察升级进度：

    • 启动升级后，CloudFormation 将开始更新堆栈，观察此过程，确保更新成功。

对于其他需要升级的堆栈，可重复上述步骤。

在升级前，请确保备份 Cognito 设置。详情请参考备份指南。

升级 RainMaker 管理面板​

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

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

登录 RainMaker 管理面板。

在页面底部查看当前版本。

upgrade9

点击侧边栏中的 Check Updates 选项，查看是否有可用新版本。如果没有新版本可用，会弹出下图中的提示窗口：

upgrade10

如果有可用的新版管理面板，会弹出下图中的提示窗口：

upgrade11

点击 Update Dashboard 按钮，升级新版本。

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

upgrade12

升级 ESP-3P-Integrations-Skills-Add-Ons

以下指南分步说明了如何在 AWS CloudFormation 中升级 ESP-3P-Integrations-Skills-Add-Ons 堆栈集，并将堆栈模板更新至最新版本，此步骤与部署过程类似。

升级 ESP-3P-Integrations-Skills-Add-Ons 的步骤​

  1. 登录 AWS 控制台

    node_registration_1

  2. 访问 StackSets

    • 在 CloudFormation 管理面板中，选择左侧菜单栏里的 StackSets。
    • 在堆栈集列表中，选择 ESP-3P-Integrations-Skills-Add-Ons 堆栈集。

    SKILLSSTACKSET

  3. 编辑 StackSet 的详细信息

    • 选好堆栈集后，点击顶部菜单中的 Actions。
    • 点击 Edit StackSet details。

    SKILLSSTACKSETEDIT

  4. 替换当前模板

    • 在 Prepare template 部分，选择 Replace current template。
    • 提供最新版本模板的 URL：
      • URL 模板：输入新模板的 URL。此 URL 应指向由你的组织提供的最新版本模板。

    SKILLSSTACKSETEDITLINK

  5. 指定新模板详细信息

    • 输入 URL 模板后，按照创建新堆栈集时的流程继续完成升级：
      • 参考创建堆栈集时的截图，按照相同的步骤进行操作。
      • 仔细审核模板的所有参数。如有必要，可以通过修改参数来满足最新要求。

  6. 重新选择 AWS 账户 ID 和区域

    • 在 Deploy Stacks In Accounts 部分，重新选择需要部署堆栈集的 AWS 账户 ID。
    • 在 Specify Regions 部分，选择需要部署新堆栈集的区域。请确保选择正确的区域以符合你组织的部署策略。

  7. 审核并提交

    • 审核更改后的堆栈集配置。
    • 确认无误后，点击 Submit 开始更新。

  8. 观察 StackSet 更新进度

    • 提交后，观察 CloudFormation 中堆栈集的状态，确保更新成功。
      • 前往 CloudFormation > StackSets > Operations，检查所选区域的堆栈集更新进度。
      • Status：若更新成功，所有区域都将显示 SUCCEEDED 状态。

On this page