Running periodic background tasks in Golang

Mohit Khare
Nov 21, 2019 · 3 min read

The Problem —

I had to download some files in the background every day on my Golang server. So, let’s break this problem into two parts —

  1. Run tasks periodically.
  2. Run tasks in the background.

Run tasks periodically —

If you are aware of background tasks, you must have come across/used Linux Cronjob sometime.

But wait, What is Cron?

Cron allows Linux and Unix users to run commands or scripts at a given date and time. You can schedule scripts to be executed periodically. Easy! No? Just a simple Linux command.

Coming back on how do we do this in Go?

After searching for a while, I came across this package gocron. Well, this is what I was looking for. Let’s see how this works!

package main

import (

func myTask() {
fmt.Println("This task will run periodically")
func executeCronJob() {
<- gocron.Start()
func main() {
go executeCronJob()
SomeAPICallHandler() // handler which accepts requests and responds

Okay, this is as simple as it looks. I created a myTask() function which will do some task. Then in my executeCronJob(), I start the cron job and set it for every second.

You can also set it for every minute, hour, day, week, etc.

gocron.Every(1).Minute().Do(myTask) // Every Minute
gocron.Every(2).Hours().Do(myTask) // Every 2 Hours
gocron.Every(3).Days().Do(myTask) // Every 3 Days
gocron.Every(4).Weeks().Do(myTask) // Every 4 Weeks

You get the gist, check out the documentation of this awesome package to explore this more and use it as you want.

Run tasks in the background -

Coming to the only line of our main, we see —

go executeCronJob()

Okay, you must be asking is it this simple to run a task in the background?

The answer is YES.
Basically the executeCronJob() function will run in the background in a goroutine.

A goroutine is a lightweight thread of execution. So, Goroutines are functions that run concurrently with other functions or methods.

Few links on understanding concurrency and goroutines which I found useful and learned from:

Catch in above code

So, If you are just executing go executeCronJob() in your main. Then, your background tasks won’t run since your main has exited and the program has stopped. Either you need to have a server like in my case which runs continuously thus program doesn’t exit or you need to put your function to sleep so that you can verify your background task is actually running.

Add this code to see your background task in action —

time.Sleep(500 * time.Millisecond)

Yay! Now it worked.

Feel free to improve the article. I am learning too 😃

Time to Go 🚀

Do follow if interested in more technology-oriented stuff. Hope you learned something new.

Keep exploring, keep learning!

Mohit Khare

Written by

Product Engineer @ gojek |

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade