Skip to main content

Tools for a BeeKeeper worker drone to report status back to the hive.

Project description


Prepare and upload Docker images for use by BeeKeeper.


Create a directory, and in that directory place a Dockerfile, along with any files required by the Dockerfile.

Optionally, you can also put an ecs.json file in the directory. The ecs.json file should contains a JSON definition of any ECR container settings that you want task to have. For example, if you wanted to specify a particular memory and CPU usage profile for the task, you would specify:

    memory: 50,
    cpu: 8192

These settings will be used as overrides for the default container settings used by BeeKeeper.

Then, create a file named .env in your current working directory that contains the following content:

AWS_REGION=<Your AWS region (e.g., us-west-2)>
AWS_ACCESS_KEY_ID=<Your AWS access key>
AWS_SECRET_ACCESS_KEY=<Your AWS secret access key>

Then, run:

$ waggle <path to docker image directory>

This will:

  • Log into AWS ECR
  • Find (or create) an AWS ECR repository for your image
  • Build the Docker image
  • Tag the image for publication to AWS ECR
  • Push the image to AWS ECR
  • Register (or update) an AWS ECS task that uses the image.

If your Docker image is contained in a directory called myimage, your BeeKeeper configuration will now be able to reference a task image of myimage.


Before you waggle your task, you’re probably going to want to test it.

  • To build an image locally:

    $ cd <directory with a Dockerfile in it>
    $ docker build -t <namespace>/<image> .
  • To run an image locally:

    $ docker run <namespace>/<image>

    If your docker image requires environment variables (all the Beekeeper ones do), you may find it easier to put all those variables in a file (e.g., .env), and run:

    $ docker run --env-file=.env <namespace>/<image>

    To temporarily define a variable for the duration of the test:

    $ VARIABLE=value docker run -e VARIABLE <namespace>/<image>

    To mount a local directory as the source code directory:

    $ docker run -v `pwd`:/app/src <namespace>/<image>
  • To start the container with an interactive prompt:

    $ docker run -it –env-file=.env <namespace>/<image> /bin/bash

  • To clean up afterwards, run:

    $ docker ps -a

    to list all the containers that have been executed, and:

    $ docker rm $(docker ps -aq)

    to remove all the stale containers.


Waggle is part of the BeeWare suite. You can talk to the community through:

We foster a welcoming and respectful community as described in our BeeWare Community Code of Conduct.


If you experience problems with Waggle, log them on GitHub. If you want to contribute code, please fork the code and submit a pull request.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
waggle-0.2.4-py2.py3-none-any.whl (8.9 kB) Copy SHA256 hash SHA256 Wheel py2.py3
waggle-0.2.4.tar.gz (8.0 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page