a jobsystem on AWS ECS, AWS Batch or AWS EMR managing dependencies and scheduling
Switch branches/tags
Nothing to show
Clone or download
Kevin O'Riordan
Latest commit 5defd8c Oct 3, 2018


Build Status Coverage Status


What is Sundial?

Sundial is a batch job scheduler for running Dockerized batch jobs on either Amazon ECS or recently, AWS Batch and AWS EMR (Elastic MapReduce)

Think of Sundial as an alternative to Chronos that uses Amazon ECS instead of Mesos and has some nice extra features.



  • Supports dependency graph of tasks within a process.
  • Live viewer for viewing logs streamed to Cloudwatch from job.
  • Job logs and Docker logs collected and uploaded to S3 at end of run for later browsing through Sundial.
  • Graphite metadata server so jobs can upload metrics.
  • Automatic retries for failed tasks within process flows
  • E-mail notifications at end of process runs
  • Supports running Dockerized tasks and shell commands

Getting started.

Set up Sundial service and ECS cluster using Cloudformation template. See DEPLOY.md for details.

Submit your jobs using REST API. See description of job JSON format under JOBS.md

The latest API is hosted here: https://app.apibuilder.io/gilt/svc-sundial/latest A prettier version of the API can be seen at: http://ui-www.apibuilder.io.s3-website-us-east-1.amazonaws.com/org/gilt/app/svc-sundial

Running Sundial Locally

For development purposes it's possible to run sundial locally via the script ./start-dev.sh.

Pre-requisites are:

  1. create a dev s3 bucket on aws that the local sundial can access
  2. create a .aws.env file at the root of the project with the required env variables (See example below)

The .aws.env file

The docker-compose.yml file used to run sundial locally, contains almost all the config required to run sundial on your laptop. Some env variables though, have to be setup on a case by case scenario. An example is the following:


Continuous Deployment

Once the cluster is created an easy way to deploy Sundial to your AWS account is via the Jenkins Pipeline plugin.

Create a Pipeline Project and paste the following in your Pipeline script.

Please note the two environmental variable required to customise the build:

pipeline {
    agent any
    environment {
    stages {
        stage('Code Checkout') {
            steps {
                git url: 'https://github.com/saksdirect/sundial.git'
        stage('Building companion container') {
            steps {
                dir('companion-container') {
                    sh './publish-companion.sh | grep ECS_COMPANION_TAG > ecs.env' 
        stage('Deployment') {
            steps {
                load 'companion-container/ecs.env'
                sh """
                    ECS_COMPANION_TAG=$ECS_COMPANION_TAG ./deploy.sh


With the introduction of AWS Batch, we've decided to deprecate the ECS executor. The new AWS Batch allows a better, simpler and cheaper way of running batch jobs on aws.