Convert all HTML doc to RST
The motivation for this conversion is to have DevStack's docs be
generated using a more familair workflow for OpenStack projects, using
Sphinx.
Changing from raw HTML to RST will also make it easier to contribute
more documentation, as well as making edits less of a hassle.
The majority of the work was done by using Pandoc to convert from HTML
to RST, with minor edits to the output to remove errors in Sphinx.
Change-Id: I9636017965aeade37b950ddf5bdb0c22ab9004bd
diff --git a/doc/source/eucarc.rst b/doc/source/eucarc.rst
new file mode 100644
index 0000000..c1065e6
--- /dev/null
+++ b/doc/source/eucarc.rst
@@ -0,0 +1,57 @@
+`DevStack </>`__
+
+- `Overview <overview.html>`__
+- `Changes <changes.html>`__
+- `FAQ <faq.html>`__
+- `git.openstack.org <https://git.openstack.org/cgit/openstack-dev/devstack>`__
+- `Gerrit <https://review.openstack.org/#/q/status:open+project:openstack-dev/devstack,n,z>`__
+
+eucarc EC2 settings
+-------------------
+
+``eucarc`` creates EC2 credentials for the current user as defined by
+``OS_TENANT_NAME:OS_USERNAME``. ``eucarc`` sources ``openrc`` at the
+beginning (which in turn sources ``stackrc`` and ``localrc``) in order
+to set credentials to create EC2 credentials in Keystone.
+
+EC2\_URL
+ Set the EC2 url for euca2ools. The endpoint is extracted from the
+ service catalog for ``OS_TENANT_NAME:OS_USERNAME``.
+
+ ::
+
+ EC2_URL=$(keystone catalog --service ec2 | awk '/ publicURL / { print $4 }')
+
+S3\_URL
+ Set the S3 endpoint for euca2ools. The endpoint is extracted from
+ the service catalog for ``OS_TENANT_NAME:OS_USERNAME``.
+
+ ::
+
+ export S3_URL=$(keystone catalog --service s3 | awk '/ publicURL / { print $4 }')
+
+EC2\_ACCESS\_KEY, EC2\_SECRET\_KEY
+ Create EC2 credentials for the current tenant:user in Keystone.
+
+ ::
+
+ CREDS=$(keystone ec2-credentials-create)
+ export EC2_ACCESS_KEY=$(echo "$CREDS" | awk '/ access / { print $4 }')
+ export EC2_SECRET_KEY=$(echo "$CREDS" | awk '/ secret / { print $4 }')
+
+Certificates for Bundling
+ Euca2ools requires certificate files to enable bundle uploading. The
+ exercise script ``exercises/bundle.sh`` demonstrated retrieving
+ certificates using the Nova CLI.
+
+ ::
+
+ EC2_PRIVATE_KEY=pk.pem
+ EC2_CERT=cert.pem
+ NOVA_CERT=cacert.pem
+ EUCALYPTUS_CERT=${NOVA_CERT}
+
+© Openstack Foundation 2011-2013 — An `OpenStack
+program <https://wiki.openstack.org/wiki/Programs>`__ created by
+`Rackspace Cloud
+Builders <http://www.rackspace.com/cloud/private_edition/>`__