Este artículo detallará cómo crear una imagen de Docker.

Principio

  1. Utilice Hugo para crear el sitio y generar archivos estáticos.
  2. Utilice Nginx como servidor para manejar solicitudes.

Archivo Docker

Cree un Dockerfile en la raíz del sitio.

 1###############
 2# Build Stage #
 3###############
 4FROM razonyang/hugo 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
  • Hay dos etapas para la construcción, una etapa de construcción y una etapa de lanzamiento. La etapa de lanzamiento contiene solo los archivos estáticos generados, manteniendo el tamaño de la imagen de Docker lo más pequeño posible.
  • Si tiene defaultContentLanguageInSubdir habilitado, descomente y modifíquelo a pedido.
  • El parámetro HUGO_BASEURL se usa para especificar el baseURL del sitio durante la compilación y generalmente se usa cuando baseURL es diferente de la configuración, por lo que puede eliminarlo usted mismo si no lo necesita.
  • HUGO_MODULE_PROXY y NPM_CONFIG_REGISTRY son parámetros de compilación opcionales que se pueden eliminar si no son necesarios.

Nginx

Cree un deploy/nginx/default.conf en la raíz del sitio:

 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}

Construir

1$ docker build -t mysite \
2  --build-arg HUGO_BASEURL=https://example.com \
3  .
  • mysite: el nombre de la imagen.
  • HUGO_BASEURL: el baseURL.

Para los usuarios ubicados en China continental, deben especificar HUGO_MODULE_PROXY y NPM_CONFIG_REGISTRY para crear la imagen de manera exitosa y rápida:

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  .

Implementación

Hay muchas formas de implementar imágenes de Docker, como docker run, k8s, etc. Este artículo solo explicará docker run.

Correr

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

Para pruebas locales, debe cambiar el parámetro baseURL o el parámetro de compilación HUGO_BASEURL, p. http://localhost:2333.

Detener

1$ docker stop mysite

Comenzar

1$ docker start mysite

Eliminar

1$ docker rm mysite