umputun/baseimage

baseimage

轻量级Docker基础镜像集合，提供三种镜像用于构建和部署服务与应用。

https://github.com/umputun/baseimage/workflows/build/badge.svg](https://github.com/umputun/baseimage/actions)

镜像概述

提供三种镜像：

1. Go构建镜像 - umputun/baseimage:buildgo-latest：用于构建阶段，包含Go编译器和代码检查工具，基于Alpine
2. 应用基础镜像 - umputun/baseimage:app-latest：轻量级应用运行时基础镜像
3. Scratch基础镜像 - umputun/baseimage:scratch-latest：基于scratch的极简基础镜像

Go构建镜像

镜像 umputun/baseimage:buildgo-latest 和 ghcr.io/umputun/baseimage/buildgo:latest 用于多阶段Dockerfile中构建Go应用和服务。

核心特性

• 基于官方 https://hub.docker.com/_/golang/ 镜像，体积相对较小
• 强制设置 CGO_ENABLED=0
• 预装并配置就绪的 https://github.com/golangci/golangci-lint 代码检查工具
• 包含构建和测试常用包：https://github.com/stretchr/testify%E3%80%81https://github.com/vektra/mockery 和 https://github.com/matryer/moq
• 集成 https://github.com/goreleaser/ 和 https://github.com/rakyll/statik
• 提供 https://github.com/mattn/goveralls 及 coverage.sh 脚本，便于覆盖率报告
• /script/version.sh 脚本用于生成基于git的版本信息

应用基础镜像

镜像 umputun/baseimage:app-latest 和 ghcr.io/umputun/baseimage/app:latest 设计为轻量级、即用型服务基础镜像，在常规 https://hub.docker.com/_/alpine/ 基础上增加了以下特性：

• ENTRYPOINT /init.sh 通过 https://github.com/Yelp/dumb-init/ 运行 CMD
• 容器命令以 app 用户（uid为 $APP_UID，默认1001）运行，默认非root执行
• 若自定义容器提供 /srv/init.sh，则会自动运行该脚本
• 预安装包：tzdata、curl、su-exec、ca-certificates 和 openssl
• 创建 app 用户（uid=1001）
• 可选使用 /init-root.sh 以root用户运行命令

运行时自定义

可通过Docker命令行或 docker-compose.yml 设置环境变量来自定义容器：

• TIME_ZONE：设置容器时区，默认"America/Chicago"（scratch镜像需使用 TZ 环境变量）
• APP_UID：app 用户的UID，默认1001

使用示例

多阶段构建Dockerfile示例（使用buildgo和app镜像）

docker
FROM umputun/baseimage:buildgo as build

WORKDIR /build
ADD . /build

RUN go test -mod=vendor ./...
RUN golangci-lint run --out-format=tab --tests=false ./...

RUN \
    revison=$(/script/git-rev.sh) && \
    echo "revision=${revison}" && \
    go build -mod=vendor -o app -ldflags "-X main.revision=$revison -s -w" .


FROM umputun/baseimage:app

COPY --from=build /build/app /srv/app

EXPOSE 8080
WORKDIR /srv

CMD ["/srv/app", "param1", "param2"]

此Dockerfile将构建一个以 app 用户运行 /srv/app（带参数）的容器。

自定义时区和UID示例

bash
docker run -e TIME_ZONE=America/New_York -e APP_UID=2000 <image>

Scratch基础镜像

镜像 umputun/baseimage:scratch-latest（或 ghcr.io/umputun/baseimage/scratch）在空镜像 scratch 基础上增加了以下内容：

• 时区信息文件，允许更改运行中应用的时区
• SSL证书（ca-certificates）
• /etc/passwd 和 /etc/groups 中添加 app 用户及组（UID:1001，GID:1001）
• /nop 程序，用于永久等待且不执行任何操作

容器默认以 app 用户运行，工作目录为 /srv，无入口点。可通过 TZ 环境变量更改时区。

镜像体积约1M，适用于构建极致轻量的容器。