activity-maker-builder

activity-maker-builder

活动构建器

环境

很重要：你必须要确认你使用到的功能在下面这个版本是有的

• Node.js: 14.15.0
• pm2: 5.1.2（应用启动需要用 fork 模式，因为构建的特殊性，不能同时起多个进程构建）
• yarn: 1.22+

项目依赖全局的 yarn，如果部署的环境发生了变化，需要先确认在机器（容器）上是否全局安装了

开发

本地

因为构建系统比较复杂，暂时不考虑本地的 hot reload

// 运行以下命令即可
yarn dev

资源

Redis

paas 资源 ID：

• 测试：xdbc:redis_test:redis
• UAT：xdbc:redis-test:redis
• 生产：

存储系统（上传文件）

文档：http://doc.ximalaya.com/xfm/docs/storage.html

接口

/activity/:id

• GET: 获取活动的发布状态
• PUT: 发布活动
• DELETE: 将活动从发布队列移除

参数	类型	说明
id	number	活动 ID

/queue

• GET: 查询发布队列
• DELETE: 清空发布队列

/component

• POST: 安装组件
• DELETE: 卸载组件

参数	类型	说明
packages	{name: string; version: string}[]	组件列表

/component/all

• GET: 获取组件列表
• DELETE: 清空所有组件

/component/tree

• GET: 获取组件树

发布

1. git commit 需要遵循 Conventional Commits 规范
2. yarn release 生成 changelog 并更改版本号（这一步很重要，发布的缓存会依赖项目的版本号）
3. git push --follow-tags origin xxx 把改动和 tag 推到云效的远程分支
4. 云效流水线部署

可能会遇到的问题

1. 目前环境变量里写死 ip 的地方只有 redis，如果这个服务换机器了，那么 pm2 的配置文件需要做相应的调整
2. 如果发现 SSR 的时候页面的样式没有生成的话，那原因多半是 styled-components 有多实例
3. 在线安装包的时候，需要显示设置 yarn 的 registry，如果依赖无法安装，那么多半是连不上这个 registry 的地址了，可以找架构组和运维一起排查
4. 不支持动态 import 的语法