Skip to content
This repository has been archived by the owner on Dec 1, 2022. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.


Blox: Open Source schedulers for Amazon ECS

Build Status

Blox provides open source schedulers optimized for running applications on Amazon ECS. Developers now have greater control over how their applications are deployed across clusters of resources, run and scale in production, and can take advantage of powerful placement capabilities of Amazon ECS. Blox is being delivered as a managed service via the Amazon ECS Console, API and CLIs. Blox v1.0 provides daemon scheduling for Amazon ECS. We will continue to add additional schedulers as part of this project. Blox schedulers are built using AWS primitives, and the Blox designs and code are open source. If you are interested in learning more or collaborating on the designs, please read the design. If you are currently using Blox v0.3, please read the FAQ.

Project structure

For an overview of the components of Blox, run:

./gradlew projects


To run the full unit test suite, run:

./gradlew check

This will run the same tests that we run in the Travis CI build.


First, take a look at what Blox will put in your personal stack by running the showStackConfig task:

$ ./gradlew showStackConfig

> Task :showStackConfig
Blox deployment stack configuration:

  Default resource name         ( blox-<username>-alpha-us-west-2 (default)
  API Gateway stage            (blox.stage): alpha (default)
  Stack prefix                (blox.prefix): <username>-alpha (default)
  AWS Region                  (blox.region): us-west-2 (default)
  AWS Credential Profile     (blox.profile): blox-<username>-alpha-us-west-2 (default)
  Cloudformation stack name (blox.cfnStack): blox-<username>-alpha-us-west-2 (default)
  Deployment S3 bucket name (blox.s3Bucket): blox-<username>-alpha-us-west-2 (default)

To customize these values, modify ~/.gradle/ to override the property listed.

AWS CLI configuration for profile blox-<username>-alpha-us-west-2:

The config profile (blox-<username>-alpha-us-west-2) could not be found

If you wish to customize any of these values, you can do so by overriding the property in parentheses using any of the supported ways to override Gradle properties. The easiest way is to override it for your user in ~/.gradle/


Next, in order to deploy your personal stack:

  • install the official AWS CLI

  • create an IAM user with the following permissions:


    These permissions are pretty broad, so we recommend you use a separate, test account.

  • configure the AWS Credential Profile shown in the showStackOutput task with the AWS credentials for the user you created above:

    aws configure --profile blox-<username>-alpha-us-west-2 set region us-west-2
    aws configure --profile blox-<username>-alpha-us-west-2
  • create an S3 bucket where all resources (code, cloudformation templates, etc) to be deployed will be stored:

    ./gradlew createBucket
  • deploy the Blox stack:

    ./gradlew deploy

End to end testing

Once you have a stack deployed, you can test it with:

./gradlew testEndToEnd



All projects under Blox are released under Apache 2.0 and contributions are accepted under individual Apache Contributor Agreements.