Add docs for setting everything up.

CONTRIBUTING.rst

@@ -1,16 +1,79 @@
-If you would like to contribute to the development of OpenStack,
-you must follow the steps in this page:
+Crash course in lxd setup
+=========================
 
-   http://docs.openstack.org/infra/manual/developers.html
+nova-lxd absolutely requires lxd, though its installation and configuration
+is out of scope here. If you're running Ubuntu, here is the easy path
+to a running lxd.
 
-Once those steps have been completed, changes to OpenStack
-should be submitted for review via the Gerrit tool, following
-the workflow documented at:
+    add-apt-repository ppa:ubuntu-lxc/lxd-git-master && sudo apt-get update
+    apt-get -y install lxd
+    usermod -G lxd ${your_username|stack}
+    service lxd start
 
-   http://docs.openstack.org/infra/manual/developers.html#development-workflow
+If you're currently logged in as the user you just added to lxd, you'll
+need to log out and log back in again.
 
-Pull requests submitted through GitHub will be ignored.
+
+Using nova-lxd with devstack
+============================
+
+nova-lxd includes a plugin for use in devstack. If you'd like to run
+devstack with nova-lxd, you'll want to add the following to `local.conf`:
+
+    enable_plugin nova-lxd https://github.com/lxc/nova-lxd
+
+In this case, nova-lxd will run HEAD from master. You may want to point
+this at your own fork. A final argument to `enable_plugin` can be used
+to specify a git revision.
+
+Configuration and installation of devstack is beyond the scope
+of this document. Here's an example `local.conf` file that will
+run the very minimum you`ll need for devstack.
+
+    [[local|localrc]]
+    ADMIN_PASSWORD=password
+    DATABASE_PASSWORD=$ADMIN_PASSWORD
+    RABBIT_PASSWORD=$ADMIN_PASSWORD
+    SERVICE_PASSWORD=$ADMIN_PASSWORD
+    SERVICE_TOKEN=$ADMIN_PASSWORD
+
+    disable_service cinder c-sch c-api c-vol
+    disable_service n-net n-novnc
+    disable_service horizon
+    disable_service ironic ir-api ir-cond
+
+    enable_service q-svc q-agt q-dhcp q-13 q-meta
+
+    # Optional, to enable tempest configuration as part of devstack
+    enable_service tempest
+
+    enable_plugin nova-lxd https://github.com/lxc/nova-lxd
+
+    # More often than not, stack.sh explodes trying to configure IPv6 support,
+    # so let's just disable it for now.
+    IP_VERSION=4
+
+Once devstack is running, you'll want to add the lxd image to glance. You can
+do this (as an admin) with:
+
+    wget http://cloud-images.ubuntu.com/trusty/current/trusty-server-cloudimg-amd64-root.tar.xz
+    glance image-create --name lxd --container-format bare --disk-format raw --visibility=public < trusty-server-cloudimg-amd64-root.tar.xz
+
+To run the tempest tests, you can use:
+
+    /opt/stack/tempest/run_tempest.sh -N tempest.api.compute
+
+
+Errata
+======
+
+Pull requests should be submitted through GitHub.
 
 Bugs should be filed on GitHub:
 
    https://github.com/lxc/nova-lxd
+
+If you would like to contribute to the development of OpenStack,
+you must follow the steps in this page:
+
+   http://docs.openstack.org/infra/manual/developers.html