Files
FuelLog/deploy/docker-compose.dev.yml
T
KennethCheng c64f1d6b2b fix(backend): Dockerfile 升 Go base image 到 1.27-alpine 匹配 go.mod
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,暂时没风险)
2026-09-13 18:40:35 +08:00

50 lines
1.2 KiB
YAML

# FuelLog 开发模式
# 用法:
# docker compose -f deploy/docker-compose.dev.yml up
# 行为:
# api 镜像里跑二进制,但 bind mount 本地源码,改完 go 重新 build 一次才能生效
# 适合:本机没装 Go / 想在 Linux 容器里跑 / 跟其它人共享依赖环境
# 不适合:日常前端 dev(请直接 pnpm dev,挂 nginx 容器是绕远路)
services:
api:
build:
context: ../fuellog-api
dockerfile: Dockerfile
image: fuellog/api:dev
container_name: fuellog-api-dev
environment:
GIN_MODE: debug
DB_PATH: /data/fuellog.db
TZ: Asia/Shanghai
LOG_LEVEL: debug
volumes:
- fuellog-dev-data:/data
networks:
- fuellog-net
expose:
- "8080"
web:
image: nginx:1.27-alpine
container_name: fuellog-web-dev
depends_on:
- api
ports:
- "8080:80"
volumes:
# dev 期把本地 build 产物挂到 nginx 静态目录
# 用法:cd fuellog-web && pnpm build,然后 docker compose restart web
- ../fuellog-web/dist:/usr/share/nginx/html:ro
- ../fuellog-web/nginx/web.conf:/etc/nginx/conf.d/web.conf:ro
networks:
- fuellog-net
networks:
fuellog-net:
driver: bridge
volumes:
fuellog-dev-data:
name: fuellog-dev-data