bitcraze/web-builder

Bitcraze Web构建器镜像

镜像概述和主要用途

Bitcraze web builder镜像是用于构建Bitcraze Web项目的专用镜像，包含开发、构建和运行Web项目所需的全部工具。其核心目的是减少语言和框架的安装问题，简化构建流程，并确保在一台机器上通过的构建在另一台机器上也能成功运行。目前该镜像支持Ruby和PHP。

核心功能和特性

• 全工具链集成：内置开发、构建和运行Web项目所需的所有工具，无需额外安装依赖
• 跨环境一致性：确保不同机器上的构建结果一致，解决"在我机器上能运行"的问题
• 多语言支持：当前支持Ruby和PHP开发环境
• 灵活挂载：默认工作目录为/module，支持将本地目录挂载为卷进行开发和构建

使用场景和适用范围

• Bitcraze Web项目的日常开发
• Web项目的构建和测试流程
• 本地文档预览和开发（基于Jekyll主题）
• 需要一致构建环境的团队协作场景

使用方法和配置说明

构建项目

标准使用场景是调用项目中的构建或测试脚本：

bash
docker run --rm -it -v ${PWD}:/module bitcraze/web-builder tools/build/build

开发环境

该镜像也可用于Web项目开发过程中运行服务器，通常通过项目中的脚本调用。

镜像结构

镜像的默认工作目录为/module，可通过以下命令验证：

bash
docker run --rm bitcraze/web-builder pwd

输出结果为：

/module

交互式使用

如需以交互方式使用容器，并将当前目录挂载到/module：

bash
docker run --rm -it -v ${PWD}:/module bitcraze/builder bash

Docs主题使用

docs-theme目录包含一个简单的Jekyll主题，用于在编写文档时本地服务仓库的docs目录。示例用法：

bash
docker run --rm -it --volume=$PWD/docs:/module -p 80:80 bitcraze/web-builder jekyll serve --host 0.0.0.0 --port 80 --incremental --config /docs-config.yml