calyptia/lua-modules

Calyptia企业解决方案LUA模块镜像

镜像概述和主要用途

该Docker镜像为Calyptia企业解决方案提供专用LUA模块集合，旨在扩展Calyptia企业版产品的功能边界。通过预构建的LUA模块，用户可实现自定义数据处理、日志解析、过滤规则及业务逻辑集成，增强Calyptia在企业级日志管理和数据处理场景中的灵活性。

核心功能和特性

• Calyptia企业版兼容：模块经过官方验证，确保与Calyptia企业解决方案全版本兼容
• 预构建模块集合：包含常用LUA功能模块，无需手动开发即可扩展数据处理能力
• 模块化设计：独立封装的功能模块支持按需集成，减少资源占用并简化维护
• 企业级稳定性：遵循Calyptia企业级标准开发，保障高可用性和可靠性

使用场景和适用范围

• Calyptia功能扩展：为企业版用户提供日志解析、数据转换等自定义功能
• 业务规则集成：通过LUA模块实现特定业务逻辑的数据过滤、 enrichment及路由
• 复杂数据处理：应对企业级日志管理中多格式、高复杂度的数据处理需求
• 第三方系统对接：开发自定义模块实现与内部系统或第三方服务的数据交互

使用方法和配置说明

前提条件

• 已部署Calyptia企业版核心服务
• 具备Docker环境及镜像拉取权限
• 熟悉Calyptia配置文件语法

获取镜像

从Calyptia官方仓库拉取最新版本：

bash
docker pull calyptia/enterprise-lua-modules:latest

模块集成步骤

1. 提取模块文件（可选）

如需查看或修改模块，可通过临时容器提取模块文件：

bash
docker run --rm -v $(pwd)/calyptia-lua-modules:/output \
  calyptia/enterprise-lua-modules:latest \
  cp -r /usr/local/calyptia/lua /output

2. 配置Calyptia服务挂载

通过Docker Compose将模块挂载到Calyptia服务：

yaml
version: '3.8'
services:
  calyptia-enterprise:
    image: calyptia/enterprise:latest
    volumes:
      - ./calyptia-lua-modules/lua:/usr/local/calyptia/lua:ro  # 只读挂载模块目录
    environment:
      - LUA_PATH=/usr/local/calyptia/lua/?.lua;;  # 指定LUA模块搜索路径
    # 其他Calyptia配置参数...

3. 在Calyptia中引用模块

在Calyptia配置文件中通过require语句引用模块：

lua
-- 示例：使用自定义日志解析模块
local json_parser = require("parsers/custom-json")
local result = json_parser.parse(日志数据)

环境变量配置

版本管理

指定特定版本拉取：

bash
docker pull calyptia/enterprise-lua-modules:1.2.0  # 替换为实际版本号

查看可用版本标签：

bash
docker search calyptia/enterprise-lua-modules --filter=stars=0 --format "{{.Tag}}"