better/dockerimages

Better Docker镜像

本仓库包含Better项目使用的自定义Docker镜像，用于统一项目容器化基础环境。

标签方案

标签遵循以下格式：

{用途}-{语言|领域}-{版本}

• 用途：对应仓库内文件夹（如base）；
• 语言|领域：对应文件夹下Dockerfile的后缀（如node）；
• 版本：Dockerfile的修订版本（非依赖软件版本），遵循语义版本控制。

示例：base-node-1.0.0对应base/Dockerfile.node的1.0.0版本。

标签粒度

同一镜像支持多版本标签引用，若base-node最新版本为1.2.3，则以下标签指向同一镜像：

• base-node-latest
• base-node-1
• base-node-1.2
• base-node-1.2.3

注意：使用模糊标签可能导致重复构建时镜像版本变化。

镜像引用

在Dockerfile中引用本仓库镜像：

dockerfile
FROM docker.xuanyuan.run/better/dockerimages:{用途}-{语言|领域}-{版本}

示例：

dockerfile
FROM docker.xuanyuan.run/better/dockerimages:base-node-1.0.0

镜像构建

构建指定镜像：

bash
make build-IMAGE

示例：

bash
make build-build-node

查看现有镜像

仓库已与Dockerhub集成，标签更新时自动构建发布。可通过https://hub.docker.com/repository/docker/better/dockerimages查看构建状态，凭据可在Okta搜索"Dockerhub"获取。

更新现有镜像

1. 修改目标Dockerfile；
2. 测试构建：make build-IMAGE；
3. 提交PR并合并到master；
4. 发布版本：make release-TYPE-IMAGE（TYPE可选major/minor/patch）。

示例：

bash
make release-patch-build-node

添加新镜像

1. 在对应文件夹创建带后缀的Dockerfile；
2. 在Dockerhub添加自动化构建规则（源类型为tag，匹配标签格式）；
3. 更新GitHub webhook权限，确保标签变更触发构建；
4. 合并后按更新流程发布。

添加依赖包

• 全局依赖：修改hooks/build的BASE_DEPENDENCIES_MAP；
• 构建依赖：修改BUILD_DEPENDENCIES_MAP；
• 重新构建镜像生效。