trivadis/smashing

docker-smashing

镜像概述和主要用途

该镜像用于在Docker容器中运行https://github.com/Smashing/smashing%E2%80%94%E2%80%94%E4%B8%80%E4%B8%AA%E5%AE%9E%E6%97%B6%E6%95%B0%E6%8D%AE%E5%8F%AF%E8%A7%86%E5%8C%96%E4%BB%AA%E8%A1%A8%E7%9B%98%E5%B7%A5%E5%85%B7%E3%80%82%E5%9F%BA%E4%BA%8Ehttps://github.com/visibilityspots/dockerfile-smashing%E9%A1%B9%E7%9B%AE%E6%94%B9%E7%BC%96%EF%BC%8C%E6%8F%90%E4%BE%9B%E4%BE%BF%E6%8D%B7%E7%9A%84%E9%83%A8%E7%BD%B2%E6%96%B9%E5%BC%8F%E5%92%8C%E7%81%B5%E6%B4%BB%E7%9A%84%E8%87%AA%E5%AE%9A%E4%B9%89%E9%85%8D%E7%BD%AE%E9%80%89%E9%A1%B9%E3%80%82

核心功能和特性

• 支持自定义容器内运行端口
• 可挂载本地目录实现仪表盘（dashboards）自定义
• 支持任务（jobs）目录挂载，实现数据更新逻辑定制
• 提供小部件（widgets）安装机制，支持Gist ID远程安装和本地目录挂载
• 支持通过环境变量安装依赖 gems
• 可自定义public目录，用于替换favicon、404页面等静态资源
• 配置文件config.ru可通过卷挂载进行个性化配置（如API密钥、认证设置）

使用场景和适用范围

适用于需要快速部署实时数据监控仪表盘的场景，包括但不限于：

• 开发团队系统状态监控
• 运维服务器性能指标可视化
• 业务团队关键绩效指标（KPI）展示
• 项目进度和数据实时跟踪

使用方法和配置说明

基本运行

通过以下命令启动容器，默认将容器内3030端口映射到主机8080端口：

bash
docker run -d -p 8080:3030 trivadis/smashing

启动后，在浏览器中访问 http://localhost:8080/ 即可查看仪表盘。

高级配置

自定义容器内端口

通过环境变量PORT指定容器内Smashing运行端口（如8080）：

bash
docker run -d -e PORT=8080 -p 80:8080 visibilityspots/smashing

自定义仪表盘

通过卷/dashboards挂载本地仪表盘目录（需确保同时提供layout.erb文件）：

bash
docker run -v=/my/custom/dashboards:/dashboards -d -p 8080:3030 visibilityspots/smashing

自定义任务

通过卷/jobs挂载本地任务目录，实现数据获取和更新逻辑：

bash
docker run -v=/my/cool/job:/jobs -d -p 8080:3030 visibilityspots/smashing

自定义小部件

• 远程安装：通过环境变量WIDGETS指定Gist ID安装小部件（多个ID可用逗号分隔）：

  bash
  docker run -d -e WIDGETS=5641535 -p 8080:3030 visibilityspots/smashing
  

  示例将安装https://gist.github.com/chelsea/5641535%E5%B0%8F%E9%83%A8%E4%BB%B6%E3%80%82

• 本地挂载：通过卷/widgets挂载本地小部件目录：

  bash
  docker run -v=/my/cool/widgets:/widgets -d -p 8080:3030 visibilityspots/smashing
  

安装依赖Gems

通过环境变量GEMS指定需安装的gem名称（多个gem用空格分隔）：

bash
docker run -d -e GEMS=instagram -e WIDGETS=5278790 -p 8080:3030 visibilityspots/smashing

示例安装依赖instagram gem的https://gist.github.com/mjamieson/5278790%E5%B0%8F%E9%83%A8%E4%BB%B6%E3%80%82%E5%A4%9Agem%E5%92%8C%E5%A4%9Awidget%E5%8F%AF%E5%90%8C%E6%97%B6%E9%85%8D%E7%BD%AE%EF%BC%9A

bash
docker run -d -e GEMS="mysql instagram" -e WIDGETS=5278790 -p 8080:3030 visibilityspots/smashing

自定义Public文件

通过卷/public挂载本地目录，替换favicon、404页面等静态资源：

bash
docker run -v=/my/custom/public:/public -d -p 8080:3030 visibilityspots/smashing

配置文件自定义

配置文件config.ru通过卷/config挂载，用于修改API密钥、添加认证等高级设置：

bash
docker run -v=/my/custom/config:/config -d -p 8080:3030 visibilityspots/smashing