summaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorPavel Raiskup <praiskup@redhat.com>2014-10-03 13:53:22 +0200
committerPavel Raiskup <praiskup@redhat.com>2014-10-03 14:24:26 +0200
commitdd52a3df190ad677e23654dbba8bf553565a159b (patch)
tree50dc25d35110c45c05bbab6ec319dd4a92836a33 /README
parent37c8dc6c89714e553bb5ce32a83910a1407d7067 (diff)
downloadpostgresql-setup-tests-dd52a3df190ad677e23654dbba8bf553565a159b.tar.gz
postgresql-setup-tests-dd52a3df190ad677e23654dbba8bf553565a159b.tar.xz
postgresql-setup-tests-dd52a3df190ad677e23654dbba8bf553565a159b.zip
ansible: incorporate os1 triggers
* ansible/dummy-wrapper.yml: Helper playbook to directly invoke "included" playbooks. * ansible/fedora.yml: The "main" playbook (new file). * ansible/include/beakerlib.yml: New file, install beakerlib remotely. * ansible/include/prepare-testenv.yml: Install the test dependencies remotely. * ansible/run_include: Helper script to run included playbooks. * dist: Do not distribute ansible playbooks in tarball. * get_machine: Helper script to obtain openstack machine, not used currently. * lib_pgsql.sh: Assert for PG_VERSION, not for datadir (as it by default exists after postgresql-server installation. * run_remote: Helper script invoking the main ansible playbook. * ansible_helpers/wait-for-ssh: Helper script as 'wait_for' is broken? * README: Document. * .gitignore: Ignore private files.
Diffstat (limited to 'README')
-rw-r--r--README30
1 files changed, 26 insertions, 4 deletions
diff --git a/README b/README
index 68b53a9..803aa71 100644
--- a/README
+++ b/README
@@ -14,12 +14,28 @@ Each file should consist of config.sh and runtest.sh. Both are supposed to be
"sourced" into another scripts (so no need to have execute permissions). Each
test case should have its own directory.
-USAGE
-=====
+USAGE (locally)
+===============
The most simple usage is like `./run`. Script is able to search for available
-test-cases and then run them. For more info, run `./run --help`. TODO: The
-testsuite is root-only.
+test-cases and then run them on local machine. Note that this is not generaly
+safe and you should avoid that in most cases. For more info, run
+`./run --help`. TODO: The testsuite is root-only.
+
+REMOTE RUN
+==========
+
+You need to have OpenStack credentials file in ./private/ostack.yml configured.
+The file should look like (be sure that only you can read that file):
+ $ cat ./private/ostack.yml:
+ ---
+ os_username: os1username
+ os_tenant_id: 9df30fc192f5xxxxxxxxxxxxxxxx0110
+ os_nova_password: your_os_password
+
+Then it should be enough to run:
+
+ $ ./run_remote
API for config.sh file
======================
@@ -30,3 +46,9 @@ $DTF_TEST_ID - unique ID of task. Without spaces.
$DTF_TEST_DESCRIPTION - descriptive info about test, will be used for
generating html or otherwise formated result output.
+
+REQUIREMENTS
+============
+
+Packages needed to successful run
+ * ansible (remote running)