jekyll/minimal

Jekyll Docker 镜像（最小版本）

镜像概述

Jekyll Docker 镜像（最小版本）是官方Jekyll镜像的精简版本，旨在提供轻量级的Docker环境，用于构建和运行Jekyll静态网站。该镜像保留了Jekyll的核心功能，同时优化了体积，适合快速部署、开发环境搭建及CI/CD流程集成。

核心功能与特性

• 轻量级设计：相比官方完整镜像体积更小，启动更快，资源占用更低
• 完整核心功能：支持Jekyll的核心构建能力，包括Markdown解析、Liquid模板引擎和静态文件生成
• 灵活配置：通过环境变量和命令参数自定义Jekyll构建行为
• 多平台支持：兼容常见的Docker运行环境，包括Linux、macOS和Windows（WSL2）
• 即开即用：无需本地安装Ruby和Jekyll依赖，直接通过Docker命令启动开发或构建流程

使用场景与适用范围

• 本地开发环境：快速搭建隔离的Jekyll开发环境，避免依赖冲突
• CI/CD流程：集成到自动化构建 pipeline，用于静态网站的持续构建和部署
• 小型网站部署：直接作为轻量级Web服务运行生成的静态站点
• 教学与演示：快速展示Jekyll的使用方法，无需复杂的环境配置

使用方法与配置说明

基本使用（Docker Run）

1. 构建Jekyll站点

在站点目录中执行以下命令，生成静态文件到_site目录：

bash
docker run --rm -v $(pwd):/srv/jekyll envygeeks/jekyll:latest jekyll build

2. 启动开发服务器

启动本地开发服务器，监听4000端口并实时刷新：

bash
docker run --rm -v $(pwd):/srv/jekyll -p 4000:4000 envygeeks/jekyll:latest jekyll serve --host 0.0.0.0

Docker Compose 配置示例

创建docker-compose.yml文件：

yaml
version: '3'
services:
  jekyll:
    image: envygeeks/jekyll:latest
    volumes:
      - ./:/srv/jekyll
    ports:
      - "4000:4000"
    command: jekyll serve --host 0.0.0.0

启动服务：

bash
docker-compose up

常用命令

• 构建站点（包含草稿）：jekyll build --drafts
• 清理生成文件：jekyll clean
• 检查站点配置：jekyll doctor
• 生成并预览站点：jekyll serve --watch

环境变量配置

持久化与数据卷

为避免重复安装依赖，可将Bundler缓存目录挂载为卷：

bash
docker run --rm -v $(pwd):/srv/jekyll -v jekyll_bundle:/usr/local/bundle envygeeks/jekyll:latest jekyll build

（jekyll_bundle为命名卷，需提前创建：docker volume create jekyll_bundle）

注意事项

• 首次运行时会自动安装Gemfile中指定的依赖，可能需要较长时间
• 生产环境建议使用JEKYLL_ENV=production构建，以启用优化选项
• Windows系统中路径需使用绝对路径（如/c/Users/username/site）而非$(pwd)
• 若站点依赖原生扩展（如nokogiri），可能需要额外配置构建环境