profootballfocus/elixir_run

Elixir发布版本运行镜像

镜像概述和主要用途

本Docker镜像专为运行已编译的Elixir发布版本设计，提供了Elixir应用运行所需的最小化运行时环境。它不包含编译工具链，仅保留必要的Erlang/OTP依赖和运行时组件，旨在减小镜像体积并优化生产环境部署效率。适用于将已通过mix release构建的Elixir应用部署到容器化环境中。

核心功能和特性

• 轻量级设计：基于精简基础镜像（如Alpine Linux或Debian Slim），减少镜像体积和资源占用
• 完整运行时：包含Elixir应用运行必需的Erlang/OTP环境及依赖库
• 发布版本支持：原生支持Elixir mix release生成的发布包结构，可直接运行已编译应用
• 部署简化：无需在容器内重新编译代码，直接加载预编译发布包，缩短启动时间
• 环境配置兼容：支持通过环境变量注入应用配置参数（如数据库连接、端口等）

使用场景和适用范围

• 生产环境部署已编译的Elixir应用服务
• CI/CD流水线中作为运行阶段环境，验证发布包可用性
• 微服务架构中的Elixir服务容器化部署
• 需要快速启动和低资源占用的Elixir应用场景

使用方法和配置说明

前置条件

1. 已通过MIX_ENV=prod mix release <app_name>命令生成Elixir发布包（通常位于_build/prod/rel/<app_name>目录）
2. Docker环境已安装并运行

基础使用步骤

1. 直接运行（本地测试）

将已编译的发布包挂载到容器中运行：

bash
docker run -d \
  --name elixir-app \
  -v /path/to/local/release:/app \  # 挂载本地发布包目录
  -e PORT=4000 \                   # 设置应用端口
  -e DATABASE_URL=ecto://user:pass@db:5432/app \  # 数据库连接配置
  elixir-release-runner \          # 镜像名称
  /app/bin/<app_name> start        # 启动命令（替换<app_name>为实际应用名）

2. 多阶段构建（生产部署推荐）

通过Dockerfile将发布包嵌入镜像，避免外部依赖：

dockerfile
# 第一阶段：编译Elixir发布包
FROM elixir:1.16-alpine AS builder
WORKDIR /app
COPY mix.exs mix.lock ./
RUN mix deps.get --only prod
COPY . .
RUN MIX_ENV=prod mix release my_app  # 构建发布包，输出到_build/prod/rel/my_app

# 第二阶段：运行环境（使用本镜像）
FROM elixir-release-runner
WORKDIR /app
# 从构建阶段复制发布包到运行镜像
COPY --from=builder /app/_build/prod/rel/my_app ./release
# 设置工作目录为发布包目录
WORKDIR /app/release
# 启动命令
CMD ["./bin/my_app", "start"]

构建并运行：

bash
docker build -t my-elixir-app .
docker run -d -p 4000:4000 --name my-app my-elixir-app

环境变量配置

应用可通过环境变量动态配置，常用参数示例：

• PORT：应用监听端口（默认可能为4000）
• DATABASE_URL：数据库连接URL（格式：ecto://user:password@host:port/dbname）
• SECRET_KEY_BASE：Elixir应用密钥（生产环境必需，通过mix phx.gen.secret生成）
• LOG_LEVEL：日志级别（如info、warn、error）

应用管理命令

• 查看应用日志：docker logs -f elixir-app
• 停止应用：docker stop elixir-app
• 重启应用：docker restart elixir-app
• 进入容器：docker exec -it elixir-app sh
• 执行应用命令（如迁移数据库）：docker exec -it elixir-app /app/bin/<app_name> eval "MyApp.Release.migrate"

注意事项

• 确保发布包与镜像中的Erlang/OTP版本兼容（编译环境与运行环境OTP版本需一致）
• 生产环境建议设置健康检查：HEALTHCHECK --interval=30s --timeout=3s CMD wget -qO- http://localhost:$PORT/health || exit 1
• 敏感配置（如数据库密码）建议通过Docker Secrets或环境变量注入，避免硬编码