Erlang Docker镜像文档

镜像概述和主要用途

Erlang Solutions提供的多用途Docker镜像，预安装Erlang编程语言，基于多种Linux发行版构建。这些镜像旨在满足不同场景需求，包括CircleCI持续集成作业执行、Erlang软件包构建与运行等。

核心功能和特性

• CircleCI便捷镜像：基于cimg/base构建，适用于CircleCI作业执行，遵循CircleCI便捷镜像规范。
• 多Linux发行版支持：包含Ubuntu、Debian、Rocky Linux和AlmaLinux等发行版，满足多样化的软件构建环境需求。

使用场景和适用范围

• CircleCI持续集成：作为CircleCI Docker执行器的基础镜像，用于运行Erlang相关的CI/CD作业。
• 软件包构建：为Erlang项目（如MongooseIM）提供一致的构建环境，确保跨不同Linux发行版的软件包兼容性。
• Erlang应用运行：可直接用于部署和运行Erlang应用程序。

使用方法和配置说明

直接使用Docker Hub镜像

镜像托管于erlangsolutions/erlang Docker Hub仓库，可直接拉取使用。

标签格式说明

• CircleCI镜像：标签格式为cimg-${ERLANG_VERSION}，例如cimg-27.1.2。
• 其他发行版镜像：标签格式为${OS}-${RELEASE}-${ERLANG_VERSION}，例如ubuntu-jammy-27.1.2（Ubuntu Jammy版本，Erlang 27.1.2）。

使用示例

1. CircleCI配置示例：在.circleci/config.yml中使用CircleCI镜像：

   version: 2.1
   jobs:
     build:
       docker:
         - image: erlangsolutions/erlang:cimg-27.1.2
       steps:
         - checkout
         - run: erl -eval 'io:format("Erlang version: ~s~n", [erlang:system_info(otp_release)]).' -s init stop
   

2. 本地运行示例：使用Ubuntu发行版镜像启动Erlang shell：

   docker run -it --rm erlangsolutions/erlang:ubuntu-jammy-27.1.2 erl
   

手动构建镜像

若需自定义构建，可克隆esl/cimg-erlang仓库，使用build.sh脚本构建：

# 示例：构建基于Ubuntu Jammy的Erlang 27.1.2镜像
OTP_VERSION=27.1.2 BASE_IMAGE=ubuntu:jammy ./build.sh

注意：仅支持部分Linux发行版，具体可参考仓库中的tools/prepare.sh文件。