ubuntu-server-ec2-testing-dev team mailing list archive

[Scott Moser <smoser@xxxxxxxxxxxxx>]

Scott Moser has proposed merging lp:~smoser/ubuntu-server-ec2-testing/doc-updates into lp:ubuntu-server-ec2-testing.

Requested reviews:
  Ubuntu Server ec2 Testing Developers (ubuntu-server-ec2-testing-dev)

For more details, see:
https://code.launchpad.net/~smoser/ubuntu-server-ec2-testing/doc-updates/+merge/79304
-- 
https://code.launchpad.net/~smoser/ubuntu-server-ec2-testing/doc-updates/+merge/79304
Your team Ubuntu Server ec2 Testing Developers is requested to review the proposed merge of lp:~smoser/ubuntu-server-ec2-testing/doc-updates into lp:ubuntu-server-ec2-testing.

=== modified file 'docs/README.txt'
--- docs/README.txt	2011-02-28 16:47:12 +0000
+++ docs/README.txt	2011-10-13 15:57:27 +0000
@@ -4,7 +4,45 @@
 This project provides a framework for the automated testing of Ubuntu Server 
 ec2 Images.
 
-ec2 credentials are stored in a yaml configuration file default location is 
-~/.ec2.yaml.
-
-See example ec2.yaml located in /usr/share/doc/ubuntu-server-ec2-testing
+==== Setup ====
+ * configure ~/.ec2.yaml
+   ec2 credentials are stored in a yaml configuration file default location is 
+   ~/.ec2.yaml.  
+   See example in /usr/share/doc/ubuntu-server-ec2-testing/ec2.yaml .
+
+   $ cp /usr/share/doc/ubuntu-server-ec2-testing/ec2.yaml ~/.ec2.yaml
+   $ chmod 600 ~/.ec2.yaml
+   $ vi ~/.ec2.yaml # and edit with your credentials
+
+ * check out the ec2-automated-tests branch
+   $ testbranch="lp:~ubuntu-server-ec2-testing-dev/+junk/ec2-automated-tests"
+   $ bzr branch "$testbranch" ec2-automated-tests
+
+ * set up PATH
+   PATH=$PATH:/usr/share/ubuntu-server-ec2-testing/python
+
+==== Run Test ====
+execute_ubuntu_ec2_test.py expects to take a 'test name', which is
+described in ec2-automated-tests/global/tests.yaml.
+
+In each of the examples below, we pass '--tests=', but that will default
+to ~/tests/.
+
+Also note, you can invoke with '--debug' to increase debugging output.
+
+After running the tests as shown below, output will be written to a directory
+under the current directory named 'None'.  This represents the availability
+zone that was specified in global/tests.yaml ('any').
+
+ * Run a test
+   $ execute_ubuntu_ec2_test.py --tests=./ec2-automated-tests simple-user-data
+
+ * Run a test specifying arch, region, release
+   $ execute_ubuntu_ec2_test.py simple-user-data
+       --tests=./ec2-automated-tests \
+       --release=oneiric --storage=ebs --region=us-east-1 --arch=amd64
+        
+ * Run with t1.micro size for testing.
+   If you want to change the size of 'default', then you will have to edit
+   ec2-automated-tests/global/archs.yaml .  Simply replace the value for
+   'default' with 't1.micro' for the given arch.