chore(deploy): 基础镜像源改为可配置 BASE_REGISTRY,并提前补齐 FROM 基础镜像
## 修的是什么
线上部署卡死过一次:daocloud 加速源返回 502 Bad Gateway,整轮构建在 load metadata
阶段就失败,而服务器 daemon.json 里另外两个 registry-mirrors 完全帮不上忙。
原因是**显式写死的 registry 会绕过 daemon.json 的 registry-mirrors**:
Dockerfile 里 `FROM docker.m.daocloud.io/library/node:...` 属于显式指定 registry,
镜像列表对它就失效了,于是这个源成了构建的单点故障。
## 修法
1. 四个 Dockerfile(backend / frontend / backend-dev / dev-caddy)的 `FROM` 改用
`${BASE_REGISTRY}`(registry 前缀语义),默认值 docker.m.daocloud.io 保持不变;
2. docker-compose.yml / docker-compose.dev.yml 的 `build.args` 接上
`${BASE_REGISTRY:-docker.m.daocloud.io}`,并把 postgres / minio / node / caddy
这几处 `image:` 也改成同一变量,整套编排只有一个换源开关;
3. 部署脚本:新增 resolve_base_registry()(读 .env 的 BASE_REGISTRY,缺省同 compose),
--dry-run 的基础镜像 digest 预检沿用同一变量;
新增 ensure_dockerfile_base_images(),在 pull_base_images 阶段把 Dockerfile 里
`FROM` 用到的基础镜像提前补齐 —— 这类镜像不归 `docker compose pull` 管,
本地缺失要拖到构建阶段才报错,且报错信息晦涩,看不出来是"源挂了"还是"代码写错了";
现在缺失时明确提示并给出换源/离线搬运两条排障路径;
4. .env.server.example 增加 BASE_REGISTRY 说明(推荐多源容灾时设 docker.io,
走 daemon 的 registry-mirrors 列表自动故障转移)。
## 验证
- docker compose config:默认值下所有镜像引用与改动前逐字一致(不会触发重新下载);
BASE_REGISTRY=docker.1panel.live / docker.io 时全部引用正确替换;
- docker buildx build --call=check -f deploy/docker/backend.Dockerfile:Check complete, no warnings;
- deploy/ubuntu-deploy.sh bash -n 通过;
- 生产实测:预拉三个基础镜像后,buildkit 解析基础镜像 1s 命中本地镜像、不再访问远端。
This commit is contained in:
@@ -6,7 +6,7 @@ x-json-log-rotation: &json-log-rotation
|
||||
|
||||
services:
|
||||
postgres:
|
||||
image: docker.m.daocloud.io/library/postgres:16-bookworm
|
||||
image: ${BASE_REGISTRY:-docker.m.daocloud.io}/library/postgres:16-bookworm
|
||||
command:
|
||||
[
|
||||
"postgres",
|
||||
@@ -51,7 +51,7 @@ services:
|
||||
- postgres_dev_data:/var/lib/postgresql/data
|
||||
|
||||
minio:
|
||||
image: docker.m.daocloud.io/minio/minio:latest
|
||||
image: ${BASE_REGISTRY:-docker.m.daocloud.io}/minio/minio:latest
|
||||
restart: unless-stopped
|
||||
logging: *json-log-rotation
|
||||
command: server /data --address ":9000" --console-address ":9001"
|
||||
@@ -70,6 +70,8 @@ services:
|
||||
context: .
|
||||
dockerfile: deploy/docker/backend-dev.Dockerfile
|
||||
args:
|
||||
# 基础镜像源(registry 前缀),与生产 compose 同一套语义。
|
||||
BASE_REGISTRY: ${BASE_REGISTRY:-docker.m.daocloud.io}
|
||||
DEBIAN_MIRROR: ${DEBIAN_MIRROR:-mirrors.aliyun.com}
|
||||
NPM_REGISTRY: ${NPM_REGISTRY:-https://registry.npmmirror.com}
|
||||
restart: unless-stopped
|
||||
@@ -129,7 +131,7 @@ services:
|
||||
- ./apps/backend/data:/app/data
|
||||
|
||||
frontend:
|
||||
image: docker.m.daocloud.io/library/node:22-bookworm-slim
|
||||
image: ${BASE_REGISTRY:-docker.m.daocloud.io}/library/node:22-bookworm-slim
|
||||
working_dir: /app
|
||||
restart: unless-stopped
|
||||
logging: *json-log-rotation
|
||||
@@ -151,7 +153,7 @@ services:
|
||||
- frontend_node_modules:/app/node_modules
|
||||
|
||||
web:
|
||||
image: docker.m.daocloud.io/library/caddy:2-alpine
|
||||
image: ${BASE_REGISTRY:-docker.m.daocloud.io}/library/caddy:2-alpine
|
||||
restart: unless-stopped
|
||||
logging: *json-log-rotation
|
||||
depends_on:
|
||||
|
||||
Reference in New Issue
Block a user