Cloud Weather Report (cwr) enables charm authors and maintainers to run
health checks and benchmarks on multiple clouds.
When the `cwr` starts executing, it deploys a bundle or charm on the clouds
chosen by the author. It runs all the tests associated with each charm
in each cloud it deployed to. It also runs benchmarks on those clouds allowing
charm authors to see how their charms are performing on different clouds.
## Installing prerequisites
Cloud Weather Report uses `make` and `unzip` during execution and `python-dev`
during installation. Make sure these tools are installed before installing the
`cwr`. If you are on Ubuntu, you can install them using `apt-get`.
[sudo] pip install cloud-weather-report
## Installing from a source
curl -L -o cwr.zip https://github.com/juju-solutions/cloud-weather-report/archive/master.zip
python setup.py install
After installing the Cloud Weather Report, you will have `cwr` command
installed on your machine. It is assumes that the controller is already bootstrapped
before running `cwr`. You can simply run `cwr` by specifying one or more
controllers and the path to the test plan.
cwr controller [controller ...] test-plan.yaml
For example if you already have bootstrapped `aws` and `gce` controllers:
cwr aws gce test-plan.yaml
Note: `aws` and `gce` are the names of your Juju 1.25 environment (found in your environments.yaml) or the name of your Juju 2.0 controller (found in `juju list-controllers`). If you had named your environment or controller for AWS soemthing like `aws-west1` the CWR command would look like:
cwr aws-west1 test-plan.yaml
Once `cwr` starts running, it deploys the bundle, runs the tests and benchmarks that
are defined in the test plan. An example of the test plan is included in the
## Running bundles
The following is example of a test plan to run the `apache-analytics-sql` bundle. It
deploys `apache-analytics-sql` and runs `terasort` benchmarks.
The following example deploys the `mongodb` charm and runs the `perf` benchmark.
The `runtime: 60` is a parameter passed to `perf`.
## Result outputs
Once the run is completed, the `cwr` generates a HTML file containing the test
and benchmark results. The path to the HTML file will be displayed and will also
be opened in a web browser.
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.