OpenMetadata本地Docker部署指南

前言

OpenMetadata是一个开源的元数据管理平台，它提供了一套完整的解决方案来收集、管理和探索数据资产。本文将详细介绍如何在本地环境中使用Docker快速部署OpenMetadata，适合想要快速体验OpenMetadata功能的开发者和数据工程师。

环境准备

系统要求

OpenMetadata支持在以下操作系统上通过Docker部署：

• macOS
• Linux
• Windows（需通过WSL2）

软件要求

1. Docker：版本20.10.0或更高

   • 验证命令：docker --version
   • 内存分配：建议为Docker分配至少6GiB内存和4个vCPU

2. Docker Compose：版本v2.1.1或更高

   • 验证命令：docker compose version
   • 在Linux系统上可能需要单独安装

Windows特殊要求

Windows用户需要通过WSL2运行：

1. 安装WSL2
2. 安装Ubuntu 20.04 LTS
3. 安装Docker Desktop for Windows
4. 在Ubuntu系统中安装必要的Python包：

   sudo apt install python3-pip python3-venv
   

部署步骤

1. 创建项目目录

mkdir openmetadata-docker && cd openmetadata-docker

2. 获取Docker Compose文件

OpenMetadata提供两种数据库选项：

• MySQL（默认）
• PostgreSQL

获取对应版本的docker-compose文件：

# MySQL版本
curl -sL -o docker-compose.yml https://下载地址/docker-compose.yml

# PostgreSQL版本
curl -sL -o docker-compose-postgres.yml https://下载地址/docker-compose-postgres.yml

3. 启动服务

根据选择的数据库类型运行对应命令：

# MySQL版本
docker compose -f docker-compose.yml up --detach

# PostgreSQL版本
docker compose -f docker-compose-postgres.yml up --detach

启动后，可以使用docker ps命令验证所有容器是否正常运行。

访问服务

OpenMetadata UI

• 访问地址：http://localhost:8585
• 默认管理员账号：
  • 用户名：[e-mail]
  • 密码：admin

Airflow UI

OpenMetadata内置了Airflow容器用于运行元数据摄取工作流：

• 访问地址：http://localhost:8080
• 默认账号：
  • 用户名：admin
  • 密码：admin

可以通过设置以下环境变量来自定义Airflow管理员凭据：

• AIRFLOW_ADMIN_USER
• AIRFLOW_ADMIN_PASSWORD

服务管理

停止服务

docker compose stop

启动服务

docker compose start

完全清理

# 停止并删除容器
docker compose down

# 停止并删除容器及数据卷
docker compose down --volumes

常见问题解决

1. "compose"不是docker命令：

   • 确保正确安装了Docker Compose V2

2. 网络创建错误：

   docker network prune
   

   注意：这将删除所有未被使用的自定义网络

3. Windows权限问题： 在WSL2的/etc/wsl.conf中添加：

   [automount]
   options = "metadata,case=force"
   

安全建议

虽然本文介绍的是本地开发环境部署，但生产环境部署时请务必配置安全措施，包括但不限于：

• 修改默认管理员密码
• 配置HTTPS
• 设置适当的访问控制

后续步骤

成功部署后，您可以：

1. 探索OpenMetadata的各种功能
2. 集成更多数据源连接器
3. 通过API扩展功能
4. 配置自动化元数据摄取工作流

总结

通过Docker部署OpenMetadata是最快速的上手方式，适合开发测试环境使用。本文详细介绍了从环境准备到服务管理的完整流程，帮助您快速搭建自己的元数据管理平台。对于生产环境，建议参考官方文档进行更详细的配置和优化。