initial commit
* Downstream tempest with set of downstream plugins
* Align to upstream openstack upper-constraints.txt
* No-auto-magic things, by default.
* All configs should be **connected** as volumes to container.
* All preconfigured things, like:
-create networks
-create tempest conf
-add\patch plugin
should be done in separate steps.
* Open entrypoint - any customization allowed and could be passed:
- via cmdline for docker run
- via SWITCH env variables + new func in entrypoint
* If needed, any custom scripts could be added, but should be disable by default.
Change-Id: Iec219f3f23f06ee08f7761cf78f478ca0b0ca04f
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..91ea745
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,53 @@
+
+==========================================
+Tempest with plugins environment container
+==========================================
+
+
+Tempest with plugins environment container.
+Those container supposed to have any needed set of tempest tests
+for running on any custom cloud.
+
+Container statements:
+=====================
+
+ * Downstream tempest with set of downstream plugins
+ * Align to upstream openstack upper-constraints.txt
+ * No-auto-magic things, by default.
+ * All configs should be **connected** as volumes to container.
+ * All preconfigured things, like:
+ -create networks
+ -create tempest conf
+ -add\patch plugin
+ should be done in separate steps.
+ * Open entrypoint - any customization allowed and could be passed:
+ - via cmdline for docker run
+ - via SWITCH env variables + new func in entrypoint
+ * If needed, any custom scripts could be added, but should be disable by default.
+
+
+
+Example run:
+============
+
+Example for custom tempest run:
+
+.. caution::
+
+ **tempest_generated.conf** should be previously generated, along with all needed resources in cloud.
+
+ ``log_dir`` variable in conf, should be pointed to ``/temepest_reports`` - otherwise, you need to
+ change cmdline accordingly.
+
+
+
+.. code-block:: bash
+
+ mkdir -p /root/test_example/; cd /root/test_example/ ;
+ mkdir -p temepest_reports/ # create local folder, to save results
+ rm -rf temepest_reports/test1 # remove old results, ff was
+ docker run -v $(pwd)/tempest_generated.conf:/etc/tempest/tempest.conf -v $(pwd)/temepest_reports:/temepest_reports --rm -it 858b99100d04 /bin/bash -c "cd /temepest_reports; tempest init test1 ; cd test1; tempest run --debug -r heat_tempest_plugin.tests.api.test_heat_api.stacks_patch_update_stack.test_request
+
+
+
+