Skip to content

Commit

Permalink
Merge pull request #109 from jrbalderrama/master
Browse files Browse the repository at this point in the history
Update readme + add manifest for ansible files
  • Loading branch information
msimonin authored Apr 9, 2018
2 parents 9204476 + f856066 commit 7f0b544
Show file tree
Hide file tree
Showing 4 changed files with 21 additions and 14 deletions.
File renamed without changes.
4 changes: 4 additions & 0 deletions MANIFEST.in
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
# maybe there is a better way to do it:
# https://stackoverflow.com/questions/1612733

recursive-include orchestrator/ansible *
26 changes: 12 additions & 14 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,10 +44,8 @@ cd ombt-orchestrator
* Install the dependencies

```
virtualenv venv
source venv/bin/activate
pip install -U pip
pip install -r requirements.txt
pip install -e .
```

> On Grid'5000 you can launch this command from any frontend.
Expand All @@ -59,8 +57,8 @@ The default configurations are currently defined in the `conf.yaml` file.
## Command line interface

```
> cli.py
Usage: cli.py [OPTIONS] COMMAND [ARGS]...
> oo
Usage: oo [OPTIONS] COMMAND [ARGS]...
Options:
--help Show this message and exit.
Expand All @@ -83,14 +81,14 @@ Commands:
## Workflow to run a test case


* Deploying and launching the benchmark.
* Deploying and launching the benchmark (default driver `broker` is defined in the configuration file)

```
# default confs.yaml on $PWD will be read
> cli.py deploy --driver=rabbitmq vagrant
> oo deploy --driver=broker vagrant
# Launch the one benchmark
> cli.py test_case_1 --nbr_clients 10 --nbr_servers 2
> oo test_case_1 --nbr_clients 10 --nbr_servers 2
```

> Adapt to the relevant provider (e.g `g5k`)
Expand All @@ -102,7 +100,7 @@ Grafana is available on the port 3000 of the control node (check the inventory f
* Backuping the environment

```
> cli.py backup
> oo backup
```

> The files retrieved by this action are located in `current/backup` dir by default.
Expand All @@ -111,11 +109,11 @@ Grafana is available on the port 3000 of the control node (check the inventory f

```
# Preparing the next run by cleaning the environment
> cli.py destroy
> cli.py deploy --driver=rabbitmq vagrant
> oo destroy
> oo deploy vagrant
# Next run
> cli.py test_case_1 --nbr_clients 20 --nbr_servers 2
> oo test_case_1 --nbr_clients 20 --nbr_servers 2
```

> It's possible to force an experimentation dir with `--env mydir`
Expand All @@ -130,7 +128,7 @@ Grafana is available on the port 3000 of the control node (check the inventory f
to run the first test case enabled on the framework run:

``` shell
> cli.py campaign --provider g5k test_case_1
> oo campaign --provider g5k test_case_1
```

* Alternatively a campaign can be executed in a _incremental_ mode in which deployments are
Expand All @@ -150,7 +148,7 @@ Grafana is available on the port 3000 of the control node (check the inventory f
instead of the default and execute:

``` shell
> cli.py campaign --incremental --provider g5k test_case_1
> oo campaign --incremental --provider g5k test_case_1
```

## Misc.
Expand Down
5 changes: 5 additions & 0 deletions setup.cfg
Original file line number Diff line number Diff line change
Expand Up @@ -4,10 +4,12 @@ version = 1.0.0
description = Oslo messaging benchmarking orchestrator
keywords = benchmark, oslo messaging, RPC
license = GPL-3.0
license_file = LICENSE.txt
url = https://github.com/msimonin/ombt-orchestrator/
author = Matthieu Simonin
author_email = matthieu.simonin@inria.fr
long_description = file: README.md
long_description_content_type = text/markdown
project_urls =
Bug Reports = https://github.com/msimonin/ombt-orchestrator/issues
Source = https://github.com/msimonin/ombt-orchestrator/
Expand Down Expand Up @@ -41,3 +43,6 @@ exclude =
[options.entry_points]
console_scripts =
oo = orchestrator.cli:cli

[bdist_wheel]
python-tag = py27

0 comments on commit 7f0b544

Please sign in to comment.