跳到主要内容
Documentation Hub

后端部署

概述

本节概述了 ESP-Rainmaker-Base 和 ESP-Rainmaker-Core 堆栈的部署步骤。
必须首先部署 ESP-Rainmaker-Base 堆栈，然后再部署 ESP-Rainmaker-Core 堆栈。
对于每个堆栈，需使用上一节中配置的 S3 URL，设置日志级别和阶段名称等堆栈参数，并等待部署完成。
部署成功后，会收到 RainMaker 超级管理员用户凭据和部署详情邮件。

ESP-Rainmaker-Base​

此堆栈包含以下模块：

  • ESP-RainMaker-Base-API
  • ESP-RainMaker-Base
提示

堆栈的部署根据创建 CloudFormation 堆栈的通用步骤进行。

在步骤 3（选择模板）中：

  • 使用之前配置的 S3 URL（指向 ESP-Rainmaker-Base），将此 URL 粘贴到 Amazon S3 URL 中。
提示

如果尚未配置 S3 URL，请查看配置步骤。

SAMBASELINK

在步骤 4（配置堆栈）中：

  • 输入堆栈名称 ESP-Rainmaker-Base。

  • 设置以下参数：

    • Log - 日志级别
      Debug（最详细）、Info、Warn、Error（最简略）
    提示

    日志越详细，成本越高。
    通常选择 Debug 级别。

    • StageName - 部署阶段
      dev（开发）、test（测试）、prod（生产）
    注意

    后续升级时，必须使用与初始部署相同的阶段名称。

    SAMBASE2

步骤 7（等待完成）：

SAMBASE3

持续时间

此过程大约需要 15～20 分钟。

ESP-Rainmaker-Core​

此堆栈包含以下模块：

  • ESP-Rainmaker-Core
  • rainmaker-node-registration
  • ESP-RainMaker-Dashboard
提示

堆栈的部署根据创建 CloudFormation 堆栈的通用步骤 进行。

在步骤 3（选择模板）中：

  • 使用之前配置的 S3 URL（指向 ESP-Rainmaker-Core），并将此 URL 粘贴到 Amazon S3 URL 中。

    提示

    如果尚未配置 S3 URL，请查看配置步骤。

    SAMCORE1

在步骤 4（配置堆栈）中：

  • 输入堆栈名称 ESP-Rainmaker-Core。

  • 设置以下参数：

    • Email - 用于发送通知的电子邮件地址。新用户注册完成时，会收到来自该电子邮件地址的验证码。
    提示

    注意，此电子邮件地址应通过 AWS 提供的 SES (Simple Email Service) 验证。详情可参考配置 Simple Email Service。

    • Username - 用于创建超级管理员用户的电子邮件地址。该电子邮件的用户将在部署成功后自动创建。部署成功后，该邮箱会收到登录凭据和部署详情邮件。

      注意

      不建议使用个人邮箱作为超级管理员用户的邮箱，请使用通用的邮箱地址。此通用电子邮件的访问权限应仅限于极少数人，因为该用户拥有 RainMaker 部署的最高权限。 例如：service@<公司域名>。

      提示
      • 在部署过程中创建的此用户将拥有超级管理员权限。
      • 仅此用户可以访问诸如 RainMaker Admin CLI 等服务。

      :::

      SAMCORE2

步骤 7（等待完成）：

SAMCORE3

持续时间

大约需要 1 小时。

部署完成确认​

备注

ESP RainMaker 后端服务部署成功后，部署堆栈期间配置的电子邮件地址会收到包含 RainMaker 超级管理员用户凭据的电子邮件。这些凭据用于登录 RainMaker 管理面板。

SAR19

备注

稍后，会收到另一封电子邮件，包含了 RainMaker 平台的部署详情，其中还包含有关 Base API URL 等的详细信息。

SAR20

后端部署验证​

所有后端组件部署成功后，所有堆栈的状态将显示为 ✅CREATE_COMPLETE。

  • 前往 AWS Console -> Services -> CloudFormation，查看已部署的堆栈列表。
  • 你会看到到如下列表：

verify1

前端部署验证（管理面板）​

前端部署指 ESP RainMaker 管理面板

本节介绍如何验证前端管理面板的部署，这是 ESP-RainMaker-Core 堆栈的一个模块。

  • 要测试 RainMaker 前端的部署，需获取 CloudFront 分发的 URL，并在浏览器中打开。
  • 前往 CloudFront 服务。

verify2

提示

记住此域名 URL，然后在浏览器中打开。

  • RainMaker 管理面板登陆页面如下。如果成功显示此页面，说明 RainMaker 前端部署成功。

verify4

声明

根据您所处的区域，CloudFront 分发时间可能有所不同，通常约 15～20 分钟。
因此，如果无法访问管理面板，请在 15~20 分钟后重新尝试。

至此，您已经成功部署了 RainMaker 后端服务！🎉

On this page