如何部署 StatusLive 到静态资源平台？

[freejishu]

StatusLive 在之前提供的是基于 conf.json 的配置文件，这样的配置方式对于想部署到提供编译服务的静态资源平台十分不友好（需要先fork，修改后再进行部署）。

为了解决这一问题，从 v2.2 版本开始，StatusLive 将支持以环境变量的方式进行部署。如果环境变量有效，则会优先使用含默认值的环境变量，不再请求 conf.json。此版本可部署到任意可自定义环境变量的静态资源平台，包括但不限于 Cloudflare Pages、Vercel、云托管等。

感谢 @rwv 提出的此建议( #15 (comment) )。下面是一些关于环境变量的Q&A，敬请阅读。

需要定义的环境变量

程序相关

可查看 .env.example 文件：

VUE_APP_use_env = 1 # 此参数为 1 时启用环境变量代替conf.json，无法读取此参数时使用conf.json

VUE_APP_config_title = 状态监控 # 页面标题
VUE_APP_config_title_english = StatusLive #页面副标题

VUE_APP_config_mode = 2 # 模式选项，1为公开模式，2为隐私模式
VUE_APP_config_readonly_apikey = USE_SERVER_APIKEY # 公开模式用，填写从UptimeRobot后台获得的ReadOnly-ApiKey
VUE_APP_config_proxy_link = /core.php # 隐私模式用，反代访问路径
VUE_APP_config_history_time = 60 # 获取过去 X 天的可用率，单位为天
VUE_APP_config_logs_history_days = 30 # 获取过去 X 天的状态日志，单位为天

VUE_APP_config_success_min = 98 # 合格(success)等级标准，低于此数字为警告(warning)等级
VUE_APP_config_warning_min = 90 # 警告(warning)等级标准，低于此数字为危险(danger)等级
VUE_APP_config_auto_refresh_seconds = 60 # 自动刷新时间，单位为秒，填写0为禁用自动刷新

VUE_APP_logs_each_page = 10  # 日志模块每页展示行数，v2.1新增，作用于日志查看区

注意：.env 文件同样不支持注释，请注意删除 # 后的内容避免出错。

使用环境变量启动 StatusLive ，至少需定义 VUE_APP_use_env 。VUE_APP_use_env 为 1 时，将使用环境变量启动 StatusLive。对于其他配置，若不配置，将按照默认配置进行启动，具体数值即为上文提供的数值。

环境相关

现在很多静态资源平台的Nodejs版本都已经>16了，但本项目使用的是16.17.0，所以Build的实话需要Nodejs 16.x。不需要指定具体的版本，指定是Nodejs 16就可以了。

判断启动方式

程序决定好启动方式后，会在控制台输出，如下图：

如果您尝试使用环境变量启动，但此处输出提示仍为 conf.json 启动，建议检查环境变量是否配置正确，重点检查 VUE_APP_use_env 字段，因为只有此字段有值且为 1 时，StatusLive 才会以环境变量方式启动。

Cloudflare Pages 环境变量配置示例

• fork 此项目（建议），在 Cloudflare Dashboard 左侧菜单中找到 Pages，按照引导创建一个新 Pgaes。
• 构建配置可以参考下图，模板选择无。

• 环境变量可以在新建的时候填写，亦可在创建后填写。

• 如图所示，若只定义了 VUE_APP_use_env 和 VUE_APP_config_proxy_link ，其余值会使用默认值启动。

如果没有特殊需求，定义 Production(生产环境) 处的环境变量即可。

• 重要：在Cloudflare Pages上部署，还需要指定编译的Nodejs版本为Nodejs16，推荐和最初的开发环境保持一致，为Nodejs 16.17.0，在环境变量中定义NODE_VERSION即可，如下图：

Vercel 环境变量配置示例

• fork 此项目（建议），在 Vercel Dashboard 中新建一个 Project，选择你fork的储存库，在下方配置环境变量即可。