本文將詳細介紹如何構建 Docker 鏡像。

原理

  1. 使用 Hugo 構建站點，生成靜態文件。
  2. 使用 Nginx 作為服務器，處理請求。

Dockerfile

於根目錄創建 Dockerfile：

 1###############
 2# Build Stage #
 3###############
 4FROM klakegg/hugo:ext-ubuntu as builder
 5
 6WORKDIR /src
 7COPY . /src
 8
 9ARG HUGO_ENV=production
10ENV HUGO_ENV=${HUGO_ENV}
11
12# Base URL
13ARG HUGO_BASEURL=/
14ENV HUGO_BASEURL=${HUGO_BASEURL}
15
16# Module Proxy
17ARG HUGO_MODULE_PROXY=
18ENV HUGO_MODULE_PROXY=${HUGO_MODULE_PROXY}
19
20# NPM mirrors, such as https://registry.npmmirror.com
21ARG NPM_CONFIG_REGISTRY=
22ENV NPM_CONFIG_REGISTRY=${NPM_CONFIG_REGISTRY}
23
24# Install dependencies
25RUN npm install
26RUN npm install -g @fullhuman/postcss-purgecss rtlcss
27
28# Build site
29RUN hugo --minify --gc --enableGitInfo
30
31# Set the fallback 404 page if defaultContentLanguageInSubdir is enabled, please replace the `en` with your default language code.
32# RUN cp ./public/en/404.html ./public/404.html
33
34###############
35# Final Stage #
36###############
37FROM nginx
38COPY --from=builder /src/public /app
39COPY deploy/nginx/default.conf /etc/nginx/conf.d/default.conf
  • 構建一共有兩個階段，一個構建階段，一個發布階段。發布階段僅包含生成的靜態文件，盡可能地降低 Docker 鏡像大小。
  • 如果你開啟了 defaultContentLanguageInSubdir，請取消對應的註釋和按需修改。
  • HUGO_BASEURL 參數用於構建期間指定站點的 baseURL，一般用於 baseURL 不同於配置的情況，如果不需要可以自行刪除。
  • HUGO_MODULE_PROXY 和 NPM_CONFIG_REGISTRY 都是可選的構建參數，不需要可以自行刪除。

Nginx

於根目錄創建 deploy/nginx/default.conf：

 1server {
 2    listen       80;
 3    listen  [::]:80;
 4    server_name  localhost;
 5    
 6    root   /app;
 7
 8    location / {
 9        index  index.html index.htm;
10    }
11
12    location ~* ^/([^/]+) {
13        index  index.html index.htm;
14        error_page 404 = @error;
15    }
16
17    error_page 404 /404.html;
18    location @error {
19        try_files /$1/404.html /404.html =404;
20    }
21}

構建

1$ docker build -t mysite \
2  --build-arg HUGO_BASEURL=https://example.com \
3  .
  • mysite：鏡像名稱。
  • HUGO_BASEURL：baseURL。

對於位於中國大陸的用戶，需要指定 HUGO_MODULE_PROXY 和 NPM_CONFIG_REGISTRY，以便成功和快速地構建鏡像:

1$ docker build -t mysite \
2  --build-arg HUGO_BASEURL=https://example.com \
3  --build-arg HUGO_MODULE_PROXY=https://goproxy.cn \
4  --build-arg NPM_CONFIG_REGISTRY=https://registry.npmmirror.com \
5  .

部署

Docker 部署方式很多，如 docker run，k8s 等等，本文僅對 docker run 進行說明。

創建並啟動

1$ docker run \
2  -p 2333:80 \
3  --name mysite \
4  --restart=always \
5  mysite

本地測試時，需要修改 baseURL 參數或者 HUGO_BASEURL 構建參數，如：http://localhost:2333。

停止

1$ docker stop mysite

啟動

1$ docker start mysite

刪除

1$ docker rm mysite