KennethCheng
f81047f9c9
NAS 部署时 builder 阶段 `go mod download` 失败: go: go.mod requires go >= 1.26.0 (running go 1.22.12; GOTOOLCHAIN=local) 根因:今天早上 `go mod tidy` 用本机 Go 1.27.0 跑,`go.mod` 的 go 指令 被写到 1.26.0(`go mod tidy` 行为:用当前 toolchain 的 minor), 但 `fuellog-api/Dockerfile` 写死 `FROM golang:1.22-alpine`,base 自带 Go 1.22.12,跟 go.mod 不一致 → Go 工具链自检不通过,go mod download 直接 exit 1。 GOTOOLCHAIN=local 也是这个错的成因:容器内默认不下载更新 toolchain, 如果 go.mod 要求的版本高于 base,会拒绝构建。要么升 base,要么放开 GOTOOLCHAIN=auto 走网络下载新工具链。升 base 是更确定的做法(无网也跑)。 修法:把 builder 阶段的 `FROM golang:1.22-alpine` 改成 `FROM golang:1.27-alpine`(与本机一致,与 go.mod 要求 >=1.26 都满足)。 runner 阶段 (alpine:3.20) 不需要 Go,不动。 未做(留待后续): - 用 ARG 让 base Go 版本参数化,后续 `go mod tidy` 升 go.mod 时同步 Dockerfile base。短期先写死 1.27 - 同样的"go.mod vs Dockerfile base"漂移问题可能在 web 那边再出现 (目前 web 用 node:20-alpine,本机 node 24,node 不会因 minor 不一致 拒绝 npm install,暂时没风险)
59 lines
1.6 KiB
Docker
59 lines
1.6 KiB
Docker
# 多阶段构建:builder 出静态二进制,runner 极简
|
|
# Builder
|
|
# 注:go.mod 的 go 指令是 1.26.0(本机 go mod tidy 用 Go 1.27 写入),
|
|
# base image 必须 >= 1.26,否则 go mod download 会因 GOTOOLCHAIN=local 失败
|
|
FROM golang:1.27-alpine AS builder
|
|
|
|
# 国内构建场景下可换成 aliyun / tencent 镜像
|
|
# RUN sed -i 's|dl-cdn.alpinelinux.org|mirrors.aliyun.com|g' /etc/apk/repositories
|
|
|
|
# CGO=0 出纯静态二进制,目标 alpine 不用 glibc
|
|
ENV CGO_ENABLED=0 GOOS=linux GOARCH=amd64 \
|
|
GOPROXY=https://goproxy.cn,direct \
|
|
GOSUMDB=sum.golang.google.cn
|
|
|
|
WORKDIR /src
|
|
|
|
# 先拷贝 go.mod/go.sum 利用 Docker layer 缓存
|
|
COPY go.mod go.sum ./
|
|
RUN go mod download
|
|
|
|
# 拷贝源码并构建
|
|
COPY . .
|
|
RUN CGO_ENABLED=0 go build -trimpath -ldflags="-s -w" -o /out/server ./cmd/server
|
|
|
|
# Runner
|
|
FROM alpine:3.20
|
|
|
|
# 时区(中国用户)+ tini 收僵尸进程
|
|
RUN apk add --no-cache ca-certificates tzdata tini && \
|
|
cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
|
|
echo "Asia/Shanghai" > /etc/timezone
|
|
|
|
# 非 root 运行
|
|
RUN addgroup -S fuellog && adduser -S -G fuellog fuellog
|
|
|
|
WORKDIR /app
|
|
COPY --from=builder /out/server /app/server
|
|
|
|
# 数据目录(SQLite)
|
|
RUN mkdir -p /data && chown -R fuellog:fuellog /data /app
|
|
USER fuellog
|
|
|
|
ENV SERVER_ADDR=:8080 \
|
|
GIN_MODE=release \
|
|
DB_PATH=/data/fuellog.db \
|
|
TZ=Asia/Shanghai
|
|
|
|
EXPOSE 8080
|
|
|
|
# 数据卷挂载点
|
|
VOLUME ["/data"]
|
|
|
|
ENTRYPOINT ["/sbin/tini", "--"]
|
|
CMD ["/app/server"]
|
|
|
|
# 健康检查(用 wget,alpine 自带 busybox;或用 curl apk add)
|
|
HEALTHCHECK --interval=30s --timeout=3s --start-period=10s --retries=3 \
|
|
CMD wget -q -O- http://127.0.0.1:8080/health > /dev/null || exit 1
|