Jekyll Docker镜像文档

镜像概述和主要用途

本镜像旨在简化Jekyll网站的Docker化部署流程。Jekyll作为流行的静态站点生成器，其依赖的部分Ruby gems需要C++库支持，手动配置这些依赖环境较为繁琐。本镜像已预先安装Jekyll和Bundle，并配置了必要的C++库环境，用户可直接基于此镜像构建和运行Jekyll网站，大幅减少环境配置工作量。

核心功能和特性

• 预装核心工具：已集成Jekyll和Bundle，无需额外安装即可使用
• 依赖环境处理：预先配置Jekyll所需的C++库，解决gem安装时的底层依赖问题
• 简化构建流程：支持标准Jekyll项目的构建命令，与原生开发流程兼容
• 轻量易用：镜像设计简洁，专注于核心功能，适合快速上手

使用场景和适用范围

• 个人博客/静态站点开发者：需要将Jekyll项目容器化部署的用户
• CI/CD流程集成：可作为Jekyll网站自动化构建的基础镜像
• 环境一致性需求：希望在不同环境中保持统一Jekyll运行环境的团队或个人
• 新手友好：适合不熟悉Jekyll底层依赖配置的用户快速入门

详细使用方法和配置说明

前提条件

• 已安装Docker环境
• 本地存在Jekyll项目（包含Gemfile等必要文件）

部署步骤

1. 创建Dockerfile

在Jekyll项目根目录下创建Dockerfile，内容如下：

FROM sylhare/jekyll:latest

# 设置工作目录
WORKDIR /app

# 复制项目文件到容器
COPY . /app

# 安装项目依赖gems
RUN bundle install

# 暴露Jekyll默认服务端口
EXPOSE 4000

# 启动Jekyll服务（绑定所有网络接口，允许外部访问）
CMD ["bundle", "exec", "jekyll", "serve", "--host", "0.0.0.0"]

2. 构建镜像

在项目根目录执行以下命令构建Docker镜像：

docker build -t my-jekyll-site .

（my-jekyll-site可替换为自定义镜像名称）

3. 运行容器

构建完成后，运行容器以启动Jekyll网站：

docker run -p 4000:4000 my-jekyll-site

• -p 4000:4000：将容器内4000端口映射到主机4000端口
• 访问http://localhost:4000即可查看运行中的Jekyll网站

配置说明

• 端口映射：默认暴露4000端口（Jekyll默认服务端口），可通过-p参数自定义主机端口映射
• 项目文件更新：若需实时同步本地项目文件到容器，可使用挂载卷：

  docker run -p 4000:4000 -v $(pwd):/app my-jekyll-site
  

• 自定义Jekyll命令：可通过docker run时覆盖CMD参数修改启动命令，例如指定生产环境构建：

  docker run my-jekyll-site bundle exec jekyll build --destination _site
  

注意事项

• 确保项目根目录存在Gemfile和Gemfile.lock，以保证bundle install正确安装依赖
• 若项目使用自定义Jekyll配置（如_config.yml），无需额外修改Dockerfile，复制后会自动生效
• 对于大型项目，建议在.dockerignore中排除_site、.git等无需打包的目录，减小镜像体积