Elixir (i386) Docker 镜像文档

镜像概述

主要用途

本镜像为 官方 Elixir 镜像 的 i386 架构专用版本，用于在 i386 架构的系统上运行 Elixir 应用程序。Elixir 是一种动态函数式编程语言，专为构建可扩展和可维护的应用程序而设计，它基于 Erlang 虚拟机 (BEAM)，该虚拟机以运行低延迟、分布式和容错系统而闻名，同时也广泛应用于 Web 开发和嵌入式软件领域。

核心功能与特性

• 语言特性：Elixir 具备动态类型、函数式编程范式、不可变数据结构等特性，支持模式匹配、并发编程和分布式系统开发
• Erlang 虚拟机支持：依托 Erlang VM (BEAM)，提供高可用性、容错能力和原生并发支持
• 多版本支持：包含多个 Elixir 版本（如 1.18、1.17、1.16 等）和对应的 OTP (Open Telecom Platform) 版本
• 多变体镜像：提供默认版、slim 精简版和 alpine 最小版三种镜像变体，满足不同场景需求
• 架构适配：专为 i386 架构优化，确保在 32 位 x86 系统上的兼容性

支持的标签及对应 Dockerfile

以下是当前支持的镜像标签及其对应的 Dockerfile 链接：

Elixir 1.18 系列

• 1.18.4, 1.18, latest, 1.18.4-otp-28, 1.18-otp-28, otp-28
• 1.18.4-slim, 1.18-slim, slim, 1.18.4-otp-28-slim, 1.18-otp-28-slim, otp-28-slim
• 1.18.4-alpine, 1.18-alpine, alpine, 1.18.4-otp-28-alpine, 1.18-otp-28-alpine, otp-28-alpine
• 1.18.4-otp-25, 1.18-otp-25, otp-25
• 1.18.4-otp-25-alpine, 1.18-otp-25-alpine, otp-25-alpine
• 1.18.4-otp-25-slim, 1.18-otp-25-slim, otp-25-slim
• 1.18.4-otp-26, 1.18-otp-26, otp-26
• 1.18.4-otp-26-alpine, 1.18-otp-26-alpine, otp-26-alpine
• 1.18.4-otp-26-slim, 1.18-otp-26-slim, otp-26-slim
• 1.18.4-otp-27, 1.18-otp-27, otp-27
• 1.18.4-otp-27-alpine, 1.18-otp-27-alpine, otp-27-alpine
• 1.18.4-otp-27-slim, 1.18-otp-27-slim, otp-27-slim

Elixir 1.17 系列

• 1.17.3, 1.17, 1.17.3-otp-27, 1.17-otp-27
• 1.17.3-slim, 1.17-slim, 1.17.3-otp-27-slim, 1.17-otp-27-slim
• 1.17.3-alpine, 1.17-alpine, 1.17.3-otp-27-alpine, 1.17-otp-27-alpine
• 1.17.3-otp-25, 1.17-otp-25
• 1.17.3-otp-25-alpine, 1.17-otp-25-alpine
• 1.17.3-otp-25-slim, 1.17-otp-25-slim
• 1.17.3-otp-26, 1.17-otp-26
• 1.17.3-otp-26-alpine, 1.17-otp-26-alpine
• 1.17.3-otp-26-slim, 1.17-otp-26-slim

更早版本（1.16 及以下）

包含 1.16、1.15、1.14、1.13、1.12 等系列标签，具体可参考 官方仓库

使用场景

• 开发环境：快速搭建 Elixir 开发环境，无需本地安装 Elixir 和 Erlang
• CI/CD 流水线：在持续集成/部署流程中编译、测试和运行 Elixir 应用
• 生产部署：在 i386 架构服务器上部署 Elixir 应用程序
• 学与实验**：通过 REPL 模式学** Elixir 语法和特性
• 轻量级容器：使用 slim 或 alpine 变体构建资源受限环境下的应用

使用方法

以 REPL 模式运行

直接启动 Elixir 交互式解释器（REPL）：

