nerdsandcompany/elixir-node

Debian-Erlang-Elixir-Node-Yarn 镜像文档

镜像概述

本镜像基于Debian操作系统构建，预集成Erlang、Elixir、Node.js和Yarn包管理器，旨在为开发者和运维人员提供开箱即用的多语言开发与运行环境。通过整合多种开发工具链，减少环境配置时间，确保开发、测试和生产环境的一致性。

核心功能和特性

• 多语言支持：集成Erlang（函数式编程语言，适用于分布式系统）、Elixir（基于Erlang VM的函数式语言）、Node.js（JavaScript运行时）及Yarn（Node.js包管理器）
• Debian基础：基于稳定版Debian系统，提供可靠的底层环境，兼容Debian生态工具
• 预配置环境：工具链已预先安装并配置，可直接使用erl、elixir、mix、node、npm、yarn等命令
• 轻量级设计：在确保功能完整的前提下优化镜像大小，减少资源占用

使用场景和适用范围

• Erlang/Elixir应用开发：适用于开发、测试Erlang OTP应用或Elixir Phoenix项目
• Node.js项目构建：支持使用Yarn管理依赖，构建React、Vue等前端项目或Node.js后端服务
• 混合语言项目：满足同时使用Erlang/Elixir和Node.js的复杂项目开发需求
• CI/CD环境：可作为持续集成/部署流程中的构建或运行环境，确保环境一致性
• 学习和实验：提供统一环境，方便开发者学习Erlang/Elixir或Node.js技术栈

使用方法和配置说明

基本使用（交互式终端）

通过以下命令启动容器并进入交互式终端：

bash
docker run -it --rm [镜像名称] /bin/bash

• -it：以交互模式运行并分配终端
• --rm：容器退出后自动删除（可选，用于临时开发环境）
• [镜像名称]：替换为实际镜像标签（如username/debian-erlang-elixir-node:latest）

进入容器后，可验证工具是否正常工作：

bash
# 检查Erlang版本
erl -version

# 检查Elixir版本
elixir -v

# 检查Node.js版本
node -v

# 检查Yarn版本
yarn -v

挂载本地项目目录

将本地项目目录挂载到容器中，进行开发或构建：

bash
docker run -it --rm -v /path/to/local/project:/app [镜像名称] /bin/bash

• -v /path/to/local/project:/app：将本地/path/to/local/project目录挂载到容器/app目录
• 进入容器后，通过cd /app即可访问本地项目文件

运行应用示例

Elixir项目构建

bash
# 挂载Phoenix项目并启动开发服务器
docker run -it --rm -v /path/to/phoenix-app:/app -p 4000:4000 [镜像名称] sh -c "cd /app && mix deps.get && mix phx.server"

• -p 4000:4000：映射容器4000端口到本地，用于访问Phoenix开发服务器

Node.js项目构建

bash
# 挂载Node.js项目并安装依赖、构建项目
docker run -it --rm -v /path/to/node-project:/app [镜像名称] sh -c "cd /app && yarn install && yarn build"

自定义配置

环境变量（可选）

可通过-e参数设置环境变量，如代理服务器（适用于网络受限环境）：

bash
docker run -it --rm -e http_proxy=http://proxy.example.com:8080 [镜像名称] /bin/bash

持久化依赖缓存（可选）

为加速依赖安装，可将Yarn或Hex（Elixir包管理器）缓存目录挂载到本地：

bash
# 持久化Yarn缓存
docker run -it --rm -v ~/.yarn-cache:/root/.yarn -v /path/to/project:/app [镜像名称] yarn install

# 持久化Hex缓存
docker run -it --rm -v ~/.hex-cache:/root/.hex -v /path/to/project:/app [镜像名称] mix deps.get

Docker Compose配置示例

创建docker-compose.yml文件，定义服务配置：

yaml
version: '3'
services:
  dev-env:
    image: [镜像名称]
    volumes:
      - ./project:/app  # 挂载项目目录
      - ~/.yarn:/root/.yarn  # 持久化Yarn缓存
      - ~/.hex:/root/.hex  # 持久化Hex缓存
    ports:
      - "4000:4000"  # Phoenix服务器端口
      - "3000:3000"  # Node.js服务器端口
    tty: true  # 保持终端连接

启动服务：

bash
docker-compose up -d

进入容器：

bash
docker-compose exec dev-env /bin/bash