verybigthings/elixir

VBT Elixir 基础镜像文档

概述

VBT Elixir基础镜像是针对Elixir应用开发与部署优化的Docker镜像，集成了Elixir运行时环境、Erlang/OTP及常用开发工具，旨在简化Elixir应用的开发调试、持续集成和生产部署流程，提供一致的运行环境以减少环境差异导致的问题。

核心功能和特性

• 预配置运行时环境：内置指定版本的Elixir和Erlang/OTP，确保开发与生产环境一致性
• 优化构建流程：支持多阶段构建，可分离构建依赖与运行时依赖，减小最终镜像体积
• 开发工具集成：包含Mix（Elixir构建工具）、Hex（包管理器）等核心开发工具
• 兼容性设计：兼容主流Linux发行版基础镜像，支持多种部署场景（本地开发、CI/CD、生产环境）
• 安全优化：基于精简基础镜像构建，减少***面，默认非root用户运行

使用场景和适用范围

• 本地开发环境：快速搭建一致的Elixir开发环境，避免"在我机器上能运行"问题
• CI/CD流程集成：作为构建和测试阶段的基础镜像，确保流水线环境稳定性
• 生产环境部署：通过多阶段构建生成轻量级运行时镜像，用于生产环境部署Elixir应用
• Elixir库开发：提供标准化环境用于Elixir库的测试和验证

使用方法和配置说明

基础使用（开发环境）

通过以下命令启动交互式Elixir shell：

bash
docker run -it --rm vbt/elixir-base iex

构建Elixir应用（多阶段构建示例）

创建Dockerfile：

dockerfile
# 构建阶段：使用VBT Elixir基础镜像进行依赖安装和编译
FROM vbt/elixir-base AS builder
WORKDIR /app
COPY mix.exs mix.lock ./
RUN mix deps.get --only prod && mix deps.compile
COPY . .
RUN mix compile

# 运行时阶段：使用轻量级基础镜像
FROM elixir:alpine
WORKDIR /app
COPY --from=builder /app/_build/prod/rel/app_name ./
ENV MIX_ENV=prod
CMD ["/app/bin/app_name", "start"]

常用环境变量

自定义配置

如需扩展镜像功能，可通过Dockerfile添加额外依赖：

dockerfile
FROM vbt/elixir-base
RUN mix local.hex --force && mix local.rebar --force
# 添加项目特定依赖
RUN apt-get update && apt-get install -y some-package

版本管理

镜像标签遵循{elixir-version}-{erlang-version}-{image-revision}格式，例如1.15.7-26.2.1-v1，建议在生产环境中使用具体版本标签以确保构建一致性。