summaryrefslogtreecommitdiff
path: root/acceptance/README.md
diff options
context:
space:
mode:
Diffstat (limited to 'acceptance/README.md')
-rw-r--r--acceptance/README.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/acceptance/README.md b/acceptance/README.md
new file mode 100644
index 0000000000..5f6bfc45ba
--- /dev/null
+++ b/acceptance/README.md
@@ -0,0 +1,30 @@
+# Acceptance Testing for Chef Client
+This folder contains acceptance tests that are required for Chef client
+release readiness.
+
+## Getting started
+The tests use the _chef-acceptance_ gem as the high level framework.
+All the gems needed to run these tests can be installed with Bundler.
+
+### Important Note!
+Before running chef-acceptance, you *MUST* do the following on your current session:
+
+```
+export APPBUNDLER_ALLOW_RVM=true
+```
+
+### Setting up and running a test suite
+To get started, do a bundle install from the acceptance directory:
+```shell
+chef/acceptance$ bundle install
+```
+
+To get some basic info and ensure chef-acceptance can be run, do:
+```shell
+chef/acceptance$ bundle exec chef-acceptance info
+```
+
+To run a particular test suite, do the following:
+```shell
+chef/acceptance$ bundle exec chef-acceptance test TEST_SUITE
+```