Update rally job files

Rename rally-scenarios/ to rally-jobs/ Because it makes much more sense
to call directory with jobs files rally-jobs

Add pretty README files, that describes how to write plugins and use
extra dir

Update main README.rst file that describes what the hell is this=)

Add cinder-fakevirt.yaml that will be required after this infra patch
is merged: https://review.openstack.org/#/c/135137/

Change-Id: Ic7e5e8a99fc1385638fb187a04475a42eedcfeb2

diff --git a/rally-jobs/README.rst b/rally-jobs/README.rst
new file mode 100644 (file)
index 0000000..16306a4
--- /dev/null
+++ b/rally-jobs/README.rst
@@ -0,0 +1,34 @@
+Rally job related files
+=======================
+
+This directory contains rally tasks and plugins that are run by OpenStack CI.
+
+Structure
+---------
+
+* cinder.yaml is a task that will be run in gates against OpenStack deployed
+  by DevStack.
+
+* cinder-fake.yaml is a task that will be run in gates against OpenStack
+  deployed by DevStack with fake cinder driver.
+
+* plugins - directory where you can add rally plugins. Almost everything in
+  Rally is plugin. Benchmark context, Benchmark scenario, SLA checks, Generic
+  cleanup resources, ....
+
+* extra - all files from this directory will be copy pasted to gates, so you
+  are able to use absolute path in rally tasks.
+  Files will be in ~/.rally/extra/*
+
+
+Useful links
+------------
+
+* More about rally: https://rally.readthedocs.org/en/latest/
+
+* How to add rally-gates: https://rally.readthedocs.org/en/latest/rally_gatejob.html
+
+* About plugins:  https://rally.readthedocs.org/en/latest/plugins.html
+
+* Plugin samples: https://github.com/stackforge/rally/tree/master/doc/samples/plugins
+

diff --git a/rally-jobs/cinder-fake.yaml b/rally-jobs/cinder-fake.yaml
new file mode 100644 (file)
index 0000000..c42cc75
--- /dev/null
+++ b/rally-jobs/cinder-fake.yaml
@@ -0,0 +1,14 @@
+---
+  CinderVolumes.create_and_list_volume:
+    -
+      args:
+        size: 1
+        detailed: True
+      runner:
+        type: "constant"
+        times: 200
+        concurrency: 20
+      context:
+        users:
+          tenants: 1
+          users_per_tenant: 1

diff --git a/rally-scenarios/cinder.yaml b/rally-jobs/cinder.yaml
similarity index 100%
rename from rally-scenarios/cinder.yaml
rename to rally-jobs/cinder.yaml

diff --git a/rally-jobs/extra/README.rst b/rally-jobs/extra/README.rst
new file mode 100644 (file)
index 0000000..836f35a
--- /dev/null
+++ b/rally-jobs/extra/README.rst
@@ -0,0 +1,5 @@
+Extra files
+===========
+
+All files from this directory will be copy pasted to gates, so you are able to
+use absolute path in rally tasks. Files will be in ~/.rally/extra/*

diff --git a/rally-jobs/plugins/README.rst b/rally-jobs/plugins/README.rst
new file mode 100644 (file)
index 0000000..33bec0d
--- /dev/null
+++ b/rally-jobs/plugins/README.rst
@@ -0,0 +1,9 @@
+Rally plugins
+=============
+
+All *.py modules from this directory will be auto-loaded by Rally and all
+plugins will be discoverable. There is no need of any extra configuration
+and there is no difference between writing them here and in rally code base.
+
+Note that it is better to push all interesting and useful benchmarks to Rally
+code base, this simplifies administration for Operators.

diff --git a/rally-jobs/plugins/__init__.py b/rally-jobs/plugins/__init__.py
new file mode 100644 (file)
index 0000000..e69de29

diff --git a/rally-scenarios/README.rst b/rally-scenarios/README.rst
deleted file mode 100644 (file)
index 2c4a484..0000000
--- a/rally-scenarios/README.rst
+++ /dev/null
@@ -1,5 +0,0 @@
-This directory contains rally benchmark scenarios to be run by OpenStack CI.
-
-
-* more about rally: https://wiki.openstack.org/wiki/Rally
-* how to add rally-gates: https://wiki.openstack.org/wiki/Rally/RallyGates