tydius/rezbuild

DevOps 镜像文档

!DevOps 流水线

镜像概述

本镜像为H2020项目提供完整的DevOps解决方案，集成开发工具、环境配置、版本控制、分支管理及Docker自动部署流程，支持项目从本地开发到远程生产环境的全生命周期管理，实现开发、测试、部署的自动化与标准化。

核心功能与特性

开发工具集成

• Visual Studio Code：用于代码开发（<[***]>）
• SourceTree：用于源代码版本管理（<[***]>）

环境依赖管理

• Node.js：通过Node Version Manager (nvm) 管理，指定版本v10.15.0
• MongoDB：数据库服务，版本4.0.5，配套MongoDB Compass可视化工具

版本与分支管理

• 基于Git-flow工作流，支持develop分支本地开发、远程提交及向master分支推送发布

自动化部署

• DockerHub自动构建：监测GitHub仓库更新，自动构建镜像tydius/rezbuild
• 自动更新机制：通过ouroboros工具实现生产环境Docker容器自动拉取并运行最新镜像

使用场景

• 项目开发团队进行本地代码开发、测试与调试
• 团队协作中的版本控制与分支管理
• 生产环境的自动化部署与版本更新
• 项目从开发到上线的全流程标准化管理

使用方法

环境准备

Node.js 安装

1. 安装Windows版Node Version Manager (nvm)：https://github.com/coreybutler/nvm-windows
2. 启用nvm：nvm on
3. 安装Node.js v10.15.0：nvm install 10.15.0
4. 查看已安装版本：nvm list
5. 切换至v10.15.0：nvm use 10.15.0

MongoDB 安装

1. 安装Windows版MongoDB 4.0.5：<[***]>
2. 安装MongoDB Compass（可视化工具）：<[***]>
3. 打开MongoDB Compass，连接至localhost:27017
4. 创建rezbuild数据库

项目克隆

1. 打开SourceTree，点击「Clone」选项卡
2. 在「Source Path / URL」字段输入仓库地址：https://gitlab.estia.fr/m.daniel/rezbuild.git
3. 填写其他必要字段（如本地存储路径）
4. 点击「Clone」按钮，等待克隆完成
5. 点击「Git-flow」选项卡，点击「Ok」按钮初始化Git-flow工作流

本地develop分支开发

安装本地依赖

1. 打开Visual Studio Code，点击「Terminal > New Terminal」
2. 进入公共依赖目录：cd local/common
3. 安装依赖：npm install
4. ⚠️ 若common目录代码有变更，需执行：npm pack
5. 进入前端项目目录：cd ../react-trello
6. 安装依赖：npm install
7. ⚠️ 若react-trello目录代码有变更，需执行：npm pack

运行API服务

1. 打开新终端：「Terminal > New Terminal」
2. 进入API目录：cd api
3. 安装依赖：npm install
4. 开发环境运行：npm run dev
5. ⚠️ 生产环境测试：npm start

运行应用服务

1. 打开新终端：「Terminal > New Terminal」
2. 进入应用目录：cd app
3. 安装依赖：npm install
4. 开发环境运行：npm run dev
5. ⚠️ 生产环境测试：npm run build && npm start

远程保存develop分支

1. 打开SourceTree，点击「BRANCHES > develop」
2. 依次执行：「File Status > Stage All > Push changes... > Commit」提交并推送变更

推送develop分支至master分支（发布流程）

1. 打开SourceTree，点击「BRANCHES > develop」
2. 依次执行：「File Status > Stage All > Push changes... > Commit」提交并推送最新变更
3. 点击「Git-flow > Start New Release」，输入发布名称并完成配置
4. 点击「Git-flow > Finish Release」，输入发布名称完成发布流程

发布后将自动更新ESTIA托管的生产环境（访问地址：<[]>、<[]>、<[***]>）：

1. DockerHub自动构建：监测GitHub仓库更新，构建最新镜像tydius/rezbuild（https://hub.docker.com/r/tydius/rezbuild）
2. ESTIA服务器通过ouroboros工具（https://github.com/pyouroboros/ouroboros）自动拉取并运行最新镜像

本地测试Docker镜像

运行项目镜像

bash
docker run -p 3000:3000 -p 3001:3001 -p 27017:27017 -p 8081:8081 --name rezbuild tydius/rezbuild

启动自动更新工具

bash
docker run -d --name ouroboros -v /var/run/docker.sock:/var/run/docker.sock pyouroboros/ouroboros