profootballfocus/elixir_build

Elixir-Distillery构建镜像

镜像概述和主要用途

本镜像为Elixir开发者设计，用于简化使用Distillery工具构建可部署的Elixir应用发布版本。它集成了Elixir运行时和Distillery构建工具，解决手动配置构建环境的复杂性，提供标准化的构建流程，帮助开发者快速生成生产就绪的Elixir应用发布包。

核心功能和特性

• 预配置环境：内置Elixir和Distillery工具，无需手动安装和配置依赖，开箱即可使用
• 标准化流程：提供一致的构建流程，确保不同环境下构建结果的一致性
• 环境隔离：通过Docker容器化构建环境，避免与主机系统依赖冲突
• 轻量级设计：优化镜像体积，减少构建环境资源占用
• 灵活适配：兼容常见Elixir项目结构（如Mix项目），支持自定义构建参数

使用场景和适用范围

适用场景

• Elixir应用的生产环境发布版本构建
• CI/CD流水线中集成自动化构建流程（如GitHub Actions、GitLab CI）
• 多环境（开发、测试、生产）下的统一构建环境
• 需要打包Elixir应用为独立可执行发布版本的场景

适用范围

• Elixir开发者和开发团队
• DevOps工程师（负责应用部署流程设计）
• 需要标准化Elixir构建流程的技术团队

使用方法和配置说明

基础使用步骤

1. 准备项目
   确保Elixir项目已初始化，在mix.exs中添加Distillery依赖并安装：

   elixir
   # mix.exs中添加依赖
   defp deps do
     [
       {:distillery, "~> 2.1"}
     ]
   end
   

   执行mix deps.get安装依赖，并通过mix release.init初始化Distillery配置。

2. 拉取镜像

   bash
   docker pull [镜像名称]:[标签]  # 例如：docker pull elixir-distillery:latest
   

3. 执行构建
   通过挂载项目目录到容器，运行构建命令：

   bash
   docker run --rm -v $(pwd):/app -w /app [镜像名称]:[标签] mix release
   

   • --rm：构建完成后自动删除容器
   • -v $(pwd):/app：挂载当前项目目录到容器内/app路径
   • -w /app：设置容器工作目录为项目根目录
   • mix release：执行Distillery构建命令，生成的发布包默认位于_build/prod/rel/[项目名]

高级配置

指定构建环境

通过MIX_ENV环境变量指定构建环境（默认为prod）：

bash
docker run --rm -e MIX_ENV=test -v $(pwd):/app -w /app [镜像名称]:[标签] mix release

自定义构建命令

支持执行复杂构建流程，如先测试再构建：

bash
docker run --rm -v $(pwd):/app -w /app [镜像名称]:[标签] sh -c "mix test && mix release"

持久化构建缓存

挂载缓存卷加速依赖安装：

bash
# 创建缓存卷
docker volume create elixir-deps
docker volume create elixir-build

# 带缓存构建
docker run --rm -v $(pwd):/app -v elixir-deps:/app/deps -v elixir-build:/app/_build -w /app [镜像名称]:[标签] mix release

注意事项

• 确保项目已通过mix release.init初始化Distillery配置
• 不同Elixir版本项目需使用对应标签的镜像（如Elixir 1.14项目使用标签1.14）
• 构建前建议通过mix deps.get确保依赖已完整安装