Docker droplet

Create a single digital ocean droplet and provision it to run docker.

Installing

pip install docker-droplet

Documentation

Documentation and more detailed examples are hosted on Github Pages.

Usage

Usage:
   docker-droplet up [options]
   docker-droplet down [options]

To create a terraform configuration and run an ansible playbook to install docker:

docker-droplet up --droplet-name steve --ssh-key /home/.ssh/steve.pub --token 12345 --config-path /Workspace/config.tf

The terraform configuration path defaults to "./config.tf"

The droplet's name, ssh key path and digitalocean token will be synchronized with environment variables:

export TF_VAR_DOCKER_DROPLET_DROPLET_NAME=steve
export TF_VAR_DOCKER_DROPLET_SSH_KEY=/home/.ssh/steve.pub
export TF_VAR_DOCKER_DROPLET_TOKEN=12345
docker-droplet up

A domain and digital ocean project title can also be specified

docker-droplet up --domain example.com --project example

To remove the structure simply take it down:

docker-droplet down --token 12345 --config-path /Workspace/config.tf

Tooling

Dependencies

To install dependencies:

yarn install
pip install .[all]

Tests

To run tests:

thx test

Documentation

To generate the documentation locally:

thx docs

Linters

To run linters:

thx lint

Formatters

To run formatters:

thx format

Contributing

Please read this repository's Code of Conduct which outlines our collaboration standards and the Changelog for details on breaking changes that have been made.

This repository adheres to semantic versioning standards. For more information on semantic versioning visit SemVer.

Bump2version is used to version and tag changes. For example:

bump2version patch

Contributors

• Joel Lefkowitz - Initial work

Remarks

Lots of love to the open source community!