hugo

镜像概述和主要用途

基于distroless/cc的hugo-extended静态网站生成器Docker镜像。hugo是一款高性能静态网站生成工具，本镜像提供了hugo-extended版本的运行环境，可作为多阶段构建流程中的构建器，也可在开发阶段通过交互式方式运行，实现实时预览网站效果。镜像源码托管于GitHub的backplane/conex仓库。

核心功能和特性

• hugo-extended支持：内置hugo-extended版本，提供完整功能支持，包括Sass/SCSS编译等扩展能力
• 轻量级基础：基于distroless/cc镜像构建，减少冗余依赖，提升镜像安全性和运行效率
• 双场景适配：同时支持开发阶段的交互式运行（含实时预览）和生产环境的多阶段构建流程
• 无缝集成：可通过简单配置替代本地hugo二进制文件，或直接嵌入Docker构建流程

使用场景和适用范围

• 本地交互式开发：开发静态网站时，通过容器运行hugo server，实时预览页面修改效果
• Docker多阶段构建：在CI/CD流程中作为构建阶段，生成静态文件后部署至nginx等Web服务器

详细使用方法和配置说明

交互式使用

以下shell函数可替代本地hugo二进制文件，实现通过容器运行hugo的效果：

sh
hugo() {
  insert=""
  if [ "$1" = "server" ] || [ "$1" = "serve" ]; then
    shift;
    insert="server --bind 0.0.0.0 --port 1313"
  fi

  # shellcheck disable=SC2086
  docker run \
    --rm \
    --interactive \
    --tty \
    --volume "$(pwd):/work" \
    --publish "1313:1313" \
    backplane/hugo \
    hugo \
      $insert \
      "$@"
}

将上述函数添加至shell配置文件（如.bashrc、.zshrc）后，即可像使用本地hugo一样操作：

sh
# 生成静态网站
$ hugo

# 启动实时预览服务器（包含草稿内容）
$ hugo serve -D

作为构建阶段

在Docker多阶段构建中，可将本镜像作为构建阶段生成静态文件，再部署至Web服务器：

Dockerfile
# 构建阶段：使用hugo生成静态文件
FROM backplane/hugo as builder
COPY . .
RUN hugo

# 部署阶段：将静态文件复制到nginx
FROM nginx:1-alpine as server
COPY --from=builder /work/public/ /usr/share/nginx/html/

上述配置会在构建阶段通过hugo生成静态文件（输出至/work/public/目录），并在部署阶段将生成的文件复制到nginx的默认网站目录，实现静态网站的高效部署。