Skip to main content

Command line client to the CloudLaunch API.

Project description

CloudLaunch CLI

.. image::

.. image::

.. image::

.. image::
:alt: Documentation Status

.. image::
:alt: Updates

Command line client to the CloudLaunch API.

* Free software: MIT license
* Documentation:


1. Create a virtual environment and activate it

python3 -m venv venv
source venv/bin/activate

2. Install ``cloudlaunch-cli`` with pip

pip install cloudlaunch-cli

3. The CloudLaunch CLI requires two config settings. First is the URL of
the API root:

cloudlaunch config set url

4. Second config setting is an auth token. To get an auth token, first
log into CloudLaunch, for example, by going to Then navigate to the
``/api/v1/auth/tokens`` API endpoint, for example,
Copy the token out of the JSON response and then run the following
(substituting your own token instead):

cloudlaunch config set token b38faadf2ef6d59ce46711ed73e99d6...

5. Now you should be able to list your deployments

cloudlaunch deployments list

6. You can create a deployment as well

cloudlaunch deployments create my-ubuntu-test ubuntu \
amazon-us-east-n-virginia --application-version 16.04

Installing for development

1. ``python3 -m venv venv``
2. ``source venv/bin/activate``
3. ``pip install -r requirements_dev.txt``

Now you can run ``cloudlaunch``.

Release process


bumpversion patch
# or `bumpversion minor` or `bumpversion major`
git push
git push --tags
make release


This package was created with Cookiecutter_ and the `audreyr/cookiecutter-pypackage`_ project template.

.. _Cookiecutter:
.. _`audreyr/cookiecutter-pypackage`:


0.2.0 - 2018-11-14 - (sha 331e58f756145316334049100f582dd4316055fb)

* Major refactoring.
* Backward compatibility with Python 2.
* Integration tests with CloudLaunch.

0.1.0 - 2018-01-09

* First release on PyPI.

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

cloudlaunch_cli-0.2.1.tar.gz (33.4 kB view hashes)

Uploaded source

Built Distribution

cloudlaunch_cli-0.2.1-py3-none-any.whl (13.5 kB view hashes)

Uploaded 3 6

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page