1 files changed, 80 insertions, 0 deletions

diff --git a/src/three-minute-demo/README.rst b/src/three-minute-demo/README.rst
new file mode 100644
index 0000000..1247ea1
--- /dev/null
+++ b/src/three-minute-demo/README.rst
@@ -0,0 +1,80 @@
+3 Minute Demo of OpenStack Public Clouds
+========================================
+
+This is all the Ansible needed for the 3 minute public cloud demo.
+
+It uses docker containers to avoid the need to install things on the local
+computer.  The Dockerfile uses the base ``python`` docker image regardless
+of other distro since it's just a container for installing ansible.
+
+.. note::
+
+  There is nothing docker-specific about the demo, it's just being used as
+  a convenient way to bundle actions without polluting the user's computer.
+  The playbooks themselves can be used directly for people who have the
+  pre-reqs of ansible, shade and diskimage-builder installed or who do not
+  mind installing them globally.
+
+Building Docker Image
+---------------------
+
+Step one is building the docker image:
+
+.. code-block:: bash
+
+  docker build -t three-minute-demo .
+
+A convenience script, ``build-docker-image.sh`` is provided that runs that
+command.
+
+Wrapper Script
+--------------
+
+Once the ``three-minute-demo`` image exists, the ``ansible-playbook.sh`` script
+will user it to run ``ansible-playbook``. By default it will run the
+``run.yaml`` playbook, but that can be overridden by passing parameters to the
+script.
+
+The ``ansible-playbook.sh`` script will also bind-mount the current directory
+as the main work dir and ``~/.config/openstack`` into ``/etc/openstack`` in the
+container so that ``clouds.yaml`` is available.
+
+.. note::
+
+  If ~/.config/openstack doesn't exist but /etc/openstack does,
+  ansible-playbook.sh will mount /etc/openstack instead. If a different setup
+  is desired, you can always run docker commands.
+
+Building and Uploading Images
+-----------------------------
+
+The demo depends on base images existing. The ``prep.yaml`` playbook will
+create the images and upload them to all of the cloud regions.
+
+.. code-block:: bash
+
+  ./ansible-playbook.sh prep.yaml
+
+By default it will create a minimal ubuntu image. That can be changed by
+setting ``distro`` on the ansible-playbook command line to something else, such
+as ``fedora`` or ``centos``.
+
+.. code-block:: bash
+
+  ./ansible-playbook.sh -edistro=fedora prep.yaml
+
+The Demo
+--------
+
+``ansible-playbook.sh`` defaults to running ``demo.yaml``, which will create a
+server in each cloud region, install Apache on that server, write out a json
+file for apache to serve, fetch the contents into a variable and print out the
+FQDN.
+
+If you're thinking "wow, that's not useful" - you're right! This isn't intended
+to be a demo of doing useful things with Ansible. It's intended to be a demo of
+getting servers on a set of cloud regions across multiple public clouds and
+then doing something with them.
+
+Once you can perform a single task on the remote server with Ansible, you can
+do anything with Ansible you want to do.