doc update

1 files changed, 56 insertions, 0 deletions

diff --git a/README_GCE.md b/README_GCE.md
new file mode 100644
index 000000000..343d3aedd
--- /dev/null
+++ b/README_GCE.md
@@ -0,0 +1,56 @@
+
+GCE Setup Instructions
+======================
+
+Get a gce service key
+---------------------
+1. ask your GCE project administrator for a GCE service key
+
+Note: If your GCE project does not show a Service Account under <Project>/APIs & auth/Credentials, you will need to use "Create new Client ID" to create a Service Account.
+
+
+Convert a GCE service key into a pem (for ansible)
+--------------------------------------------------
+1. The gce service key looks something like this: os302gce-ef83bd90f261.p12
+.. the ef83bd90f261 part is the public hash
+1. Be in the same directory as the p12 key file.
+1. The commands below should be copy / paste-able
+1. Run these commands:
+```
+   # Temporarily set hash variable
+   export GCE_KEY_HASH=ef83bd90f261
+
+   # Convert the service key (note: 'notasecret' is literally what we want here)
+   openssl pkcs12 -in os302gce-${GCE_KEY_HASH}.p12 -passin pass:notasecret -nodes -nocerts | openssl rsa -out os302gce-${GCE_KEY_HASH}.pem
+
+   # Move the converted service key to the .ssh dir
+   mv os302gce-${GCE_KEY_HASH}.pem ~/.ssh
+
+   # Set a sym link so it is easy to reference
+   ln -s ~/.ssh/os302gce-${GCE_KEY_HASH}.pem ~/.ssh/os302gce_priv_key.pem
+```
+
+1. Once this is done, put the original service key file (os302gce-ef83bd90f261.p12) somewhere safe, or delete it (your call, I don not know what else we will use it for, and we can always regen it if needed).
+
+
+
+Install Dependencies
+--------------------
+1. Ansible requires libcloud for gce operations:
+```
+  yum install -y ansible python-libcloud
+```
+
+
+Test The Setup
+--------------
+1. cd li-ops/cloud
+2. Try to list all instances:
+```
+  ./cloud.rb gce list
+```
+
+3. Try to create an instance:
+```
+  ./cloud.rb gce launch -n ${USER}-minion1 -e int --type os3-minion
+```