README.integration_specs in whiskey_disk-0.6.22 vs README.integration_specs in whiskey_disk-0.6.23
- old
+ new
@@ -1,36 +1,24 @@
-It is possible to run an integration spec suite which attempts to exercise the
-full whiskey_disk stack. I want this to be able to work on a single machine
-(especially since I like to work on whiskey_disk on airplanes and in foreign
-countries with questionable bandwidth/infrastructure). So, here's how I set my
-environment up to make this possible
+Running Integration Specs
+-------------------------
+To run the integration spec suite you need to be able to run a Vagrant virtual machine (see: http://vagrantup.com/), which means you will have to have VirtualBox installed. The Vagrant/VirtualBox setup is currently out of the scope of this document. By default, I have been using the lucid32 box as my "base" box.
- - need the following /etc/hosts entry:
- 127.0.0.1 localhost wd-git.example.com wd-app1.example.com wd-app2.example.com
+Once you are set up to be able to run Vagrant, you can create and start up an integration environment by running the following rake task:
- - enable sshd logins
-
- - create a local user named 'user', then:
-
- user% mkdir wd-integration-target
- user% chmod 777 wd-integration-target
- user% ln -s ~/wd-integration-target /tmp/wd-integration-target
-
- user% ssh-keygen (specify no passphrase)
- user% cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
- user% chmod 700 ~/.ssh/; chmod 600 ~/.ssh/authorized_keys
-
- user% ssh user@wd-app1.example.com (answer 'yes' to the trust host prompt)
- ^D
- user% ssh user@wd-app2.example.com ( ditto )
- ^D
+% rake integration:up
- then, as user, git clone whiskey_disk from github or ln -s to an already checked out version
- (which is what I usually do)
-
- - run git-daemon:
- user% cd git/whiskey_disk
- user% git daemon --base-path=`pwd`/scenarios/git_repositories/ --reuseaddr --verbose &
+This will create a vagrant VM, and so may take a few minutes to complete.
- user% export INTEGRATION=true
- user% rake
+
+To run the integration specs once the integration environment is up:
+
+ % export INTEGRATION=true
+ % rake
+
+To shut down the integration VM and the integration git-daemon server:
+
+ % rake integration:down
+
+To completely remove the integration spec VM (which can take up a good bit of space on disk), do:
+
+ % rake integration:destroy