monocolombia/phoenix-alpine

Elixir + Phoenix Docker镜像文档

镜像概述

该Docker镜像集成了Elixir运行环境与Phoenix Web框架，为开发者提供一站式的Elixir/Phoenix应用开发、测试和部署解决方案。通过预配置环境减少环境配置时间，支持从开发到生产的全流程应用部署，确保环境一致性与部署效率。

核心功能与特性

• 完整Elixir环境：包含指定版本的Elixir运行时、Erlang/OTP平台及工具链（Mix、Hex包管理器），确保应用运行兼容性。
• Phoenix框架集成：预装Phoenix框架及其核心依赖（Plug、Ecto、Phoenix LiveView等），支持快速创建Web项目。
• 开发工具支持：集成代码编译、测试（ExUnit）、调试工具及elixir-ls语言服务器，提升开发体验。
• 多环境适配：支持开发（dev）、测试（test）、生产（prod）环境切换，通过环境变量灵活配置。
• 依赖管理：内置Hex与Mix工具链，支持项目依赖自动安装、版本控制及依赖缓存优化。

使用场景

• 本地开发环境：快速搭建一致的开发环境，避免"环境不一致"问题，支持代码热更新。
• CI/CD测试环境：作为自动化测试基础镜像，运行单元测试、集成测试及性能测试。
• 生产部署：构建轻量级生产镜像，部署高性能、低延迟的Phoenix Web应用。
• 演示环境：快速启动应用演示实例，展示项目功能与交互效果。

使用方法与配置说明

基础使用（docker run）

开发环境启动

bash
docker run -it --rm \
  -v $(pwd):/app \
  -p 4000:4000 \
  -e MIX_ENV=dev \
  docker.xuanyuan.run/elixir-phoenix \
  sh -c "mix deps.get && mix phx.server"

参数说明：

• -v $(pwd):/app：本地项目目录挂载至容器/app，实现代码热更新
• -p 4000:4000：映射Phoenix默认开发端口（4000）至本地
• -e MIX_ENV=dev：设置为开发环境模式
• mix deps.get：安装项目依赖
• mix phx.server：启动Phoenix开发服务器

生产环境启动

bash
docker run -d \
  -v $(pwd):/app \
  -p 80:4000 \
  -e MIX_ENV=prod \
  -e SECRET_KEY_BASE=$(mix phx.gen.secret) \
  -e DATABASE_URL=ecto://user:pass@db:5432/app_prod \
  elixir-phoenix \
  sh -c "mix deps.get --only prod && mix compile && mix phx.digest && mix phx.server"

Docker Compose配置示例

yaml
version: '3.8'

services:
  web:
    image: docker.xuanyuan.run/elixir-phoenix
    volumes:
      - ./:/app
    ports:
      - "4000:4000"
    environment:
      - MIX_ENV=dev
      - DATABASE_URL=ecto://postgres:postgres@db:5432/app_dev
    depends_on:
      - db
    command: sh -c "mix deps.get && mix ecto.setup && mix phx.server"

  db:
    image: docker.xuanyuan.run/postgres:14
    environment:
      - POSTGRES_USER=postgres
      - POSTGRES_PASSWORD=postgres
      - POSTGRES_DB=app_dev
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

环境变量配置

自定义镜像构建（生产优化）

如需构建包含项目代码的生产镜像，可创建如下Dockerfile：

dockerfile
FROM docker.xuanyuan.run/elixir-phoenix AS builder

WORKDIR /app
COPY mix.exs mix.lock ./
RUN mix deps.get --only prod && mix deps.compile

COPY . .
RUN mix compile && mix phx.digest

FROM docker.xuanyuan.run/elixir-phoenix AS runner
WORKDIR /app
COPY --from=builder /app/_build/prod/rel/app ./rel
COPY --from=builder /app/priv/static ./priv/static

EXPOSE 4000
CMD ["rel/app/bin/app", "start"]

注意事项

• 开发环境建议使用卷挂载（-v）实现代码热更新，生产环境建议构建包含项目代码的自定义镜像。
• 生产环境必须设置SECRET_KEY_BASE（通过mix phx.gen.secret生成安全密钥）。
• 数据库连接需确保网络可达（如使用Docker Compose时通过服务名访问数据库容器）。
• 根据项目需求调整MIX_ENV，不同环境下Phoenix会自动应用对应配置（如日志级别、连接池大小）。