MareWood

MareWood 是一个轻量级的前端部署工具，使用了 GOLANG、GIN、GORM、JWT、SQLITE、REACT、MATERIAL-UI 开发，不同于 Jenkins 的大而全，它很简单且只针对前端，你可以很灵活的配置各种部署环境。如果你愿意，线上发布也可以是点击一下按钮这么简单的事情,当然也可以配置 WEBHOOK，提交 GIT 代码既自动发布。

MareWood 在做什么

MareWood 可以帮你克隆前端仓库并使用你选择的工具安装依赖，并能在同一个仓库下通过不同的任务不同的打包命令和不同的分支打包出多个环境下的前端资源并放在 resources\webs 下，通过任务 ID 一一对应，并提供快捷访问，超级简单好用灵活。

使用

用户使用： 1.填入仓库地址->2.可以新建多个任务关联此仓库->3.点击打包等待完成即可访问。

任务一旦生成，可以随时切换分支打包。

服务搭建：

服务器请先安装 git、node、npm，建议同时安装 cnpm 和 yarn 以供选择。
修改 config.json 来配置 MareWood 启动的端口号、域名、和支持的前端工具。
编译 MareWood 并放入后台运行。

客户端在 public 目录,特殊需求可以自行修改，

其他：MareWood 提供 http 访问，建议 nginx 提供 https 静态文件服务器（nginx指向resources\webs ,配置好你的 OtherAddressUrl 字段，可留空）这样可以灵活的选择 http 或者 https 去访问打包的前端项目。

那么，一个 React 或者 Vue 项目如何配置多个打包命令呢？请移步 http://xusenlin.com/article?key=BzV0K2 如果不明白也可以参考实际的项目

角色

角色目前分为超级管理员、管理员、开发者、项目记者。权限如下：

项目记者 - 只能查看所有内容，并且可以访问打包好的前端项目
开发者 - 拥有创建仓库、分类、任务和拉代码、切换分支、运行打包、删除依赖、裁剪分支权限
管理员 - 可以删除仓库、分类、任务
超级管理员 -可以管理用户（提升和降级角色，删除用户）

注：等级高的角色拥有低级角色的全部权限。用户注册默认成为项目记者，如果注册的名字是 Admin 会自动成为超级管理员，注册名字不可重复。

更新日志

v1.0

添加丢弃本地仓库变动的功能（2020-07-23）
修复运行老的任务分支不存在的 BUG (2020-06-25)
可以快捷修改更多字段和添加任务分页
缩短必要时的任务查询时间，完成打包及时知道
将任务密码重构为任务加锁解锁（多人协作时方便锁定任务，但是密码是透明的）
修复了裁剪分支和新建仓库不刷新相关BUG
设计了 MareWood 的矢量 logo
删除了读取的 dev 打包命令
设置 Token 失效时间为 10H
添加了裁剪分支的功能，可以手动保持和远程分支一致

v0.2

添加用户和权限控制模块
可以快速修改仓库、分类、任务描述
优化和重构了大部分前后端代码
优化了前端界面UI
添加了 docker 容器支持
修复了一部分代码的隐藏 BUG

v0.1

仪表盘的关键信息展示
仓库列表的相关功能（克隆、锁定、更新代码、删除依赖、依赖工具、删除仓库等功能）
任务分类（除了按照打包环境分类也可以按照后台管理、H5活动、M站等自由发挥）
部署任务（同一个前端仓库可以新建多个部署任务，每个部署任务可以任意分支任意命令打包并提供访问）

docker镜像

感谢 @shynome 提供docker镜像

构建镜像步骤

# 固化依赖
go mod vendor
# 打包镜像
docker build . -t marewood
# 临时运行容器, 退出后数据不保存
docker run --rm -ti -p 8081:8081 marewood
# 持久化运行, 有容器卷挂载数据可以保存下来
docker run -d --restart always -p 8081:8081 -v marewood:/marewood/data marewood

示例用法

docker run --rm -ti \
  -p 8090 \
  -e HttpPort=8090 \
  -e AddressUrl=http://127.0.0.1:8090 \
  -v $PWD/marewood-data:/marewood/data \
   shynome/marewood

番外

MareWood 翻译过来是玛瑞·伍德看上去像是一个人的名字，其实它是代表两个人，一个咒语。

wojiaolingdu111/marewood