Metarank一分钟部署教程执行失败：data参数验证错误

核心问题分析 #

错误日志明确提示Validation failure for 'data' option parameters: events.jsonl.gz，本质是Metarank在容器内无法找到指定的events.jsonl.gz文件，或文件路径配置不符合要求。

具体排查与修复步骤 #

1. 修正文件路径配置 #

Docker运行时，相对路径可能受容器默认工作目录影响，导致Metarank无法定位文件。建议直接使用容器内的绝对路径：

docker run -i -t -p 8080:8080 -v ./metarank:/opt/metarank metarank/metarank:latest standalone --config /opt/metarank/config.yml --data /opt/metarank/events.jsonl.gz

2. 验证挂载与文件存在性 #

若修改路径后仍报错，先进入容器确认文件是否成功挂载：

# 启动临时容器进入终端
docker run -it --rm -v ./metarank:/opt/metarank metarank/metarank:latest bash
# 检查目标目录下的文件
ls -l /opt/metarank/

如果未看到events.jsonl.gz和config.yml，说明本地挂载路径错误，需将./metarank替换为实际存放文件的本地目录。

3. 检查文件读取权限 #

确保本地文件权限允许容器读取：

# 本地执行，添加可读权限
chmod +r ./metarank/events.jsonl.gz ./metarank/config.yml

内容的提问来源于stack exchange，提问作者Mo Ferry