Cloudbreak Shell

The goal with the CLI was to provide an interactive command line tool which supports:

Install and start Cloudbreak shell

You have a few options to give it a try:

Starting cloudbreak shell using cloudbreak deployer

Start the shell with cbd util cloudbreak-shell. This will launch the Cloudbreak shell inside a Docker container and you are ready to start using it.

Starting Cloudbreak shell with our prepared docker image

You can find the docker image and its documentation here.

Build from source

If want to use the code or extend it with new commands follow the steps below. You will need: - jdk 1.7

git clone
cd cloudbreak/shell
../gradlew clean build

Note In case you use the hosted version of Cloudbreak you should use the to get the right version of the CLI.

Start Cloudbreak-shell from the built source

  java -jar cloudbreak-shell-0.5-SNAPSHOT.jar                  : Starts Cloudbreak Shell in interactive mode.
  java -jar cloudbreak-shell-0.5-SNAPSHOT.jar --cmdfile=<FILE> : Cloudbreak executes commands read from the file.

  --cloudbreak.address=<http[s]://HOSTNAME:PORT>  Address of the Cloudbreak Server [default:].
  --identity.address=<http[s]://HOSTNAME:PORT>    Address of the SequenceIQ identity server [default:].
  --sequenceiq.user=<USER>                        Username of the SequenceIQ user [default:].
  --sequenceiq.password=<PASSWORD>                Password of the SequenceIQ user [default: password].

  You should specify at least your username and password.

Once you are connected you can start to create a cluster. If you are lost and need guidance through the process you can use hint. You can always use TAB for completion.

Note All commands are context aware - they are available only when it makes sense - this way you are never confused and guided by the system on the right path.

Provider specific documentations

or you can find a more detailed documentation about Cloudbreak-shell in its Github repositiry.

Edit on GitHub