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

Stowaway gives simple docker image deployment through vagrant provisioned machines.

Project Description

Stowaway gives simple docker image deployment through vagrant provisioned machines.

Uses vagrant-aws to deploy to AWS.

Application Management

In addition to deploying docker images stowaway provides services for managing applications.

Services used for application management:

  • Redis for routing state
  • Hipache for load balancing http services

Requirements

  • fabric
  • python-vagrant
  • micromodels-ng
  • microcollections

Commands

Install:

pip install stowaway

Create a new cluster:

#create a directory to hold your cluster's state and config
mkdir mydockercluster && cd mydockercluster

#installs a local docker registry
stowaway install_local_registry

#will ask configuration questions, be sure to configure your security group
stowaway embark

#allows for multi-node web app scaling
stowaway install_app_mgmt

Adding and managing apps in the cluster:

#in some directory: docker build -t myapp .
#upload the image and register the app
stowaway upload_image:<app image>
stowaway add_app:<name>,<app image>
#configure app environ
stowaway app_config:<name>,KEY1=VALUE1,KEY2=VALUE2
stowaway app_remove_config:<name>,KEY1,KEY2
#num=-1 to descale
stowaway app_scale:<name>[,<num=1>,<process>]
stowaway app_add_domain:<name>,<domain>

Shell into your app:

stowaway appshell:<name>

More Commands

Upload and run a docker image:

stowaway upload_image:myapplication
stowaway run_image:myapplication

See what makes up your cluster:

stowaway list_instances
stowaway list_nodes

Install and configure application management:

#for cluster creation
stowaway install_app_mgmt

#or do it manually:
stowaway build_base
stowaway upload_image:sys/redis
stowaway upload_image:sys/hipache
stowaway run_image:sys/redis,PASSWORD=r4nd0m
stowaway run_image:sys/hipache,ports=80:80,REDIS_URI=redis://:r4nd0m@ip/0
stowaway register_balancer:<hipache path>,<redis uri>[,<name>]
Release History

Release History

This version
History Node

0.0.5

History Node

0.0.4

History Node

0.0.3

History Node

0.0.2

History Node

0.0.1

Download Files

Download Files

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

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
stowaway-0.0.5.tar.gz (21.1 kB) Copy SHA256 Checksum SHA256 Source Nov 13, 2013

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