Setting up a cron job within a docker container might not sound new to many of us. But depending upon the base image that we use to build the docker image we might end up struggling with different issues.
In this blog, I will walk you through the different challenges that I dealt with while setting up a cron using bash in a docker container.
Recently I came across a scenario where the requirement was to set up a cron job within a docker container. While surfing for the relevant content across the internet, all I could find was to run one liner echo commands within docker using the command CMD cron -f .
But what if Docker container runs with a command? The default command will be ignored, and the cron will not start in that case.
Also, what if you have other jobs as well to start once on the docker startup? And some other job that you would want to run periodically in the same container? Moreover, how about using System’s environment variable in the cron job?
Following are my findings to all the questions above.
Setup a cron in parallel to a one-time job.
Create a script file, say run.sh, with the job that is supposed to run periodically.
Save and exit.
Use Entrypoint instead of CMD
If you have multiple jobs to kick in during docker containerization, use the entrypoint file to run them all.
Entrypoint file is a script file that comes into action when a docker run command is issued. So, all the steps that we want to run can be put in this script file.
For instance, we have 2 jobs to run:
Run once job: echo “Docker container has been started”
Run periodic job: run.sh
Let’s understand the crontab that has been setup in the file
“* * * * *” : Cron schedule; the job must run every minute. You can update the schedule based on your requirement.
/run.sh: path to the script file which is to be run periodically
/var/log/cron.log: The filename to save the output of the scheduled cron job.
2>&1: The error logs(if any) also will be redirected to the same output file used above.
Note: Do not forget to add an extra new line, as it makes it a valid cron.
Scheduler.txt: the complete cron setup will be redirected to a file.
Using System/User specific environment variables in cron
My actual cron job was expecting most of the arguments as the environment variables passed to the docker run command. But, with bash, I was not able to use any of the environment variables that belongs to the system or the docker container.
Then, this came up as a walkaround to this problem:
- Add the following line in the entrypoint.sh
- Update the cron setup and specify-
At last, your entrypoint.sh should look like
Last but not the least: Create a Dockerfile
That’s it. Build and Run the Docker image!
You can get the complete code on github https://github.com/nehabhardwaj01/docker-cron. Follow the README.md to test the docker image.
Feel free to share your queries or thoughts in the comments section.