在 Docker 中使用 Laravel schedule

在 Docker 中部署 Laravel 应用，难免会用到 Laravel 本身的任务调度系统(Schedule)，而 Schedule 需要用到 cron，在 Docker 中使用 cron，有以下三种方案：

• 使用独立的 cron 容器。❎ 如果有多个不同的容器应用需要依赖 cron 时，那么这是一种很完美的解决方案，但是我们只用到 Laravel 的任务调度，因此独立的 cron 容器显得多余，所以不能采用此方案。

• 直接使用宿主机的 cron。❎ 如果直接使用宿主机的 cron，那么「定时任务」这个功能就不属于容器的一部分了。以后在应用迁移与快速部署时，cron 需要单独配置，这违背了我们使用 Docker 的初衷，我们的初衷是希望用docker-compose up这一个命令就能快速构建出一个线上应用。并且，在宿主机上使用 cron，使用 Laravel schedule 任务调度时不能和 MySQL 或 Redis 进行通信，所以这个方案需要被否决。

• 在 PHP 容器中设置 cron。✅ 这才是最佳解决方案。Laravel 只需要在 cron 中配置一个Laravel Task Scheduler，使用此容器中的 PHP 执行文件可以直接执行 Laravel 的任务调度。

在 PHP 容器中使用 cron

我们直接使用基于 Ubuntu 的 php:7.1.11-fpm的 Docker Hub 的官方镜像，然后需要在Dockerfile文件中安装 cron.

RUN apt-get install cron -y

然后在Dockerfile文件所在目录下创建crontab文件，内容为：

* * * * * /usr/local/bin/php /your_laravel_app_path/artisan schedule:run >> /dev/null 2>&1

其中your_laravel_app_path为 Laravel 应用在容器中的实际路径。

其实上面这一步我是踩了坑的，之前我一直按照官方手册的以下写法来配置的：

* * * * * php /your_laravel_app_path/artisan schedule:run >> /dev/null 2>&1

打了日志之后我才发现，容器内无法直接找到 PHP 的执行文件，所以要写全 PHP 执行文件的完整路径，例如/usr/local/bin/php。当然，PHP 执行文件的路径可能会有所不同，如果不清楚，需要到 PHP 容器中查看一下。

然后继续写Dockerfile，将crontab文件映射到容器目录中，赋予其读写权限：

COPY ./crontab /var/spool/cron/crontabs/root
RUN chmod 0644 /var/spool/cron/crontabs/root
RUN crontab /var/spool/cron/crontabs/root

至于第三行的命令，这么做是为了使 crontab 配置生效，我参考了 这篇文章，具体原因没有深究。

注意：如果容器文件系统是 Debian，cron 的配置路径是有所不同的，本文不赘述，这里只讨论 Ubuntu 的镜像

运行 cron

一开始我直接在Dockerfile中写了CMD ["cron"]，发现 PHP-FPM 服务不启动了，是因为Dockerfile中只会执行一次 CMD 命令，多条 CMD 只执行最后一条，CMD ["cron"]把CMD ["php-fpm"]覆盖了。

因此我们需要一个 bash 脚本来启动 cron，在Dockerfile文件所在目录下创建entrypoint.sh，文件内容为：

#!/bin/bash

set -e

cron

exec "$@"

然后使用ENTRYPOINT命令添加到Dockerfile就好。
完整的Dockerfile文件应该是这个样子：

######
# See: https://hub.docker.com/_/php/
######

FROM php:7.1.11-fpm

RUN apt-get update && apt-get install -y cron
RUN rm -rf /var/lib/apt/lists

COPY ./crontab /var/spool/cron/crontabs/root
RUN chmod 0644 /var/spool/cron/crontabs/root
RUN crontab /var/spool/cron/crontabs/root

COPY ./entrypoint.sh /usr/local/bin/
ENTRYPOINT ["entrypoint.sh"]

CMD ["php-fpm"]

重点结论

1. 要在容器中使用 cron，需要在Dockerfile中安装 cron，并将 crontab 配置信息映射到容器内。
2. crontab 配置 Laravel-scheduler 时，要填写 PHP 的执行文件路径，不然可能无法正确执行。
3. 要写单独的脚本启动 cron，否则会覆盖掉 PHP 容器的 PHP-FPM 服务。

本作品采用《CC 协议》，转载必须注明作者和本文链接