hutchisont/alpine-elixir-phoenix

Alpine + Elixir + Phoenix 镜像文档

概述

本镜像基于 https://hub.docker.com/_/elixir/ 构建，继承Alpine Linux轻量级特性，同时集成Elixir开发工具链与Phoenix Web框架，旨在提供开箱即用的Elixir Web应用运行环境，简化基于Phoenix 1.3.4的应用部署流程。

核心功能与特性

基础镜像

• 基于官方elixir:1.7.2-alpine镜像，具备Alpine Linux的小巧体积（约5MB基础镜像）和高效资源占用特性。

预装工具与框架

• 开发工具：包含rebar（Erlang构建工具）和hex（Elixir包管理器），支持Elixir项目依赖管理与构建。
• Web框架：集成 https://github.com/phoenixframework/phoenix/tree/v1.3.4 框架，满足Elixir Web应用开发需求。

附加脚本

• 根目录下提供wait-for脚本，用于在应用启动前等待依赖服务（如数据库、缓存等）就绪，解决服务间启动顺序依赖问题。

使用场景

• 快速搭建基于Phoenix 1.3.4的Elixir Web应用开发环境，减少环境配置时间。
• 构建轻量级Phoenix应用生产镜像，适用于对容器体积和资源占用敏感的部署场景。
• 需要自动化处理服务依赖（如等待数据库启动）的容器化部署流程。

使用方法与配置说明

基本使用

通过以下命令启动交互式终端，验证环境完整性：

bash
docker run -it --rm [镜像标签] sh

（注：[镜像标签]需替换为实际镜像名称或仓库地址）

应用部署示例

启动Phoenix应用

在容器中执行Phoenix应用启动命令（需先挂载应用代码至容器内）：

bash
# 假设应用代码挂载至/app目录
docker run -v /本地应用路径:/app -w /app [镜像标签] mix phx.server

使用wait-for脚本处理依赖

通过wait-for脚本等待数据库服务启动后再启动应用：

bash
# 等待db服务的5432端口可达后执行启动命令
docker run -v /本地应用路径:/app -w /app [镜像标签] ./wait-for db:5432 -- mix phx.server

wait-for脚本语法：./wait-for <host>:<port> -- <command>，其中<host>:<port>为依赖服务地址与端口，<command>为等待完成后执行的命令。

注意事项

• 本镜像基于Elixir 1.7.2与Phoenix 1.3.4，需确保应用代码兼容对应版本。
• Alpine Linux使用musl libc，若应用依赖glibc库，可能需要额外配置。