noelmiller/publish-hugo-website

noelmiller/publish-hugo-website 镜像说明

镜像概述

该镜像用于自动化构建和部署基于Hugo的静态网站，通过整合Docker、Traefik、WatchTower、Ansible等工具，实现从代码提交到网站上线的全流程自动化，包括静态资源压缩、HTTPS证书管理及容器自动更新等功能。

核心功能

1. 自动化构建：结合Github与DockerHub，代码提交后自动构建镜像并更新网站
2. HTTPS支持：通过Traefik集成Let's Encrypt，自动生成和管理SSL证书
3. 自动更新：使用WatchTower监控DockerHub镜像更新，自动拉取并重启容器
4. 静态资源优化：集成Minify工具压缩HTML、CSS、JS文件，提升加载速度
5. 基础设施即代码：通过Ansible实现服务器环境快速配置与部署

使用场景

• 个人博客或静态网站的自动化部署与维护
• 需要持续部署、HTTPS加密及自动更新功能的静态站点项目

配置说明

1. 环境依赖：需安装Docker和Docker Compose
2. 配置文件：准备docker-compose.yml，配置Hugo、Traefik、WatchTower服务
3. 域名设置：将域名解析到服务器IP，并在Traefik配置中指定域名

部署示例

Docker Compose配置

yaml
version: '3'
services:
  hugo-site:
    image: noelmiller/publish-hugo-website
    labels:
      - "traefik.enable=true"
      - "traefik.http.routers.hugo-site.rule=Host(`your-domain.com`)"
      - "traefik.http.routers.hugo-site.tls=true"
      - "traefik.http.routers.hugo-site.tls.certresolver=letsencrypt"
  
  traefik:
    image: traefik:v2.9
    command:
      - "--providers.docker=true"
      - "--entrypoints.web.address=:80"
      - "--entrypoints.websecure.address=:443"
      - "--certificatesresolvers.letsencrypt.acme.httpchallenge=true"
      - "--certificatesresolvers.letsencrypt.acme.email=your-email@example.com"
      - "--certificatesresolvers.letsencrypt.acme.storage=/acme.json"
    ports: ["80:80", "443:443"]
    volumes: ["/var/run/docker.sock:/var/run/docker.sock", "./acme.json:/acme.json"]
  
  watchtower:
    image: containrrr/watchtower
    volumes: ["/var/run/docker.sock:/var/run/docker.sock"]
    command: --interval 300

部署步骤

1. 创建空acme.json并设置权限：touch acme.json && chmod 600 acme.json
2. 修改配置中的域名和***信息
3. 启动服务：docker-compose up -d