This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

The canonical Python client and cli for the stackd.io API

Overview

This is a small set of tools for internal use of stackd.io. After cloning this repo, you should be able to quickly get up and running with your own stacks.

Advanced usage like creating custom blueprints or writing your own formulas is beyond the scope of this.

Installation

We recommend using virtualenv via virtualenvwrapper to install this in a virtualenv. If you consider yourself a knowledgeable Pythonista, feel free to install this however you’d like, but this document will assume that you are using virtualenvwrapper. See the full virtualenvwrapper docs for details, but in short you can install it on most systems like:

pip install virtualenvwrapper

Once you’ve got it, installing this tool goes something like:

mkvirtualenv stackdio-client

pip install stackdio

You’ll see a few things scrolling by, but should be set after this. To use this later, you’ll need to re-activate the virtualenv like:

workon stackdio-client

Whenever it’s activated, stackdio-cli should be on your path.

First Use

The first time that you fire up stackdio-cli, you’ll need to run the configure command. This will prompt you for your LDAP username and password, and store them securely in your OS keychain for later use. It will import some standard formula, and create a few commonly used blueprints.

$ stackdio-cli
None @ None
> configure
# YOU WILL BE WALKED THROUGH A SIMPLE SET OF QUESTIONS

Stack Operations

All of the following assume that you have run initial_setup successfully. To launch the cli, simply type:

$ stackdio-cli

You can run help at any point to see available commands. For details on a specific command you can run help COMMAND, e.g. help stacks. The rest of these commands assume you have the cli running.

Launching Stacks

Stacks are launched from blueprints. To launch the 3 node HBase stack that’s included with this you do:

> stacks launch cdh450-ipa-3 MYSTACKNAME

Note

To avoid DNS namespace collisions, the stack name needs to be unique. An easy way to ensure this is to include your name in the stack name.

Deleting Stacks

When you are done with a stack you can delete it. This is destructive and cannot be recovered from, so think carefully before deleting your stack!

> stacks delete STACK_NAME

Alternatively you can terminate a stack which will terminate all instances, but leave the stack definition in place.

Provisioning Stacks

Occassionally something will go wrong when launching your stack, e.g. network connections may flake out causing some package installations to fail. If this happens you can manually provision your stack, causing everything to be brought back up to date:

> stacks provision STACK_NAME

Stack Info

Once you have launched a stack, you can then monitor the status of it like:

> stacks history STACK_NAME

This displays the top level information for a stack. You can supply additional arguments to pull back additional info about a stack. For example, to get a list of FQDNs (aka hostnames) for a stack:

> stacks hostnames STACK_NAME

There are various logs available that you can access with the stacks logs command.

What’s Next?

For anything not covered by this tool, you’ll need to use the stackdio-server web UI or API directly. For more information on that, check out http://docs.stackd.io.

Release History

Release History

0.8.0b1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.7.3

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.7.2

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.7.1

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.7.0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
stackdio-0.7.3-py2.py3-none-any.whl (36.3 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Jun 1, 2016
stackdio-0.7.3.tar.gz (22.2 kB) Copy SHA256 Checksum SHA256 Source Jun 1, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development 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