bitwalker/alpine-elixir-phoenix

Alpine Linux上的Elixir/Phoenix镜像

该Docker镜像提供了开箱即可在Docker中运行Phoenix应用所需的一切。它基于alpine-erlang镜像构建，安装了Elixir（1.11.0）、Node.js（12.18.x）、Hex和Rebar，能够在构建过程中处理Node和Elixir依赖的编译。

核心功能和特性

• 轻量级基础：基于Alpine Linux，镜像体积小，资源占用低
• 完整开发环境：包含Elixir 1.11.0、Erlang（继承自alpine-erlang）、Node.js 12.18.x
• 依赖管理工具：预安装Hex（Elixir包管理器）和Rebar（Erlang构建工具）
• 构建支持：可处理Node.js依赖安装和Elixir依赖编译
• 安全设计：支持非特权环境运行，主目录设为/opt/app并全局可读写

使用场景和适用范围

• Phoenix Web应用的容器化开发和部署
• 需要Elixir/Erlang与Node.js环境的混合应用
• 追求轻量级、高效容器镜像的项目

使用方法和配置说明

环境说明

该镜像设计用于非特权环境，默认主目录为/opt/app。建议在Dockerfile末尾添加USER default指令，使应用在非特权用户 context 下运行。

直接运行交互环境

通过以下命令直接启动镜像并进入Elixir交互环境：

bash
docker run --rm -it --user=1000001 bitwalker/alpine-elixir-phoenix iex

运行后将进入Elixir交互终端：

Erlang/OTP 23 [erts-11.1.1] [source] [64-bit] [smp:3:3] [ds:3:3:10] [async-threads:1]

Interactive Elixir (1.11.0) - press Ctrl+C to exit (type h() ENTER for help)
iex(1)>

扩展用于自定义应用

创建自定义Dockerfile扩展此镜像：

dockerfile
FROM bitwalker/alpine-elixir-phoenix:latest

# 设置暴露端口
EXPOSE 5000
ENV PORT=5000 MIX_ENV=prod

# 缓存Elixir依赖
ADD mix.exs mix.lock ./
RUN mix do deps.get, deps.compile

# 缓存Node.js依赖
ADD assets/package.json assets/
RUN cd assets && npm install

ADD . .

# 构建前端资源、编译应用并生成静态资源摘要
RUN cd assets/ && \
    npm run deploy && \
    cd - && \
    mix do compile, phx.digest

USER default

CMD ["mix", "phx.server"]

.dockerignore配置

构建镜像时，建议在项目根目录创建.dockerignore文件，包含以下内容：

_build
deps
assets/node_modules
test

这将减小镜像体积并避免依赖编译问题。

多阶段构建

可结合多阶段构建和bitwalker/alpine-elixir镜像显著减小最终镜像体积：

dockerfile
FROM bitwalker/alpine-elixir-phoenix:latest AS phx-builder

# 设置环境变量
ENV MIX_ENV=prod

# 缓存Elixir依赖
ADD mix.exs mix.lock ./
RUN mix do deps.get, deps.compile

# 缓存Node.js依赖
ADD assets/package.json assets/
RUN cd assets && npm install

ADD . .

# 构建前端资源、编译应用并生成静态资源摘要
RUN cd assets/ && \
    npm run deploy && \
    cd - && \
    mix do compile, phx.digest

FROM bitwalker/alpine-elixir:latest

EXPOSE 5000
ENV PORT=5000 MIX_ENV=prod

# 从构建阶段复制必要文件
COPY --from=phx-builder /opt/app/_build /opt/app/_build
COPY --from=phx-builder /opt/app/priv /opt/app/priv
COPY --from=phx-builder /opt/app/config /opt/app/config
COPY --from=phx-builder /opt/app/lib /opt/app/lib
COPY --from=phx-builder /opt/app/deps /opt/app/deps
COPY --from=phx-builder /opt/app/.mix /opt/app/.mix
COPY --from=phx-builder /opt/app/mix.* /opt/app/

# 或者复制整个目录（注意：这会包含非构建文件）
# COPY --from=phx-builder /opt/app /opt/app

USER default

CMD ["mix", "phx.server"]

许可证

MIT