gaerfield/saiku

saiku容器镜像

镜像概述和主要用途

本镜像为https://github.com/OSBI/saiku%E6%8F%90%E4%BE%9B%E5%AE%B9%E5%99%A8%E5%8C%96%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%EF%BC%8C%E4%BE%BF%E4%BA%8E%E5%BF%AB%E9%80%9F%E9%83%A8%E7%BD%B2%E5%92%8C%E4%BD%BF%E7%94%A8saiku%E5%88%86%E6%9E%90%E5%B7%A5%E5%85%B7%E3%80%82saiku%E6%98%AF%E4%B8%80%E6%AC%BE%E5%BC%80%E6%BA%90%E7%9A%84%E5%95%86%E5%8A%A1%E6%99%BA%E8%83%BD%E5%88%86%E6%9E%90%E5%B7%A5%E5%85%B7%EF%BC%8C%E6%94%AF%E6%8C%81%E5%A4%9A%E7%BB%B4%E6%95%B0%E6%8D%AE%E5%88%86%E6%9E%90%E5%92%8C%E6%8A%A5%E8%A1%A8%E7%94%9F%E6%88%90%E3%80%82

核心功能和特性

• 环境变量$SAIKU_HOME已设置
• 可挂载的数据目录用于持久化数据
  • 环境变量名为INSTANCEDIR
  • 默认路径为/saiku/data
• 启动时自动上传许可证
  • 将许可证文件挂载到/saiku_license.lic
  • 通过http://容器URL/upload.html更新许可证
• 引导额外立方体配置（文件需挂载到/additionalCubes）
• 执行引导shell脚本（文件需挂载到/docker-entrypoint-initdb.d）

使用场景和适用范围

适用于需要快速部署saiku进行多维数据分析、报表生成的场景，可用于开发、测试及生产环境，尤其适合需要持久化配置和数据的用户。

使用方法和配置说明

前提条件

1. 生成许可证并提供给Docker容器

Docker Compose配置

使用以下docker-compose.yml配置文件：

yaml
version: '2'
services:
  saiku:
    image: gaerfield/saiku
    ports:
      - 10040:8080
    volumes:
      # 仅在引导阶段（容器首次创建）使用的挂载
      - ./config/saiku_license.lic:/saiku_license.lic
      - ./config/cubes:/additionalCubes
      - ./config/bootstrapScripts:/docker-entrypoint-initdb.d
      # 用于持久化（引导时会覆盖！）
      - ./data/saiku:/saiku/data/

启动容器

执行以下命令启动容器：

bash
docker-compose up -d

常见问题（FAQ）

是否可以使用不同的tomcat镜像作为基础镜像？

目前没有兼容的方法。saiku的二进制发行版自带特定版本的tomcat，且使用自定义启动脚本。为保证向后兼容性，建议使用saiku自带的环境。

如何配置额外的Java参数？

saiku使用自定义https://github.com/OSBI/saiku/blob/development/saiku-server/scripts/start-saiku.sh%EF%BC%8C%E5%85%B6%E4%B8%ADJava%E5%8F%82%E6%95%B0%E6%98%AF%E7%A1%AC%E7%BC%96%E7%A0%81%E7%9A%84%E3%80%82%E5%8F%AF%E9%80%9A%E8%BF%87%E4%BB%A5%E4%B8%8B%E6%96%B9%E5%BC%8F%E9%85%8D%E7%BD%AE%EF%BC%9A

• 方法一：复制saiku的https://github.com/OSBI/saiku/blob/development/saiku-server/scripts/start-saiku.sh%E5%B9%B6%E6%8C%82%E8%BD%BD%E5%88%B0%60$SAIKU_HOME/start-saiku.sh%60%EF%BC%88%E9%BB%98%E8%AE%A4%E8%B7%AF%E5%BE%84%60/saiku/start-saiku.sh%60%EF%BC%89
• 方法二：在docker-entrypoint-initdb.d中提供shell脚本，使用sed命令修改启动脚本中的参数（注意此脚本仅执行一次）

为什么使用docker-entrypoint-initdb.d文件夹？

该文件夹中的sh文件会在引导阶段（容器首次启动时）按字母顺序执行，且在saiku启动之前。例如，可用于下载saiku所需的额外库（如https://github.com/gaerfield/saiku/blob/master/config/bootstrapScripts/installMysqlLib.sh%E7%A4%BA%E4%BE%8B%E8%84%9A%E6%9C%AC%E4%B8%8B%E8%BD%BDmysql%E8%BF%9E%E6%8E%A5%E5%99%A8%E5%BA%93%EF%BC%89%E3%80%82

链接

• https://github.com/gaerfield/saiku/blob/master/Dockerfile
• Saiku相关链接：
  • https://github.com/OSBI/saiku
  • 主页
  • 许可证