lzocateli/hugo repository overview

⁠Hugo Extended

Hugo Extended reproduzível e compartilhado pelos projetos Blog zocate.li e ThothisIT. A imagem substitui as unidades específicas blog-hugo e thothis-hugo, fixa a base por digest e executa sem root.

⁠Referência da imagem

⁠Conteúdo e finalidade

⁠Incluído

• Hugo Extended 0.165.0-DEV, commit 8a468df065a7, para Linux amd64.
• npm CLI 12.0.2, atualizado sobre a base para usar node-tar corrigido.
• Usuário não root hugo e diretório de trabalho /src.
• Suporte a transformação Sass exigido pelos dois consumidores.

⁠Não incluído

• Código-fonte ou conteúdo dos sites consumidores.
• Timezone específico; Blog e ThothisIT configuram TZ no ambiente de execução.
• Servidor HTTP de produção; publique os arquivos estáticos com um runtime dedicado.
• Secrets, configuração de ambiente ou dados persistentes.

⁠Início rápido

docker pull lzocateli/hugo:exts-0.165.0-dev.8a468df-1
docker run --rm lzocateli/hugo:exts-0.165.0-dev.8a468df-1 version

Para construir um site no diretório atual:

docker run --rm \
  --volume "${PWD}:/src" \
  lzocateli/hugo:exts-0.165.0-dev.8a468df-1 \
  hugo --gc --minify --cleanDestinationDir

⁠Docker Compose

services:
  hugo:
    image: lzocateli/hugo:exts-0.165.0-dev.8a468df-1
    command: server --bind 0.0.0.0 --port 1313 --buildDrafts
    environment:
      TZ: America/Sao_Paulo
    ports:
      - "127.0.0.1:1313:1313"
    volumes:
      - .:/src

⁠Configuração

A imagem não adiciona variáveis de ambiente. Argumentos, subcomandos Hugo e o formato legado hugo <argumentos> são encaminhados pelo entrypoint herdado.

⁠Persistência e mounts

O bind mount deve permitir leitura e escrita ao UID/GID 1000:1000. Em CI, prefira origem somente leitura e destino de publicação separado e gravável.

⁠Segurança

• Execução padrão sem root como hugo (1000:1000).
• Nenhuma capacidade Linux adicional é necessária.
• Builds finitos aceitam root filesystem somente leitura quando /tmp e o destino de publicação são graváveis.
• O npm da base é atualizado de forma reproduzível para remover vulnerabilidade crítica corrigível em node-tar.
• A porta do servidor de desenvolvimento deve ser publicada somente em localhost.
• A base é fixada por tag e digest; sua atualização exige nova tag imutável e nova validação.

⁠Build local

docker buildx build \
  --pull \
  --platform linux/amd64 \
  --load \
  --tag local/hugo:exts-0.165.0-dev.8a468df-1 \
  hugo

⁠Tags e compatibilidade

A tag preserva o prefixo público exts- da imagem lzocateli/hugo. Mudanças de Hugo, base, usuário, entrypoint, porta ou ferramentas geram uma nova tag imutável.

⁠Validação

O smoke test verifica versão, edição Extended, usuário padrão, root filesystem somente leitura e build Sass minificado com fixture sintética:

bash hugo/scripts/smoke-test.sh --image local/hugo:exts-0.165.0-dev.8a468df-1

O catálogo executa esse teste na validação contínua e antes da publicação. O workflow também valida o Dockerfile com BuildKit, bloqueia vulnerabilidades CRITICAL corrigíveis e gera SBOM e proveniência na release.

⁠Publicação

Use Actions > Publicar imagem de container > Run workflow com:

• context_path: hugo;
• image_name: hugo;
• image_tag: exts-0.165.0-dev.8a468df-1;
• dockerfile: Dockerfile;
• platforms: linux/amd64.

Push e publicação exigem solicitação explícita e credenciais já configuradas.

⁠Operação

A imagem não mantém estado nem requer backup próprio. Para rollback, restaure no consumidor a tag ou o digest imutável anterior. Logs são emitidos pelo processo Hugo em stdout e stderr.

⁠Troubleshooting

⁠Limitações conhecidas

• Publicação restrita a linux/amd64 enquanto essa for a plataforma validada pelos consumidores.
• O servidor embutido do Hugo é destinado somente ao desenvolvimento.
• A base é uma build oficial pré-release, fixada por digest e commit, adotada porque a última release estável disponível contém vulnerabilidade CRITICAL corrigível. Substitua-a por uma release estável assim que uma versão posterior corrigida estiver disponível.

⁠Licenças e fontes

O badge MIT descreve somente o conteúdo original deste repositório. A imagem inclui componentes de terceiros que permanecem sujeitos aos termos e avisos de suas fontes. Consulte a política de licenciamento⁠ e preserve as atribuições upstream.

⁠Histórico de alterações

• exts-0.165.0-dev.8a468df-1: consolida Blog e ThothisIT em uma imagem Hugo Extended compartilhada, sem root e com smoke test funcional.