defactosoftware/elixir

Elixir Docker镜像文档

镜像概述

Elixir Docker镜像是官方提供的Elixir编程语言容器化运行环境，基于Debian或Alpine Linux系统，集成Elixir编译器、Mix构建工具及完整Erlang/OTP平台。该镜像旨在简化Elixir应用的开发、构建与部署流程，提供跨环境一致的运行时，支持多版本Elixir及多样化部署场景。

核心功能与特性

• 多版本支持：提供不同Elixir版本标签（如1.16、latest），满足项目版本兼容性需求
• 轻量级变体：提供Alpine Linux基础镜像（-alpine后缀），体积更小，适合生产环境
• 完整工具链：内置Mix（项目管理）、Hex（包管理器）和Rebar3（Erlang构建工具）
• Erlang/OTP集成：包含匹配版本的Erlang/OTP环境，支持Elixir并发与分布式特性
• CI/CD友好：支持环境变量自定义配置，易于集成到自动化构建与测试流程

使用场景

• 本地开发：快速搭建隔离的Elixir开发环境，避免系统依赖冲突
• 应用构建：容器内执行mix命令完成项目编译、依赖管理和发布打包
• CI/CD流程：在持续集成管道中运行测试、构建和版本发布
• 生产部署：作为基础镜像构建应用容器，部署到Kubernetes等编排平台
• 微服务架构：容器化Elixir微服务，利用其高并发特性构建分布式系统

使用方法与配置说明

基本操作

启动交互式Elixir shell

bash
docker run -it --rm elixir iex

运行Elixir脚本

bash
docker run -it --rm -v "$(pwd)":/app -w /app elixir elixir my_script.exs

项目构建示例

本地项目依赖安装与编译

bash
# 安装依赖
docker run -it --rm -v "$(pwd)":/app -w /app elixir mix deps.get

# 编译项目
docker run -it --rm -v "$(pwd)":/app -w /app elixir mix compile

# 运行测试
docker run -it --rm -v "$(pwd)":/app -w /app elixir mix test

Dockerfile多阶段构建示例

dockerfile
# 构建阶段
FROM elixir:1.16 AS builder
WORKDIR /app
COPY mix.exs mix.lock ./
RUN mix deps.get --only prod && mix deps.compile
COPY . .
RUN MIX_ENV=prod mix compile && mix release my_app

# 运行阶段（Alpine轻量版）
FROM elixir:1.16-alpine AS runner
WORKDIR /app
COPY --from=builder /app/_build/prod/rel/my_app ./
ENV MIX_ENV=prod
CMD ["./bin/my_app", "start"]

Docker Compose配置

yaml
version: '3.8'
services:
  elixir-app:
    image: elixir:1.16
    volumes:
      - ./:/app
    working_dir: /app
    environment:
      - MIX_ENV=dev
    tty: true
    stdin_open: true

启动命令：

bash
docker-compose up -d
docker-compose exec elixir-app iex -S mix

环境变量配置

版本标签说明

生产环境建议：使用完整版本标签（如1.16.3）确保构建一致性

注意事项

• 依赖缓存优化：通过挂载/root/.hex和/root/.mix卷缓存依赖包，加速重复构建
• Alpine兼容性：Alpine变体使用musl libc，部分原生依赖可能需要额外编译配置
• 安全最佳实践：生产环境中通过USER指令切换为非root用户运行容器
• 持久化存储：应用数据需通过卷挂载实现持久化，避免容器重启数据丢失