ipac/firefly

Firefly Docker镜像文档

概述

Firefly是IPAC（加州理工学院红外处理与分析中心）的高级天文Web UI框架，用于构建基于Web的前端以访问科学档案，并提供复杂的交互式数据可视化能力。

• GitHub：https://github.com/Caltech-IPAC/firefly%EF%BC%8Chttps://github.com/Caltech-IPAC/firefly/blob/dev/docs/release-notes.md

最新标签

• latest - 始终指向最新发布版本
• 2025.4 - 始终指向最新的2025.4版本
• 2025.4.2 - 2025年9月18日发布版本
• 2025.4.0 - 2025年9月2日发布版本
• 2025.3.7 - 2025年7月23日发布版本
• 2025.3.6 - 2025年7月3日发布版本
• 2025.3 - 始终指向最新的2025.3版本
• 2025.2 - 始终指向最新的2025.2版本
• 2025.2.1 - 2025年3月14日发布版本
• 2025.1 - 始终指向最新的2025.1版本
• 2025.1.1 - 2025年2月6日发布版本
• nightly - 每日构建版本 - 不稳定，适合测试

使用示例

以下参数说明：

• -e：在容器中定义环境变量
• -m（或--memory=）：容器可使用的最大内存量
• -p：将本地端口映射到容器端口（8080端口为必需）
• -v：将本地目录映射到容器目录
• --rm：运行后删除容器（推荐）

以下示例使用latest标签，您可替换为任何可用标签，例如release-2019.2.1。

非常简单 - 建议先尝试此示例

bash
docker run -p 80:8080 -m 4g --rm ipac/firefly:latest

• 通过以下地址访问Firefly - http://localhost/firefly/

更高级的用法

后台运行：

bash
docker run -d -p 80:8080 --memory=8g --rm ipac/firefly:latest

• 通过以下地址访问Firefly - http://localhost/firefly/

映射目录以直接读取文件：

bash
docker run -p 80:8080 -v /local/data:/external --memory=8g --rm ipac/firefly:latest

• 通过以下地址访问Firefly - http://localhost/firefly/

将日志写入容器外部目录：

bash
docker run -p 80:8080 -v /local/myLogDir:/firefly/logs --memory=8g --rm ipac/firefly:latest

• 通过以下地址访问Firefly - http://localhost/firefly/

查看日志文件：

• 当以交互模式运行Firefly时，日志会输出到终端。如果以分离模式（后台）运行，需为容器命名以便使用docker logs命令获取日志。

bash
docker run --name test -d -p 80:8080 --memory=8g --rm ipac/firefly:latest
docker logs -f test

• 通过以下地址访问Firefly - http://localhost/firefly/

调试模式：

bash
docker run -p 8055:8080 -p 5050:5050 --memory=4g -e "ADMIN_PASSWORD=myPassword" -e DEBUG="TRUE" --rm --name firefly ipac/firefly:latest

• 通过以下地址访问Firefly - http://localhost:8055/firefly/

类生产环境：

bash
docker run -p 8055:8080 --memory=30g -e "ADMIN_PASSWORD=myPassword" -e DEBUG="FALSE" --name productionServer ipac/firefly:latest

• 通过以下地址访问Firefly - http://localhost:8055/firefly/

类生产环境（多Tomcat实例，使用共享工作目录）：

bash
docker run -p 8055:8080 --memory=30g -e "ADMIN_PASSWORD=myPassword" -v /local/shared/work/area:/firefly/shared-workarea --name productionServer ipac/firefly:latest

• 通过以下地址访问Firefly - http://localhost:8055/firefly/

环境变量

高级环境变量

(*) 键值对之间用空格分隔

端口

• 8080 - HTTP协议端口
• 5050 - 调试端口

卷挂载点

• /firefly/logs：日志目录
• /firefly/workarea：临时文件工作区
• /firefly/shared-workarea：多实例间共享文件的工作区
• /external：Firefly可见的默认外部数据目录

较少使用：

• /firefly/config：用于覆盖应用程序属性
• /firefly/logs/statistics：统计日志目录
• /firefly/alerts：警报监控器会监视此目录以获取应用程序警报

命令行选项

• --help：显示帮助信息、示例，然后退出
• --debug：以调试模式启动

自定义配置

要微调配置，需替换启动页面（index.html或slate.html）为自定义版本，步骤如下：

1. 从示例中提取并准备文件：

   • 创建一个空目录用于映射到容器（例如：mkdir /myDir）
   • 运行以下命令，容器会将示例HTML文件放入该目录：

     bash
     docker run --rm -v /myDir:/local/www --name firefly ipac/firefly:latest --help
     

   • 编辑自定义文件（例如：/myDir/index.html）

2. 运行自定义配置的Firefly：

   bash
   docker run -p 80:8080 -v /myDir:/local/www -m 4g --rm --name firefly ipac/firefly:latest
   

   • Firefly会将此目录映射为"local"
   • 通过自定义启动页面访问Firefly - http://localhost/local/ 或 http://localhost/local/myFireflyPage.html