Ofelia调度器job-run无法传递命令参数至Docker入口脚本

问题重现 #

使用mcuadros/ofelia:latest作为Cron调度器，搭配自定义Scrapy批处理容器archiver：

• 容器的entrypoint.sh会先完成数据库检查、Alembic迁移，再通过exec "$@"执行传入的命令参数
• 手动执行docker compose run --rm archiver scrapy crawl index_works_only时，任务正常运行
• Ofelia触发定时任务时，容器能完成迁移，但触发$# -eq 0的参数检查逻辑，提示未提供命令；日志显示已调用scrapy crawl my_spider，但参数未被正确拆分

核心原因 #

Ofelia的job-run在传递命令时，若使用字符串形式配置命令，会将整串命令作为单个参数传给容器的ENTRYPOINT脚本，而非拆分为多个独立参数。例如scrapy crawl my_spider会被当作一个参数传入，导致脚本的$@仅包含一个元素，若脚本逻辑对参数数量有判断（或期望多参数格式），就会触发异常。

解决方案 #

方案1：修改Ofelia配置，用数组形式传递命令参数 #

在docker-compose.yml的Ofelia任务配置中，将命令拆分为数组形式，而非整串字符串。这样Ofelia会将每个数组元素作为独立参数传递给ENTRYPOINT脚本，和手动执行时的参数格式一致。

示例配置：

services:
  ofelia:
    image: mcuadros/ofelia:latest
    command: daemon --docker
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
    labels:
      ofelia.job-run.crawl-spider.schedule: "@hourly"
      ofelia.job-run.crawl-spider.image: "archiver"
      ofelia.job-run.crawl-spider.command: '["scrapy", "crawl", "my_spider"]'
      ofelia.job-run.crawl-spider.rm: "true"

方案2：修改ENTRYPOINT脚本，兼容单参数命令串 #

如果无法调整Ofelia配置，可修改entrypoint.sh，增加对单参数命令串的处理逻辑，将其拆分为多参数执行：

#!/bin/bash

# 原有逻辑：数据库检查、Alembic迁移
# ...（保留你的原有代码）

# 处理命令参数
if [ $# -eq 0 ]; then
  echo "No command provided, exiting."
  exit 1
elif [ $# -eq 1 ]; then
  # 单参数为命令串，用bash执行拆分
  exec bash -c "$1"
else
  # 多参数直接执行
  exec "$@"
fi

方案3：调整容器Dockerfile的CMD默认值 #

若需要固定执行某类命令，可在容器的Dockerfile中设置默认CMD，例如：

ENTRYPOINT ["./entrypoint.sh"]
CMD ["scrapy", "crawl", "default_spider"]

此时Ofelia任务可省略command配置，或仅传递修改后的爬虫名称参数。

验证方法 #

1. 调整配置后，重启Ofelia容器：docker compose restart ofelia
2. 手动触发任务（或等待定时触发），查看容器日志：docker logs <archiver-container-id>
3. 确认爬虫任务正常启动，无参数检查异常提示

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