elixir-builder-docker 镜像文档

镜像概述

elixir-builder-docker 是一个Elixir基础构建Docker镜像，专为Elixir项目的构建流程设计。该镜像通过版本化标签（versioned Tags）自动触发构建，确保构建环境的一致性和可追溯性，适用于Elixir项目的开发、测试及部署环节。镜像托管于Docker Hub，构建记录可通过***仓库链接查看。

核心功能与特性

• Elixir构建环境：提供完整的Elixir运行时及构建工具链，满足Elixir项目的依赖安装、代码编译等核心构建需求。
• 自动构建机制：基于版本化标签（如v1.0.0、v2.3.1等）自动触发Docker Hub构建流程，无需手动干预，确保镜像版本与项目迭代同步。
• 版本化管理：通过标签实现版本控制，用户可根据项目需求选择特定版本的构建环境，避免版本冲突。

使用场景

• CI/CD流程集成：作为Elixir项目持续集成/持续部署（CI/CD）流程的基础环境，用于自动化构建、测试环节。
• 本地开发构建：在本地开发环境中快速搭建标准化的Elixir构建环境，减少因环境差异导致的构建问题。
• 多版本项目支持：通过指定不同标签，适配不同Elixir版本的项目构建需求。

使用方法

获取镜像

镜像托管于Docker Hub，可通过以下命令拉取指定版本（替换<tag>为具体版本标签，如v1.14.0）：

bash
docker pull smartrent/builder:<tag>

版本标签及构建历史可通过仓库链接查看：
[]

基本使用示例

作为基础镜像使用

在项目的Dockerfile中，可将此镜像作为基础镜像构建自定义项目镜像：

dockerfile
# 指定镜像版本
FROM smartrent/builder:<tag>

# 设置工作目录
WORKDIR /app

# 复制项目文件
COPY . .

# 执行构建命令（如安装依赖、编译项目）
RUN mix deps.get && mix compile

直接运行构建命令

在本地终端中，可挂载项目目录并直接使用镜像执行构建命令：

bash
# 挂载当前项目目录至容器内/app，执行依赖安装和编译
docker run --rm -v $(pwd):/app smartrent/builder:<tag> sh -c "cd /app && mix deps.get && mix compile"

自动构建触发机制

当在项目代码仓库中创建或更新版本化标签（需符合语义化版本规范，如v1.2.3）时，Docker Hub会监听标签事件并自动触发镜像构建流程。构建完成后，对应标签的镜像将推送至Docker Hub仓库，供用户拉取使用。

注意事项

• 确保使用的标签与项目所需的Elixir版本匹配，避免因版本不兼容导致构建失败。
• 构建过程中的详细日志、依赖信息及版本历史可通过Docker Hub仓库的构建记录页面查询。
• 本地构建前建议先执行docker pull命令拉取最新版本镜像，确保环境为最新状态。