20 分钟本地跑通 OpenMetadataDocker 部署快速上手指南【免费下载链接】OpenMetadataThe Open Context Layer for Data and AI , OpenMetadata is the open platform for building trusted data context and business semantics for humans, AI assistants, and agents.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMetadata想在自己的机器上先跑一个 OpenMetadata开源元数据管理平台试试或者需要给学习者发一套现成的「元数据目录 数据血缘」练习环境用 Docker Compose 做本地部署是最短路径一条命令拉起服务端、摄取服务和搜索、数据库浏览器里直接登录控制台。整个栈一共 4 个常驻容器OpenMetadata Server主服务、Ingestion基于 Airflow 的数据摄取、Elasticsearch/OpenSearch全文检索、MySQL 或 PostgreSQL元数据存储。本文只讲一件事怎么在你本机上把它跑起来并确认它真的跑起来了。开工前 30 秒自检先把下面这张表过一遍全部打勾再动手能省掉 80% 的排查时间。自检项达标标准怎么确认- [ ] Docker版本 ≥ 20.10终端执行docker --version- [ ] Docker ComposeV2版本 ≥ v2.1.1docker compose version- [ ] 内存≥ 6GB建议 8GBDocker Desktop → Settings → ResourcesmacOS/Linux 看宿主机空闲内存- [ ] CPU / 磁盘≥ 4 核 / ≥ 10GB 可用同上- [ ] 端口空闲8585、8080、3306、9200 未被占用netstat -an \| grep 8585macOS/Linux- [ ] 仓库已克隆本地有一份完整源码见下一步第 1 步⚠️ 资源不够时最先被拖垮的是 Elasticsearch 和 Airflow启动会卡在健康检查上。3 步启动整套服务先给最短路径数据库选型、Windows 差异放到后面「可选方案」里再说。第 1 步拿到代码Compose 文件就在仓库里不用另找下载地址克隆仓库进入放 Compose 文件的目录 docker/development/git clone https://gitcode.com/GitHub_Trending/op/OpenMetadata cd OpenMetadata/docker/development第 2 步一条命令后台启动全部容器默认走 MySQL 版编排文件 docker/development/docker-compose.yml首次运行会拉取并构建镜像需要几分钟属于正常现象docker compose -f docker-compose.yml up -d第 3 步打开浏览器等服务就绪后访问http://localhost:8585用默认账号登录即可账号信息见下一节。可选方案想换 PostgreSQL换一份编排文件即可它把 MySQL 换成 PostgreSQL、Elasticsearch 换成 OpenSearch其余流程完全一致docker compose -f docker-compose-postgres.yml up -d对应文件是 docker/development/docker-compose-postgres.yml此时宿主机占用的是 5432 而非 3306。Windows 用户走 WSL2 后端Microsoft Store 安装 Ubuntu 20.04 Docker Desktop for Windows。若文件挂载报权限错误编辑/etc/wsl.conf追加[automount] options metadata,caseforce想改端口、日志级别都在编排文件的环境变量里如SERVER_PORT服务端配置模板见 conf/openmetadata.yaml。确认部署成功跑通后的「成功样子」长这样按顺序核对容器状态执行docker ps应看到 4 个Up状态的容器openmetadata_server、openmetadata_ingestion、搜索服务、数据库其中execute_migrate_all是一次性迁移任务跑完自动退出属正常。健康检查服务端健康端点在管理端口 8586curl -s -o /dev/null -w %{http_code} http://localhost:8586/healthcheck返回200即服务就绪。 3. 页面打开http://localhost:8585输入默认账号看到控制台首页就说明本地部署成功默认账号信息两个控制台都记一下控制台地址用户名密码OpenMetadata UIhttp://localhost:8585adminopen-metadata.orgadminAirflow UI摄取调度http://localhost:8080adminadmin日常操作速查以后基本只用得到下面这张表不用再翻文档操作命令说明查看运行状态docker ps确认 4 个容器都在Up停服保留数据docker compose stop容器停止卷和网络保留重新拉起docker compose start接着上次的数据继续跑停止并删除容器docker compose down数据卷保留可再次 up彻底清理含数据docker compose down -v⚠️ 元数据不可恢复慎用排查服务日志docker compose logs -f openmetadata-server启动卡住时先看它清理残留网络docker network prune网络冲突报错后的第一动作踩坑急救包症状可能原因解决办法up时报端口绑定失败如 8585 / 3306 already in use本机其他应用占用了端口关掉占用程序或在编排文件中把ports左侧宿主机端口改掉报网络创建/冲突错误上次down未清干净残留同名网络执行docker network prune后重新up容器反复重启Elasticsearch 健康检查不通过分配给 Docker 的内存不足把 Docker 可用内存调到 ≥ 6GB或临时关闭其他吃内存的容器页面一直转圈、登录无响应数据库迁移任务execute-migrate-all还没跑完等它完成状态Exited (0)再用curl http://localhost:8586/healthcheck复验WSL2 下挂载卷权限报错automount 未开启元数据支持按「可选方案」中配置/etc/wsl.conf并重启 WSL生产化提醒与下一步本地环境跑通只是起点。如果哪天要对外提供服务先做这 4 件事改掉admin默认密码、启用 HTTPS、收紧访问控制防火墙/白名单、不要把 3306、9200 这类内部端口暴露到公网。接着可以按这个顺序玩起来在 UI 里添加第一个数据库连接跑一次元数据摄取现成配置可参考 ingestion/examples/sample_configs/配置数据质量规则给核心表加上新鲜度和空值检查打开表详情页追一遍列级血缘用 Python SDK 把元数据查询写进自己的脚本示例在 examples/python-sdk/【免费下载链接】OpenMetadataThe Open Context Layer for Data and AI , OpenMetadata is the open platform for building trusted data context and business semantics for humans, AI assistants, and agents.项目地址: https://gitcode.com/GitHub_Trending/op/OpenMetadata创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考