puppet/lumogon

镜像概述

Lumogon是一款高效的Docker容器检查与分析工具，能够收集运行中容器的详细信息（如包依赖、标签、主机信息等）并生成结构化JSON报告，帮助用户全面了解容器状态。2018年5月更新后，移除了Google Analytics，且report命令不再默认提交报告至Puppet服务，需通过--endpoint指定替代端点。

核心功能

1. 容器扫描：获取运行中容器的包信息（APK/DPKG/RPM）、标签、主机信息等；
2. 报告生成：输出JSON格式的容器分析报告，支持通过jq工具美化显示；
3. 报告提交：可将报告发送至指定HTTP(S)端点；
4. 调试与定制：提供调试模式、保留临时容器等选项，支持针对特定容器扫描。

使用场景

1. 容器状态审计：定期检查容器的包依赖情况，确保合规性；
2. 故障排查：通过容器详细信息定位运行问题；
3. 数据集成：将容器报告接入内部监控或分析系统。

配置说明

• 需挂载Docker守护进程套接字/var/run/docker.sock以访问容器信息；
• --endpoint参数：指定报告提交的HTTP(S)端点；
• --keep-harvesters参数：保留临时容器用于调试；
• --debug参数：开启详细日志输出。

部署示例

拉取镜像

shell
docker pull puppet/lumogon

扫描容器（带jq美化）

shell
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock puppet/lumogon scan | jq

发送报告至指定端点

shell
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock puppet/lumogon report --endpoint https://my-webservice.domain.com/

查看帮助

shell
docker run --rm -v /var/run/docker.sock:/var/run/docker.sock puppet/lumogon --help

从源码构建

若需自定义或查看源码，可按以下步骤构建：

1. 安装Go（1.8+）、make工具；
2. 设置GOPATH环境变量；
3. 克隆源码并构建：

shell
export GOPATH="${HOME}/go"
mkdir -p ${GOPATH}/src/github.com/puppetlabs
cd ${GOPATH}/src/github.com/puppetlabs
git clone https://github.com/puppetlabs/lumogon
cd $GOPATH/src/github.com/puppetlabs/lumogon
make all

反馈渠道

• Slack频道：[***]
• GitHub仓库：https://github.com/puppetlabs/lumogon/issues