jbosstools/jbosstools-website

jbosstools/jbosstools-website Docker镜像文档

镜像概述

jbosstools/jbosstools-website是一个用于构建和测试tools.jboss.org网站的Docker镜像。该网站基于Awestruct框架开发，通过Git和Ruby技术栈实现。使用此镜像可快速搭建本地开发环境，无需手动配置复杂依赖，实现网站的本地预览和测试。

核心功能与特性

• 环境隔离：提供独立的容器环境，避免本地系统依赖冲突
• 简化构建流程：集成Git、Ruby等必要工具，一键启动开发环境
• 本地预览支持：通过内置Web服务器提供网站实时预览
• 跨平台兼容：支持Linux、macOS等系统，解决不同平台依赖差异问题

使用场景

• 网站开发人员本地测试页面修改效果
• 贡献者快速搭建开发环境以提交代码
• CI/CD流程中验证网站构建结果
• 学习Awestruct框架的示例环境

使用方法

前提条件

• 已安装Docker引擎
• 已安装Git

Docker部署步骤

1. 拉取镜像

bash
docker pull jbosstools/jbosstools-website

2. 克隆网站源代码

bash
git clone https://github.com/jbosstools/jbosstools-website
cd jbosstools-website

3. 启动容器

常规系统：

bash
docker run -it --rm -p 4242:4242 -v `pwd`:/jbosstools-website jbosstools/jbosstools-website /bin/bash

Linux (SELinux/Fedora)系统（解决权限问题）：

bash
docker run -it --rm -p 4242:4242 -v `pwd`:/jbosstools-website:Z jbosstools/jbosstools-website /bin/bash

4. 容器内构建与预览

进入容器后执行以下命令：

bash
# 进入工作目录
cd /jbosstools-website

# 安装依赖（如需要）
yum install ruby -y  # 仅在必要时执行
gem install bundler && bundle install  # 仅在必要时执行

# 清理并启动预览服务
rake clean preview

5. 访问网站

在浏览器中访问：http://$DOCKER_HOST:4242（其中$DOCKER_HOST为Docker主机IP，本地环境通常为localhost）

注意事项

• 依赖安装：大部分情况下无需手动安装Ruby和Bundler，仅在容器环境缺少相关组件时执行安装命令
• 文件更新：修改网站内容后，预览服务会自动检测并更新，无需重启服务（_partials文件和front-matters变更除外）
• 性能优化：若Linux系统下预览速度较慢，可使用替代方案：

  bash
  # 启动自动构建
  awestruct --auto -P development
  
  # 并行启动Python简易服务器
  cd _site
  python -m SimpleHTTPServer 4242
  

配置参数

网站配置文件位于_config/site.yml，主要参数说明：

许可证

网站示例代码采用EPL许可证发布。提交代码即表示同意按上述许可证授权你的贡献。

致谢

本网站使用https://github.com/jbossorg/bootstrap-community%E6%A1%86%E6%9E%B6%E6%9E%84%E5%BB%BA%EF%BC%8C%E6%96%87%E6%A1%A3%E5%9F%BA%E4%BA%8Ehttps://github.com/hibernate/hibernate.org/blob/hibernate-rebase-of-jbossorg/README.adoc%E7%BC%96%E5%86%99%E3%80%82