From 76c015df85b01853b8f597564d34ce06e61f6024 Mon Sep 17 00:00:00 2001 From: Boris Pavlovic Date: Tue, 18 Nov 2014 03:50:54 +0400 Subject: [PATCH] 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 --- rally-jobs/README.rst | 34 +++++++++++++++++++++ rally-jobs/cinder-fake.yaml | 14 +++++++++ {rally-scenarios => rally-jobs}/cinder.yaml | 0 rally-jobs/extra/README.rst | 5 +++ rally-jobs/plugins/README.rst | 9 ++++++ rally-jobs/plugins/__init__.py | 0 rally-scenarios/README.rst | 5 --- 7 files changed, 62 insertions(+), 5 deletions(-) create mode 100644 rally-jobs/README.rst create mode 100644 rally-jobs/cinder-fake.yaml rename {rally-scenarios => rally-jobs}/cinder.yaml (100%) create mode 100644 rally-jobs/extra/README.rst create mode 100644 rally-jobs/plugins/README.rst create mode 100644 rally-jobs/plugins/__init__.py delete mode 100644 rally-scenarios/README.rst diff --git a/rally-jobs/README.rst b/rally-jobs/README.rst new file mode 100644 index 000000000..16306a4f8 --- /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 index 000000000..c42cc753e --- /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 index 000000000..836f35a02 --- /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 index 000000000..33bec0d25 --- /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 index 000000000..e69de29bb diff --git a/rally-scenarios/README.rst b/rally-scenarios/README.rst deleted file mode 100644 index 2c4a4848a..000000000 --- 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 -- 2.45.2