1maa/erlang

Erlang开发镜像

镜像概述与主要用途

本镜像基于erlang:21-alpine构建，是一个轻量级的Erlang开发环境扩展。它集成了rebar3构建工具，开放TCP端口8080以支持Web服务暴露，并预装多个实用全局插件，旨在为Erlang应用开发提供便捷、高效的开发环境，简化构建、依赖管理和代码热重载流程。

核心功能与特性

基础环境

• 轻量级基础：基于erlang:21-alpine，继承Alpine Linux的轻量特性，减少镜像体积
• 内置rebar3：包含Erlang官方构建工具rebar3，支持项目构建、依赖管理等核心开发流程

网络支持

• 开放端口：默认开放TCP端口8080，便于直接暴露Web服务或其他网络应用

全局插件

• rebar_cmd：允许在rebar.config中定义自定义任务，扩展构建流程灵活性
• rebar3_auto：监控源文件变化，自动触发编译并重新加载修改的模块，提升开发迭代效率
• rebar3_hex：集成hex.pm包管理器，支持Erlang依赖包的查找、安装与发布

使用场景与适用范围

• Erlang应用开发：适用于各类Erlang应用（如Web服务、分布式系统等）的开发阶段
• 快速原型验证：利用自动编译重载功能，加速代码修改与效果验证循环
• 标准化开发环境：统一团队开发环境，避免因工具版本差异导致的问题
• 依赖管理需求：需通过hex.pm管理第三方依赖的Erlang项目

使用方法与配置说明

基本运行命令

bash
docker run -it --rm -p 8080:8080 -v $(pwd):/app erlang-dev-image

• -it：交互式终端，便于执行命令
• --rm：退出后自动删除容器，避免残留
• -p 8080:8080：映射容器8080端口到主机，暴露Web服务
• -v $(pwd):/app：挂载本地项目目录到容器内/app，实现代码同步

插件使用示例

rebar3_auto自动编译

在项目目录下执行以下命令启动自动编译监控：

bash
rebar3 auto

修改源文件后，工具将自动检测变化并重新编译加载。

rebar_cmd自定义任务

在rebar.config中定义自定义任务：

erlang
{plugins, [rebar_cmd]}.
{cmd, [{my_task, "echo '执行自定义任务' && rebar3 compile"}]}.

执行自定义任务：

bash
rebar3 cmd my_task

rebar3_hex依赖管理

搜索hex.pm上的依赖包：

bash
rebar3 hex search <package_name>

添加依赖到rebar.config并安装：

erlang
{deps, [{package_name, "1.0.0"}]}.

bash
rebar3 get-deps

docker-compose配置示例

yaml
version: '3'
services:
  erlang-dev:
    image: erlang-dev-image
    ports:
      - "8080:8080"
    volumes:
      - ./:/app
    tty: true
    command: rebar3 auto

启动服务：

bash
docker-compose up