lua-docker 镜像文档

镜像概述和主要用途

lua-docker 是一系列针对不同 Lua 版本的最小化、自动化且持续更新的 Docker 镜像。该项目旨在提供简洁、可靠的 Lua 运行环境，支持多种基础操作系统和版本组合，满足不同场景下的开发、测试和生产需求。

核心功能和特性

• 多 Lua 版本支持：涵盖 Lua 5.4、5.3、5.2 等稳定版本，包括具体补丁版本（如 5.4.8、5.3.6、5.2.4）。
• 多基础镜像变体：提供 Debian（Trixie、Bookworm）、Alpine（3.22、3.21）、Ubuntu（rolling、plucky）等多种基础镜像选择。
• LuaRocks 集成：提供预安装 LuaRocks（Lua 包管理器）的镜像变体，简化依赖管理。
• 自动化更新机制：通过每日 GitHub Actions 工作流自动检测 Lua 和 LuaRocks 新版本，触发镜像构建、标记和推送，确保镜像时效性。
• 最小化设计：基础镜像仅包含运行 Lua 及安装纯 Lua 模块所需的核心依赖，保持镜像体积精简。

支持的标签和 Dockerfile 链接

Lua 5.4 系列

Debian 基础镜像

• 5, 5-debian, 5-trixie, 5.4, 5.4-debian, 5.4-trixie, 5.4.8, 5.4.8-debian, 5.4.8-trixie, debian, latest
  Dockerfile

• 5-bookworm, 5.4-bookworm, 5.4.8-bookworm
  Dockerfile

Debian + LuaRocks 变体

• 5-luarocks, 5-luarocks-debian, 5-luarocks-trixie, 5.4-luarocks, 5.4-luarocks-debian, 5.4-luarocks-trixie, 5.4.8-luarocks, 5.4.8-luarocks-debian, 5.4.8-luarocks-trixie, luarocks, luarocks-debian
  Dockerfile

• 5-luarocks-bookworm, 5.4-luarocks-bookworm, 5.4.8-luarocks-bookworm
  Dockerfile

Alpine 基础镜像

• 5-alpine, 5-alpine3, 5-alpine3.22, 5.4-alpine, 5.4-alpine3.22, 5.4.8-alpine, 5.4.8-alpine3, 5.4.8-alpine3.22, alpine
  Dockerfile

• 5-alpine3.21, 5.4-alpine3.21, 5.4.8-alpine3.21
  Dockerfile

Alpine + LuaRocks 变体

• 5-luarocks-alpine, 5-luarocks-alpine3, 5-luarocks-alpine3.22, 5.4-luarocks-alpine, 5.4-luarocks-alpine3.22, 5.4.8-luarocks-alpine, 5.4.8-luarocks-alpine3, 5.4.8-luarocks-alpine3.22, luarocks-alpine
  Dockerfile

• 5-luarocks-alpine3.21, 5.4-luarocks-alpine3.21, 5.4.8-luarocks-alpine3.21
  Dockerfile

Ubuntu 基础镜像

• 5-rolling, 5.4-rolling, 5.4.8-rolling
  Dockerfile

• 5-plucky, 5.4-plucky, 5.4.8-plucky
  Dockerfile

Ubuntu + LuaRocks 变体

• 5-luarocks-rolling, 5.4-luarocks-rolling, 5.4.8-luarocks-rolling
  Dockerfile

• 5-luarocks-plucky, 5.4-luarocks-plucky, 5.4.8-luarocks-plucky
  Dockerfile

Lua 5.3 系列

Debian 基础镜像

• 5.3, 5.3-debian, 5.3-trixie, 5.3.6, 5.3.6-debian, 5.3.6-trixie
  Dockerfile

• 5.3-bookworm, 5.3.6-bookworm
  Dockerfile

Debian + LuaRocks 变体

• 5.3-luarocks, 5.3-luarocks-debian, 5.3-luarocks-trixie, 5.3.6-luarocks, 5.3.6-luarocks-debian, 5.3.6-luarocks-trixie
  Dockerfile

• 5.3-luarocks-bookworm, 5.3.6-luarocks-bookworm
  Dockerfile

Alpine 基础镜像

• 5.3-alpine, 5.3-alpine3.22, 5.3.6-alpine, 5.3.6-alpine3, 5.3.6-alpine3.22
  Dockerfile

• 5.3-alpine3.21, 5.3.6-alpine3.21
  Dockerfile

Alpine + LuaRocks 变体

• 5.3-luarocks-alpine, 5.3-luarocks-alpine3.22, 5.3.6-luarocks-alpine, 5.3.6-luarocks-alpine3, 5.3.6-luarocks-alpine3.22
  Dockerfile

• 5.3-luarocks-alpine3.21, 5.3.6-luarocks-alpine3.21
  Dockerfile

Ubuntu 基础镜像

• 5.3-rolling, 5.3.6-rolling
  Dockerfile

• 5.3-plucky, 5.3.6-plucky
  Dockerfile

Ubuntu + LuaRocks 变体

• 5.3-luarocks-rolling, 5.3.6-luarocks-rolling
  Dockerfile

• 5.3-luarocks-plucky, 5.3.6-luarocks-plucky
  Dockerfile

Lua 5.2 系列

Debian 基础镜像

