Skip to main content

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

Project description

http://pybee.org/project/projects/tools/waggle/waggle.png

Waggle

https://img.shields.io/pypi/pyversions/waggle.svg https://img.shields.io/pypi/v/waggle.svg https://img.shields.io/pypi/status/waggle.svg https://img.shields.io/pypi/l/waggle.svg https://beekeeper.herokuapp.com/projects/pybee/waggle/shield https://badges.gitter.im/pybee/general.svg

Prepare and upload Docker images for use by BeeKeeper.

Quickstart

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.

Testing

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.

Community

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.

Contributing

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.

Files for waggle, version 0.2.4
Filename, size File type Python version Upload date Hashes
Filename, size waggle-0.2.4-py2.py3-none-any.whl (8.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size waggle-0.2.4.tar.gz (8.0 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page