xusenlin / marewood

🌻marewood is an open source automatic packaging deployment tool for front-end

MareWood

marewood is an open source automatic packaging deployment tool for front-end

What is MareWood doing?

marewood will help you clone the frontend Git repository. Once you associate a repository with a packaging task, you can choose the branch and command for packaging. After a successful packaging, you can access it through an alias.

Usage

• If the registered username is Admin, it will automatically become a super administrator, and usernames cannot be repeated.
• Configure the front-end project to automatically select different API request addresses using different packaging commands, in order to meet the packaging requirements of various environments.
• If you need to switch the Node.js version, please stop the Marewood container and run another version of the container using the same mounted directory.
• The mounted "resources" directory contains database files, cloned Git repositories, log files,and packaged static files (in the "web" directory). Nginx is used to serve the static files and is configured to point to the "web" directory. This setup allows for accessing the packaged projects freely using URLs.

node16

docker run -d --name marewood -p 8088:8088 -v ~/docker/marewood:/marewood/resources ghcr.io/xusenlin/marewood:1.0.3-node16

node18

docker run -d --name marewood -p 8088:8088 -v ~/docker/marewood:/marewood/resources ghcr.io/xusenlin/marewood:1.0.3-node18

node20

docker run -d --name marewood -p 8088:8088 -v ~/docker/marewood:/marewood/resources ghcr.io/xusenlin/marewood:1.0.3-node20

node22

docker run -d --name marewood -p 8088:8088 -v ~/docker/marewood:/marewood/resources ghcr.io/xusenlin/marewood:1.0.3-node22

Screenshot

Dashboard

Repo

Task

Task Tag

Task Info

Roles

Currently, the roles are divided into: Super Administrator, Administrator, Developer, and Project Journalist. The permissions are as follows:

• Project Journalist - can only view all content and access the packaged front-end project
• Developer - has the permissions to create repositories, categories, tasks, pull code, switch branches, run builds, delete dependencies, and trim branches
• Administrator - can delete repositories, categories, and tasks
• Super Administrator - can manage users (promote and demote roles, delete users) Note: Higher-level roles have all the permissions of lower-level roles. Users are registered as Project Journalists by default. If the registered name is Admin, it will automatically become a Super Administrator. Registered names cannot be duplicated.

Note

Repo

If your git repository is not public, you need to provide your Git account and password when creating the repository to obtain cloning permission.

task

This task runs every time using git pull to fetch the latest code, and displays the hash of the current git commit in the task field column, so you can confirm if it is the latest submission.

docker for mac

If you want to use pnpm to install dependencies in a Docker container on Mac, you need to modify the Docker file mounting method to osxfs. issues: docker/for-mac#6787 🙁🙁 The thing is that osxfs has bad performance compared to grpc, and even worse compared to virtiofs...

License

MIT © MareWood

marewood's Issues

建议增加项目名称的选填项

现在的url都是指向webs/1 之类的文件夹，建议增加项目名称的选填项，可以自定义子文件夹的名称，美化url

本地mac系统打包后，部署到linux服务器上，资源目录错误

启动错误日志中显示的是本地mac电脑的路径

不为我正常工作

open /marewood/resources/repositories/1/package.json: no such file or directory

建议开发者角色去除创建仓库的权限

建议开发者角色去除创建仓库的权限，改由管理员或超级管理员指派对应的仓库给开发者，开发者只能操作指定仓库的部署，这样角色权限更为分明

docker 很方便，但是搭建成功之后，不知道如何下手，添加仓库也不顶用，拉取不下来代码

有空把教程写的详细点么 =。=