➸ docker run -it --rm i386/elixir
Erlang/OTP 18 [erts-7.2.1] [source] [64-bit] [smp:8:8] [async-threads:10] [hipe] [kernel-poll:false]

Interactive Elixir (1.2.1) - press Ctrl+C to exit (type h() ENTER for help)
iex(1)> System.version
"1.2.1"
iex(2)>

启动带节点名称的 REPL：

➸ docker run -it --rm -h elixir.local i386/elixir iex --sname snode
Erlang/OTP 18 [erts-7.2.1] [source] [64-bit] [smp:8:8] [async-threads:10] [hipe] [kernel-poll:false]

Interactive Elixir (1.2.1) - press Ctrl+C to exit (type h() ENTER for help)
iex(snode@elixir)1> System.version
"1.2.1"
iex(snode@elixir)2> :c.uptime
14 seconds
:ok

运行单个 Elixir 脚本

挂载本地目录并运行 .exs 脚本：

$ docker run -it --rm --name elixir-inst1 -v "$PWD":/usr/src/myapp -w /usr/src/myapp i386/elixir elixir your-escript.exs

• -v "$PWD":/usr/src/myapp：将当前目录挂载到容器内的 /usr/src/myapp
• -w /usr/src/myapp：设置工作目录为 /usr/src/myapp
• elixir your-escript.exs：执行 Elixir 脚本

构建和运行 Elixir 应用

创建 Dockerfile：

FROM i386/elixir:1.18.4-otp-28

WORKDIR /app

# 复制 mix 配置文件
COPY mix.exs mix.lock ./
RUN mix deps.get --only prod
RUN mix deps.compile

# 复制应用代码
COPY . .
RUN mix compile

# 运行应用
CMD ["mix", "run", "--no-halt"]

构建并运行：

$ docker build -t my-elixir-app .
$ docker run -it --rm my-elixir-app

镜像变体

默认版本 (i386/elixir:<version>)

标准镜像，包含运行 Elixir 所需的完整依赖和常用工具。适合大多数场景，既可作为临时容器（挂载源码运行应用），也可作为基础镜像构建其他镜像。

Slim 版本 (i386/elixir:<version>-slim)

精简版镜像，仅包含运行 Elixir 所需的最小依赖，不包含默认版本中的常见工具包。适用于对镜像大小有严格要求的环境，但建议优先使用默认版本，除非明确需要减小体积。

Alpine 版本 (i386/elixir:<version>-alpine)

基于 Alpine Linux 的轻量级镜像，体积显著小于其他变体（基础镜像约 5MB）。使用 musl libc 替代 glibc，可能与部分依赖 glibc 的应用存在兼容性问题。适合对镜像大小有极致要求的场景，但需注意依赖兼容性。

配置说明

本镜像主要通过命令行参数和 Elixir 应用自身的配置文件进行配置：

• 命令行参数：通过 docker run 命令传递给 Elixir 或 iex，如 iex --sname snode 指定节点名称
• 环境变量：可通过 -e 参数设置环境变量，供应用读取，如 -e MIX_ENV=prod 设置生产环境
• 配置文件：应用的配置通常通过 config.exs 等文件管理，需通过挂载或构建镜像时包含到容器中

维护与支持

维护方

Erlang 生态系统基金会

支持的架构

除 i386 外，官方 Elixir 镜像还支持 amd64、arm32v7、arm64v8、ppc64le、s390x 等架构，可访问对应架构的镜像仓库获取。

获取帮助

• Docker 社区 Slack
• Server Fault
• Unix & Linux Stack Exchange
• Stack Overflow

提交问题

通过 GitHub 仓库 issue 提交问题反馈。

许可协议

Elixir 软件本身基于 Apache License 2.0 许可协议发布，详见 Apache 许可协议。

本镜像可能包含其他软件（如基础系统的 Bash 等），这些软件可能具有各自的许可协议。镜像使用者需自行确保对所有包含软件的使用符合相关许可要求。

更多许可信息可参考 repo-info 仓库的 elixir 目录。