Create a single digital ocean droplet and provision it to run the docker engine over a simple cli
Project description
docker-droplet
Create a single digital ocean droplet and provision it to run the docker engine over a simple cli.
Status
Source | Shields |
---|---|
Project | |
Publishers | |
Downloads | |
Raised |
Motivation
Creating a single droplet provisioned to use docker should be quick. Ansible and Terraform are the appropriate tools but may take long to configure for a single droplet. This package provides a simple cli to streamline the use of these tools.
Installing
Install from pypi:
pip install docker-droplet
Running the app
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
Where the terraform configuration path defaults to "./config.tf"
The droplet's name, ssh key path and digitalocean token can be given as environmnet 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 included
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
Running tests
Under development
What is being tested
Under development
Docs
Under development
Contributing
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests.
Versioning
We use SemVer for versioning. For the versions available, see the tags on this repository.
Author
- Joel Lefkowitz - Initial work - JoelLefkowitz
See also the list of contributors who participated in this project.
License
This project is licensed under the MIT License - see the LICENSE.md file for details
Acknowledgments
None
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for docker_droplet-0.2.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8747834568770a6c1a59eccc95c044fdac576af4022eac4607c6364cbc185eaa |
|
MD5 | 2d2398683d860d60079a7c153ae6ac77 |
|
BLAKE2b-256 | e78d1359bede38c455497e439677725b2cbb8de2ed24215df01606cf82c858ae |