Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

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 --env-file=.env <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.

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

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

File Name & Hash SHA256 Hash Help Version File Type Upload Date
(8.9 kB) Copy SHA256 Hash SHA256
py2.py3 Wheel Jul 19, 2017
(8.0 kB) Copy SHA256 Hash SHA256
Source Jul 19, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting