geeks5olutions/elixir_rust

Elixir Rust Docker镜像

镜像概述和主要用途

本镜像基于Alpine Linux构建，集成Elixir和Rust（含Cargo）环境，专为依赖Rust NIFs的Elixir项目设计。可直接在CI流水线中运行代码标准检查、执行测试，以及构建生产就绪的Elixir发布版本。通过内置Rust环境，支持编译基于Rustler的Rust NIFs，满足Elixir项目对Rust扩展模块的依赖需求。

核心功能和特性

• 轻量级基础：基于Alpine构建，镜像体积小，资源占用低
• 完整开发环境：集成Elixir和Rust（含Cargo），无需额外安装依赖工具
• CI流程优化：无需配置before_script，可直接执行代码检查和测试命令
• Rust NIFs支持：内置Rust编译环境，支持基于Rustler的Rust NIFs编译
• 生产构建能力：可生成包含Rust NIFs的生产就绪Elixir发布版本

使用场景和适用范围

适用于依赖Rust NIFs的Elixir项目，主要应用场景包括：

• CI/CD流水线中的代码标准检查（如执行mix credo --strict）
• 自动化测试执行（如运行mix coveralls生成覆盖率报告）
• 包含Rust NIFs的Elixir项目编译构建
• 生产环境Elixir发布版本的打包构建

详细使用方法和配置说明

CI流程常用命令

代码标准检查

bash
mix credo --strict

测试执行与覆盖率报告

bash
mix coveralls

生产发布构建

直接在本镜像中执行Elixir发布构建命令，生成包含Rust NIFs的生产版本。

生产环境部署配置示例

若发布版本依赖Rust NIFs，生产环境镜像需包含libgcc等运行时依赖。以下是工作示例Dockerfile：

dockerfile
FROM alpine:3.13 AS app
# 安装运行时依赖：openssl(加密)、ncurses-libs(终端支持)、libgcc(Rust NIFs必需)
RUN apk add --no-cache openssl ncurses-libs libgcc

WORKDIR /app

# 设置目录权限
RUN chown nobody:nobody /app

USER nobody:nobody

# 从构建阶段复制发布文件（构建阶段建议使用本镜像）
COPY --from=build --chown=nobody:nobody /app/_build/prod/rel ./

ENV HOME=/app

# 复制入口脚本
COPY entrypoint.sh .

# 启动Phoenix应用
CMD ["./entrypoint.sh"]

关键注意事项

• 运行时依赖：生产环境必须安装libgcc，否则Rust NIFs将无法正常加载
• 权限管理：建议使用非root用户（如示例中的nobody）运行应用，提升安全性
• 构建依赖：确保构建阶段正确传递Rust编译产物至生产镜像