GPlugin构建镜像文档

镜像概述

GPlugin构建镜像是一款预构建的Docker镜像，专为简化GPlugin的构建过程而设计。该镜像集成了GPlugin构建所需的全部依赖工具和环境配置，可帮助开发者快速启动构建流程，无需手动安装和配置底层依赖，有效解决因环境差异导致的构建不一致问题。

核心功能和特性

• 预配置构建环境：内置GPlugin构建所需的编译器、依赖库、打包工具等，开箱即可使用
• 简化构建流程：通过镜像封装，将复杂的构建步骤简化为标准化命令，降低操作门槛
• 环境一致性：确保所有开发者和CI/CD流程使用相同的构建环境，消除"本地可构建，线上构建失败"的问题
• 轻量级设计：优化镜像体积，在包含完整依赖的同时保持较高的运行效率

使用场景和适用范围

• 本地开发构建：开发者在本地开发GPlugin时，快速验证代码构建效果
• CI/CD集成：作为CI/CD流水线的构建环节，实现自动化构建流程
• 多版本测试：通过指定不同标签的镜像，测试GPlugin在不同构建环境下的兼容性
• 快速原型验证：需要临时构建GPlugin验证功能时，避免繁琐的环境配置

使用方法和配置说明

基本使用命令

bash
docker run --rm -v /path/to/gplugin/source:/app gplugin-builder:latest

参数说明

• --rm：容器退出后自动删除，避免残留临时文件
• -v /path/to/gplugin/source:/app：将本地GPlugin源代码目录挂载到容器内的/app工作目录
• gplugin-builder:latest：镜像名称及标签（可指定具体版本，如gplugin-builder:1.0.0）

自定义构建配置

环境变量

示例：指定调试模式构建

bash
docker run --rm \
  -v /path/to/gplugin:/app \
  -e BUILD_TARGET=debug \
  -e OUTPUT_DIR=/app/debug-build \
  gplugin-builder:latest

挂载说明

• 源代码目录：必须挂载包含GPlugin源代码的目录到/app，镜像将以此为工作目录执行构建
• 构建产物目录：若需将构建产物保留到本地，可额外挂载输出目录，如-v /local/output:/app/build

注意事项

• 确保本地Docker环境已正确安装并运行
• 挂载目录需具有读写权限，避免因权限问题导致构建失败
• 不同版本的镜像可能对应不同版本的GPlugin构建工具链，使用时需匹配项目需求的版本标签