metabase/metabase-dev

Metabase分支镜像文档

1. 镜像概述

Metabase分支镜像是基于Metabase开源数据分析与可视化工具构建的特殊版本镜像，包含Metabase项目的不同开发分支（如开发分支、测试分支、特性分支等）。该镜像旨在为开发者和测试人员提供便捷的多版本部署选项，支持在开发、测试环境中快速验证新功能、修复问题及验证特定分支的稳定性。

2. 核心功能与特性

• 多分支支持：集成Metabase的多个开发分支版本，可按需选择特定分支（如master主分支、feature/*特性分支、bugfix/*修复分支等）进行部署
• 功能一致性：各分支镜像保留Metabase核心功能，包括多数据源连接（SQL、NoSQL、云数据库等）、可视化报表生成、交互式仪表盘、数据导出、权限管理等
• 轻量部署：基于官方基础镜像构建，镜像体积优化，支持容器化快速启动，资源占用低
• 灵活配置：支持环境变量、配置文件挂载等多种配置方式，适配不同开发测试场景需求

3. 使用场景与适用范围

• 开发测试环境：开发者在本地或CI/CD流程中部署特定开发分支，验证代码变更、新功能实现及兼容性
• 功能预览：测试人员部署特性分支，提前预览未发布功能，进行功能验证、用户体验测试及问题反馈
• 版本验证：在正式环境部署前，通过分支镜像验证特定版本分支的稳定性、性能表现及与现有系统的兼容性

4. 使用方法与配置说明

4.1 基本部署（Docker Run）

通过以下命令快速启动指定分支的Metabase容器：

bash
docker run -d -p 3000:3000 --name metabase-branch metabase/branches:<branch-name>

• <branch-name>：指定Metabase分支名称（具体可用分支需参考镜像仓库标签，如master、0.46.x、feature/new-visualization等）
• -p 3000:3000：映射容器3000端口到主机（Metabase默认Web服务端口）
• --name metabase-branch：自定义容器名称，便于管理

4.2 数据持久化配置

为避免容器重启后数据丢失（如用户配置、报表数据等），需挂载本地目录持久化数据：

bash
docker run -d -p 3000:3000 \
  -v /path/to/local/data:/metabase-data \
  --name metabase-branch \
  metabase/branches:<branch-name>

• /path/to/local/data：主机本地数据持久化目录（需确保有读写权限）
• /metabase-data：容器内Metabase数据存储默认路径

4.3 环境变量配置

支持通过环境变量自定义数据库连接、服务配置等，常用环境变量如下：

示例：使用PostgreSQL作为元数据库

bash
docker run -d -p 3000:3000 \
  -e MB_DB_TYPE=postgres \
  -e MB_DB_DBNAME=metabase_dev \
  -e MB_DB_USER=dev_user \
  -e MB_DB_PASS=dev_pass \
  -e MB_DB_HOST=postgres-host \
  -e MB_DB_PORT=5432 \
  -v /path/to/local/data:/metabase-data \
  --name metabase-branch \
  metabase/branches:master

4.4 访问与初始化

容器启动后，通过http://<主机IP>:3000访问Metabase Web界面，首次使用需完成初始化配置：

1. 设置管理员账户（用户名、密码、***）
2. 添加数据源（根据需求配置数据库连接信息）
3. 创建第一个仪表盘或报表（支持SQL查询、可视化配置等）

5. 注意事项

• 环境限制：分支镜像主要用于开发测试环境，生产环境建议使用Metabase官方稳定版本镜像
• 分支稳定性：不同开发分支可能存在未完善功能或潜在问题，使用前需确认分支特性及兼容性说明
• 数据安全：测试环境中避免存储敏感数据，生产数据建议通过只读权限数据源连接
• 版本更新：分支镜像会随上游代码更新同步构建，如需固定版本，建议指定具体分支标签并定期更新