• 5.2, 5.2-debian, 5.2-trixie, 5.2.4, 5.2.4-debian, 5.2.4-trixie
  Dockerfile

• 5.2-bookworm, 5.2.4-bookworm
  Dockerfile

Debian + LuaRocks 变体

• 5.2-luarocks, 5.2-luarocks-debian, 5.2-luarocks-trixie, 5.2.4-luarocks, 5.2.4-luarocks-debian, 5.2.4-luarocks-trixie
  Dockerfile

• 5.2-luarocks-bookworm, 5.2.4-luarocks-bookworm
  Dockerfile

Alpine 基础镜像

• 5.2-alpine, 5.2-alpine3.22, 5.2.4-alpine, 5.2.4-alpine3, 5.2.4-alpine3.22
  Dockerfile

• 5.2-alpine3.21, 5.2.4-alpine3.21
  Dockerfile

Alpine + LuaRocks 变体

• 5.2-luarocks-alpine, 5.2-luarocks-alpine3.22, 5.2.4-luarocks-alpine, 5.2.4-luarocks-alpine3, 5.2.4-luarocks-alpine3.22
  Dockerfile

• 5.2-luarocks-alpine3.21, 5.2.4-luarocks-alpine3.21
  Dockerfile

Ubuntu 基础镜像

• 5.2-rolling, 5.2.4-rolling
  Dockerfile

• 5.2-plucky, 5.2.4-plucky
  Dockerfile

Ubuntu + LuaRocks 变体

• 5.2-luarocks-rolling, 5.2.4-luarocks-rolling
  Dockerfile

• 5.2-luarocks-plucky, 5.2.4-luarocks-plucky
  Dockerfile

镜像变体

nickblah/lua:<version>

• 基础镜像：Debian（如 Trixie、Bookworm）
• 包含内容：指定版本的 Lua 解释器及核心依赖
• 适用场景：需要最小化 Debian 环境的 Lua 运行场景

nickblah/lua:<version>-alpine

• 基础镜像：Alpine Linux（如 3.22、3.21）
• 包含内容：指定版本的 Lua 解释器及 Alpine 核心依赖
• 特点：镜像体积更小，适合资源受限环境
• 适用场景：对镜像大小敏感的部署场景

nickblah/lua:<version>-luarocks

• 基础镜像：Debian（如 Trixie、Bookworm）
• 包含内容：Lua 解释器 + LuaRocks 包管理器
• 适用场景：需要通过 LuaRocks 管理依赖的开发或运行环境

nickblah/lua:<version>-luarocks-alpine

• 基础镜像：Alpine Linux（如 3.22、3.21）
• 包含内容：Lua 解释器 + LuaRocks 包管理器
• 特点：小体积 + 依赖管理能力
• 适用场景：资源受限且需依赖管理的场景

使用场景和适用范围

1. Lua 应用开发环境
   提供隔离的 Lua 版本环境，支持快速切换 Lua 版本和基础系统。

2. CI/CD 流程集成
   在自动化构建、测试流程中作为 Lua 运行环境，确保环境一致性。

3. 轻量级生产部署
   基于 Alpine 变体的小体积特性，适合容器化生产部署。

4. Lua 版本兼容性测试
   便捷测试应用在不同 Lua 版本（5.4/5.3/5.2）下的兼容性。

5. LuaRocks 包管理场景
   通过 -luarocks 变体快速安装和管理 Lua 第三方库。

使用方法和配置说明

基本使用示例

1. 运行 Lua 交互式解释器

bash
# 使用最新版（默认 Debian 基础）
docker run -it --rm nickblah/lua lua

# 使用特定版本（如 Lua 5.4 Alpine 变体）
docker run -it --rm nickblah/lua:5.4-alpine lua

2. 运行本地 Lua 脚本

假设本地脚本路径为 ./script.lua：

bash
# 挂载当前目录并运行脚本
docker run -it --rm -v "$(pwd)":/app -w /app nickblah/lua lua script.lua

# 使用 Lua 5.3 版本
docker run -it --rm -v "$(pwd)":/app -w /app nickblah/lua:5.3 lua script.lua

3. 使用 LuaRocks 安装依赖

以安装 luasocket 为例：

bash
# 使用 Debian LuaRocks 变体
docker run -it --rm nickblah/lua:luarocks luarocks install luasocket

# 使用 Alpine LuaRocks 变体
docker run -it --rm nickblah/lua:luarocks-alpine luarocks install luasocket

Docker Compose 配置示例

创建 docker-compose.yml：

yaml
version: '3'
services:
  lua-app:
    image: nickblah/lua:5.4-luarocks-alpine
    volumes:
      - ./app:/app
    working_dir: /app
    command: lua main.lua

启动服务：

bash
docker-compose up

安装 C 扩展依赖

基础镜像为最小化设计，如需安装含 C 扩展的 LuaRocks 模块（如 luasocket、lua-cjson），需先安装构建工具链：

Debian 系列镜像

bash
docker run -it --rm nickblah/lua:luarocks sh -c "
  apt-get update && apt-get install -y build-essential && \
  luarocks install luasocket
"

Alpine 系列镜像

bash
docker run -it --rm nickblah/lua:luarocks-alpine sh -c "
  apk add --no-cache build-base && \
  luarocks install luasocket