Skip to main content

Azure Container Service command line tools

Project description


Please note these scripts are intended to allow experimentation with Azure Container Service. They are not intended for production use.

A set of convenience scripts for creating and testing ACS clusters. These scripts can also be helpful in working out how to use the REST API interfaces for managing applicaitons on an ACS cluster.

# Usage

See the [documentation](

# Development

## Prerequisites

## Preparing

To install all libraries and development dependencies:

` sudo pip install -e . sudo pip install -e .[test] `

## General Use

You can use acs –help for basic help, or see the [documentation](

# Developing

## Adding a command

To add a top level command representing a new feature follow the these steps (in this example the new command is called Foo:

  • Add the command foo and its description to the “Commands” section of the docstring for acs/
  • Copy acs/commands/command.tmpl to acs/commands/ * Add the subcommands and options to the docstring of the file * Implement each command in a method using the same name as the command
  • Add import to acs/commands/
  • Copy tests/command/test_command.tmpl to test/command/ * Implement the tests
  • Run the tests with python test and iterate as necessary
  • Install the package with python install

## Adding a subcommand

Subcommands are applied to commands, to add a subcommand do the following:

  • Add the subcommand to the docstring of the relevant command class (e.g.
  • Add a method with the same name as the subcommand
  • Add a test
  • Run the tests with python test and iterate as necessary
  • Install the package with python install

## Testing

Run tests using [py.test:]( and [coverage](

` python test `

Note, by default this does not run the slow tests (like creating the cluster and installing features. You must therefore first have run the full suite of tests at least once. You can do this with:

` py.test --runslow `

## Releasing

Cut a release and publish to the [Python Package Index]( install install [twine]( and then run:

` python sdist bdist_wheel twine upload dist/* `

This will build both a surce tarball and a wheel build, which will run on all platforms.

### Updating Documentation

To build and pucblish the documentsation:

` cd docs make gh-pages cd .. `

Project details

Release history Release notifications

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
acs-0.1.0-py2.py3-none-any.whl (21.1 kB) Copy SHA256 hash SHA256 Wheel py2.py3 May 15, 2016

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page