
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
应用构建镜像是一个专为应用构建流程设计的Docker镜像,集成了多种常用的构建工具、依赖环境及配置,旨在标准化应用的编译、打包过程,消除"在我机器上能运行"的环境不一致问题,提高构建效率和可重复性。该镜像适用于各类应用的构建场景,支持本地开发测试与CI/CD流水线集成。
作为CI/CD流程(如Jenkins、GitLab CI、GitHub Actions)中的构建节点,执行自动化编译、打包任务,确保流水线中构建环境的一致性。
开发者无需在本地安装全套构建工具,通过容器化方式快速获取一致的构建环境,验证构建流程。
企业内部多团队、多项目可复用同一镜像,统一构建工具版本和流程规范,降低维护成本。
1. 基础构建(以Java Maven项目为例)
bashdocker run -it --rm \ -v $(pwd):/app # 挂载本地源码目录到容器内/app -e JDK_VERSION=17 # 指定JDK版本 -e BUILD_CMD="mvn clean package -DskipTests" # 指定构建命令 apps-build-image:latest
2. Node.js项目构建(带依赖缓存)
bashdocker run -it --rm \ -v $(pwd):/app \ -v npm-cache:/root/.npm # 挂载缓存卷,加速依赖安装 -e NODE_VERSION=18 \ -e BUILD_CMD="npm install && npm run build" \ apps-build-image:latest
环境变量
| 环境变量名 | 说明 | 默认值 | 可选值 |
|---|---|---|---|
WORKDIR | 容器内构建工作区路径 | /app | 自定义路径(如/src) |
JDK_VERSION | Java开发工具包版本 | 11 | 8, 11, 17 |
NODE_VERSION | Node.js版本 | 16 | 16, 18 |
PYTHON_VERSION | Python版本 | 3.9 | 3.8, 3.9, 3.10, 3.11 |
BUILD_CMD | 执行的构建命令 | 空(需用户指定) | 如mvn package, npm run build |
OUTPUT_DIR | 构建产物输出目录(相对WORKDIR) | target(Java默认) | 自定义路径(如dist, build) |
数据卷挂载
| 挂载路径(容器内) | 说明 | 宿主机推荐挂载路径 |
|---|---|---|
/app | 源码目录 | 本地项目根目录($(pwd)) |
/root/.m2 | Maven依赖缓存目录 | 宿主机Maven缓存(如~/.m2) |
/root/.npm | npm依赖缓存目录 | 宿主机npm缓存(如~/.npm) |
/app/${OUTPUT_DIR} | 构建产物输出目录(可单独挂载) | 宿主机产物目录(如./dist) |
若默认配置无法满足需求,可通过以下方式扩展:
通过构建时传入--build-arg参数重新构建镜像,指定工具版本:
bashdocker build \ --build-arg MAVEN_VERSION=3.9.5 \ --build-arg GRADLE_VERSION=8.3 \ -t apps-build-image:custom .
在Dockerfile中基于基础镜像扩展,安装特定工具:
dockerfileFROM apps-build-image:latest RUN apt-get update && apt-get install -y golang-1.21
apps-build-image:v1.0),避免工具版本变更导致构建异常您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。





来自真实用户的反馈,见证轩辕镜像的优质服务